v1

latestOpenAPI 3.0.02026-07-242035712.0 MB
Account

Update Account Balance

This API enables the user to update account balances. The API call accepts either a Token or an Account ID. If a Token is provided, the associated account will be updated. It is recommended to use the Account ID (Input type "a") as best practice.This API is primarily designed for Stand-In Processing (STIP) and is not intended for updating balances in day-to-day financial activities when the ledger is managed by Paymentology. It allows for bulk updating of account balances in an array format. Using this API disrupts the transaction narrative on the account, making it unsuitable for reconciliation purposes. However, it can be useful for testing scenarios that require specific amounts to analyze transaction scenarios.

post/pws/pws_update_balance/

Request body

api_call_unique_identifierstring required

Unique number that must be passed at each API request. Identifier to make each API request unique

client_idinteger required

Unique identifier for the client which Paymentology will provide at outset

user_idstring

User Id of the Customer who triggered the API request.

remarksstring

Remarks for API request

Example request

{
  "api_call_unique_identifier": "438574845790657485",
  "balance_list": [
    {
      "act_balance": 1007.1,
      "bill_ccy": "826",
      "blk_balance": -79.1,
      "input_id": 4798239197,
      "input_type": "a"
    }
  ],
  "client_id": 760131
}

Response

Successful Response

Example response

{
  "header": {
    "error_desc": "success"
  },
  "body": {
    "total_count": 20,
    "total_success": 19,
    "total_failed": 1,
    "failed_note": "66961569677:Invalid account id;"
  }
}