Simple API allowing consumers to register and process HPP transactions.

/usr/oauth/v2/token?client_id={client_id}&client_secret={secret}&grant_type=password&username={user}&password={password}

  • Parameters

    • client_id:
      8_3gyhb7l37go4kk0wg0gkkokkc4scskw080oggk0o0wkkggg4c8
      (string, required) - Client ID.
    • secret:
      61qzyfdv42skw0kw444g0wsc084s08sw40o4408w84gkc4kssc
      (string, required) - Client Secret.
    • user:
      merchant@sandbox.oroundapsp.com
      (string, required) - User login in the system.
    • password: `` (string, required) - User password in the system.
  • Response 200 (application/json)

      {
          "access_token": "accessToken",
          "expires_in": "3600",
          "token_type": "bearer",
          "scope": "user app",
          "refresh_token": "token"
      }
    

/bill/api/v1/self-registered-transactions

  • Headers

      Accept: application/json
      Authorization: Bearer {accessToken}
      Content-Type: application/json
    
  • Request (application/json)

      {
          "amount": 1000,
          "currency": "USD"
          "destinationWalletId": 640,
          "vendor": "CCX1",
          "metadata": {
              "cardHolder" : "John Doe"
          }
      }
    

Amount - a positive integer in the smallest currency unit (100 to charge $1.00)

  • Response 200 (application/json)

      {
          "transactionUuid" : "140ac2b1-586f-4e12-85a4-18ae305c6b50",
          "redirectHash" : "3d89e76e1008eb1cdf82d4d2042d760f"
          "redirectUrl" : {redirectUrl}
      }
    

Then you need to redirect user to HPP https://sandbox.oroundapsp.com/{redirectUrl}

/bill/api/v1/status-transactions?uuid={transactionUuid}

  • Parameters

    • transactionUuid:
      140ac2b1-586f-4e12-85a4-18ae305c6b50
      (string, required) - TransactionUuid.
  • Headers

      Accept: application/json
      Authorization: Bearer {accessToken}
      Content-Type: application/json
    
  • Response 200 (application/json)

      {
          "completed": false,
          "success": false,
          "status": {internalStatusNumber},
          "statusText": {internalStatusText},
      }
    

200 - Ok 403 - Operation/resource is not permited 404 - Route or resource not found 406 - Processing is declined by business logic (incorrect amounts) 415 - Content-type is not sent or wrong 422 - Missing required data 500 - Other execeptional cases