This API will be used to do intra wallet fund transfer.
Environment: https://domain/api/onboarding/v2/transferFunds
HTTP Method: GET
Request parameters
<WalletHeader />
Body
Parameter | Description | Example |
---|---|---|
Encrypted | ||
token |
| Pl8F5kDZcvADIiursiA |
Decrypted | ||
messageCode |
| 1080 |
clientTxnId |
| GOUd789hhhjfscs |
requestDateTime |
| |
Senders.urn | A unique reference number for the card(urn) | 70000000008 |
Senders.customerId |
| 11001188721 |
Senders.accountNumber |
| "20006bbbaa78” |
Senders. transactionAmount |
| 10000 |
Sender.accountNumberCurrency |
| 356 |
Senders. sourceAccountType |
| 12 |
Senders. sourceAccount |
| 123456789 |
receivers. urn |
| 70000000008 |
receivers. customerId |
| 89342546 |
receivers. accountNumber |
| “20006bbbaa78_1” |
receivers. transactionAmount | Numeric
Character Limit - 12` | |
reserved1 |
| O|70010 |
reserved2 |
| PG Debit |
reserved3 |
| Monthly settlement |
reserved4 |
| I|70010 |
reserved5 |
| PG Credit |
reserved6 |
| Monthly settlement |
Sample request
Request packet (Encrypted)
{
"token":"Pl8F5kDZcvADIiursiAvvbHNuL9Wv5eaFdorGVFU6FKfIEnV/YskkzJlAov2ZHJWnqGNLOXfBq4SQqw8Ep4sK0gCAAkRXATCb1nSY6s="
}
Request packet (Decrypted)
{
"messageCode": "1680",
"clientTxnId": "FunDTrJMphIBit011111111018111101112177111111111295",
"requestDateTime": "20220717101432",
"senders": [
{
"urn": 414934,
" accountNumber ": "10008dd1c78_13",
"transactionAmount": "1500",
"sourceAccountType": 1,
"sourceAccount": "1234",
"reserved1": "O|10009",
"reserved2": "PG Load",
"reserved3": "201607040918K4"
}
],
"receivers": [
{
"urn": 414935,
"customerId": "payu49",
"accountNumber": "10008dd1c78_12",
"transactionAmount": "1500",
"reserved4": "I|10009", ]
"reserved5": "PG Load",
"reserved6": "2016aasd07040918"
}
]
}
Response parameters
Parameter | Description | Example |
---|---|---|
Encrypted | ||
token | Token is the Encrypted body of the below request AES-192-CBC bits Encryption | Pl8F5kDZcvADIiursiAvvbHNuL9Wv5eaFdorGVFU6FKfIEnV/ |
Decrypted | ||
messageCode | Code to Identity create card response type | 1011 |
clientTxnId | Value copied from the request | 20150701235959xhstiesqfds |
responseDateTime | Response date time in the format YYYYMMDDHHMMSS with time in 24 hr format | 20161031214559 |
clientId | Uniquely ID for the client . | 9712938648 |
responseCode | Contains the status of the transaction. 201 indicates CREATED. Please refer Appendix for other response codes | 201 |
responseMessage | Response message based on response code will be sent | Card creation successful |
bankId | Bank ID is provided by platform to identify issuer/PPI of the program. | 7020 |
urn | A unique reference number for the generated card. | 70000000008 |
customerId | Unique value passed in the request will be echoed else unique value generated by the platform if not passed in the request | 89342546 |
accosaTransactionId | Unique id for a particular transaction generated in Prepaid | 3591893 |
API error codes
Error Code | Description |
---|---|
00 | SUCCESS |
1055 | MALFORMED_REQUEST |
1085 | PRODUCT NOT ALLOWED |
1052 | SYSTEM_ERROR |
1032 | INVALID_CLIENT_CHANNEL |
1081 | OPERATION NOT ALLOWED |
1080 | IP_NOT_ALLOWED |
1049 | INVALID SECURE CODE |
1051 | CHECKSUM FAILURE |
1093 | INVALID CLIENT TXN ID |
1320 | REQUEST_DATETIME_IS_MANDATORY |
1031 | INVALID BANK ID |
1264 | BANK ID NOT PRESENT |
1262 | CLIENT ID NOT PRESENT |
1310 | XCONSUMERKEY NOT PRESENT |
1030 | INVALID MESSAGE |
1311 | SECURE CODE NOT PRESENT |
1088 | INVALID DATE FORMAT |
Sample response
Packet sample (Encrypted)
{
“token”:"Pl8F5kDZcvADIiursiAvvbHNuL9Wv5eaFdorGVFU6FKfIEnV/YskkzJlAov2ZHJWnqGNLOXfBq4SQqw8Ep4sK0gCAAkRXATCb1nSY6s="
}
Packet sample (Decrypted)
Failure scenario
{
"urn": 414934,
"customerId": "payu47",
"responseCode": "1501",
"messageCode": 1681,
"clientTxnId": "FunDTrJMphIBit011111018111101112177111111111295",
"clientId": 2000,
"responseDateTime": "20230913143701",
"accosaTransactionId": 2623908,
"responseMessage": "SYSTEM ERROR",
"bankId": 1234
}