patch https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/loadAccount
The Load Wallet API is called by the client to create a credit transaction entry into the wallet. The Load API can be called during multiple use cases like as follows:
- When the customer loads the wallet by any payment gateway.
- When the client wants to load the customer’s wallet (E.g. load monthly allowance, give refunds, or cashback).
- When a customer receives money from peers.
Environment
| Sandbox | https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/loadAccount |
| Production | Contact your WIBMO KAM or support. |
Sample request
curl --request PATCH \
--url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/loadAccount \
--header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
--header 'accept: application/json' \
--header 'bankId: 6060' \
--header 'clientId: 1060' \
--header 'content-type: application/json' \
--header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
--header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
--data '
{
"token": "{ \"token\": \"2cXWgW9s/hkJRCOYCCDt0zUnbTcwYMQ6K36S1hHjpArH1OiotY8HxQ/1Kq36yM7eXdh1mRr+lux1B7lMUJfMkELJvNEPLz5V65av70LHyKKrtRpYcKAyWQIKTYcwD+kbVLTtFqrOf71w6prlo+zuHwKdwjM7oxpD1x7hd3U6BYyqHlX9ZJ2WoF8DLHe52vorqreQtpybM1bHg0MssRBkQ+7+7tFcOizWV3e2MvLb/DKqcvojwNkzmBqPT06YKb8859fHpJUCt/Cz0AYDYwfb2QoUgnFSJwkjZBloBAhNeoJSR0CRiobwx/cvVSnTCc/fkouHp6HK+yRgFOQSV9gS84IkAsezvvPuihpr1eqRutJD9jOyH03XcxpejOBg66sIx8DfqrtIiH01VP3N9HBxVrE9vl6ui9944+KzP7kenqlaUfcGRUiyTovGTbQm67CDcRFwRFCKiixFj936mB3kJrywzYbwmDeVO4yudCYFBWnf/qTtbhzAWaRBTwHBb1pvqMv93K1CWk84ZXoJot03c8P1SeBxCOYRbj27FJNQ30dKvjkqUmQh3O6nM5eX76yJ\" }"
}
'
Response parameters (Decrypted)
This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:
| Parameter | Type | Parameter Requirement | Description |
|---|---|---|---|
| messageCode | Numeric(4) | Mandatory | API Unique IDentifier. |
| clientTxnId | String(100) | Mandatory | Value echoed from the request |
| urn | Numeric(11) | Mandatory | Unique reference number for the customer |
| accosaRefNo | Numeric(20) | Mandatory | Auto-generated sequence number. |
| accosaTransactionId | Numeric(10) | Mandatory | Unique ID for a particular transaction generated in Prepaid. |
| accountNumber | String(15) | Conditional | Refers to a sub-wallet for a user. Only if it is a multiwallet program. |
Sample response
{
"token": "OqRmaGnmmSdLzBpZio4NJ/k1/hVZYCt5MPUgHkkvyUyME0hNZ7HzVP6FtUeUPFLOFtEaquTsO/Fo2exrvVmlTwolCp81TD0IOu0XOdpwPL+AIYa0RiGCFING9qypud07/vLyLmoOaXUeIP6Y9M9Tobgg/MxnMBct0kLdD9GvWUzTfFsztwrLfpwMwSj5NIqCiN4TrfGRBtjdzcC3g6UOWQ=="
}
Error codes
| Error Code | Description |
|---|---|
| 00 | SUCCESS |
| 1009 | CARD_CANCELLED_CLOSED_EXPIRED |
| 1010 | CARD_TEMPORARY_BLOCK |
| 1012 | CARD_PENDING_CANCELLATION |
| 1013 | AML MIN LIMIT |
| 1030 | INVALID_MESSAGE |
| 1045 | UNABLE_TO_PROCESS_REQUEST |
| 1054 | DUPLICATE REQUEST |
| 1056 | INVALID MESSAGE CODE |
| 1058 | INVALID_WALLETS |
| 1088 | INVALID REQUEST DATE format |
| 1093 | INVALID CLIENT TXN ID |
| 1101 | UNKNOWN_SOURCE_ACCOUNT_TYPE |
| 1121 | CARD_CREDIT_DEBIT_BLOCK |
| 1135 | REFUND_AMOUNT_GREATER_THAN_ORIGINAL_TXN_AMOUNT |
| 1138 | CURRENCY NOT MATCHING WITH CARD CURRENCY |
| 1246 | ORIGINAL_TXN_NOT_EXIST |
| 1247 | SOURCE_ACC_TYPE_NOT_MACHED_WITH_IMPL |
| 1303 | CUSTOMER DETAILS NOT PRESENT |
| 1304 | MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED |
| 1322 | TRANSACTION AMOUNT CANNOT BE ZERO |
| 1325 | FUND FLOW TYPE MISMATCH |
| 1326 | IMPL ID MISMATCH |
| 1357 | WALLET DETAILS NOT FOUND |
| 1088 | INVALID REQUEST DATE format |
| 1055 | MALFORMED REQUEST |
| 1353 | COOLING OFF PERIOD BETWEEN TWO LOADS NOT COMPLETED |
| 1354 | CORPORATE_LEVEL_LIMIT_EXCEEDED |
| 1357 | WALLET DETAILS NOT FOUND |
| 1359 | INVALID LOAD AMOUNT |
| 1366 | PROGRAM IS INACTIVE |
| 1367 | PROGRAM NOT FOUND |
| 1368 | WALLET OR ACCOUNTNO SHOULD BE PRESENT |
| 1398 | ACCOUNTNO SHOULD BE PRESENT |
| 1501 | SYSTEM_ERROR_DB |
| 1504 | SYSTEM_CACHE_FAILURE |
| 6000 | ACCOUNT DORMANT |
| 6002 | ACCOUNT PERMANENTLY BLOCKED OR CLOSED |
| 6014 | ACCOUNT IN TEMPORARILY BLOCKED STATE |
| 6016 | ACCOUNT IN CREDIT BLOCKED STATE |
| 6017 | ACCOUNT ALREADY IN CREDIT_DEBIT BLOCKED STATE |
| 10153 | AMOUNT IS NOT WITHIN MIN-MAX RANGE |
| 10163 | PROGRAM DAILY LIMIT EXCEEDED |
| 1392 | FUND FLOW TYPE NOT PRESENT IN THE REQUEST |
| 6909 | SENDER CUSTOMER NOT FOUND |
| 10044 | SENDER INFO INVALID LENGTH |
| 1319 | SOURCE_ACCOUNT_INVALID_LENGTH |
| 1103 | INVALID_TRANSACTION_AMOUNT |
| 6911 | Invalid reserved field 1 |
| 6912 | Invalid reserved field 2 |
| 6913 | Invalid reserved field 3 |
| 1298 | INVALID_SOURCE_ACCOUNT_TYPE |
| 1322 | Transaction amount cannot be zero |
| 10012 | IMPLID NOT PRESENT |
| 10013 | IMPLTYPE NOT PRESENT |
| 6933 | INVALID SOURCE TYPE |
| 84114 | Invalid data type for field TransactionAmount |
| 9343 | CLIENT TXN ID IS MANDATORY |
| 303178 | Request DateTime Length should not be more than 14 characters |
| 1361 | INVALID ACCOUNT NUMBER |
| 6935 | SOURCE TYPE SHOULD BE 0 OR 1 |