Fund Transfer API

This API will be used to do intra wallet fund transfer.

Environment: https://domain/api/onboarding/v2/transferFunds

HTTP Method: GET

Request parameters

Header

Parameter	Description	Example
x-api-key mandatory	`String` This is a unique key.	7fe1c0de
clientId mandatory	`String` Uniquely identifies the client. During program enrolment each client is provided with a unique client id by Prepaid	2000
bankId mandatory	`Numeric` Bank Id is provided by Prepaid Aero during program enrolment to uniquely identify the card issuer.	7000
entityId mandatory	`Numeric` Defaults to parent branch i.e., 100	100
secureCode mandatory	`String` Uniquely identifies the client on payload level for performing operations.	AfYtlO5kqdySIjXyNmGg3F

Body

Parameter	Description	Example
Encrypted
token mandatory	`String` Token is the Encrypted body of the below request AES-192-CBC bits Encryption	Pl8F5kDZcvADIiursiA vvbHNuL9Wv5eaFdorGV FU6FKfIEnV/YskkzJlA ov2ZHJWnqGNLOXfBq4S Qqw8Ep4sK0gCAAkRXAT Cb1nSY6s=
Decrypted
messageCode mandatory	`Numeric` Code to Identify load card request type. `Character Limit - 4`	1080
clientTxnId mandatory	`String` Unique ID generated by the client for each transaction. `Character Limit - 14`	GOUd789hhhjfscs
requestDateTime mandatory	`Numeric` Local Date and time stamp when the transaction originated from the client in YYYYMMDDHHMMSS with time in 24 hr format. `Character Limit - 4`
Senders.urn conditional	A unique reference number for the card(urn)	70000000008
Senders.customerId optional	`String` Customer Id (entityCIF), which uniquely identifies the cardholder in the client system. It is conditional with mobile number and URN, i.e., either one of them should be present. `Character Limit - 20`	11001188721
Senders.accountNumber optional	`String`ID of the sender wallet `Character Limit - 15`	"20006bbbaa78”
Senders. transactionAmount mandatory	`Numeric`Transaction amount for which card/wallet to been debit. It is in implied decimals based on the currency. For ex. INR 5.25 is 000000000525 in implied decimal format. `Character Limit - 12`	10000
Sender.accountNumberCurrency optional	`Numeric`Currency according to ISO-4217. `Character Limit - 3`	356
Senders. sourceAccountType optional	`Numeric`This will be handle from beneficiary part. `Character Limit - 2`	12
Senders. sourceAccount optional	`String`Source account is the account from which funding is happening. `Character Limit - 30`	123456789
receivers. urn mandatory	`Numeric`A unique reference number for the generated card. `Character Limit - 11`	70000000008
receivers. customerId   optional	`String`A customer id from client system to be shared. `Character Limit - 20`	89342546
receivers. accountNumber mandatory	`String`ID of the receivers wallet. `Character Limit - 30`	“20006bbbaa78_1”
receivers. transactionAmount mandatory	Numeric`Transaction amount for which card/wallet to been debit. It is in implied decimals based on the currency. For ex. INR 5.25 is 000000000525 in implied decimal format.` Character Limit - 12`
reserved1 optional	`String`Impl Id to identify what kind of Fund transfer `Character Limit - 500`	O\|70010
reserved2 optional	`String`Impl Id to identify what kind of Fund transfer `Character Limit - 500\`	PG Debit
reserved3 optional	`String`Impl Id to identify what kind of Fund transfer `Character Limit - 500`	Monthly settlement
reserved4 optional	`String` Impl Id to identify what kind of Fund transfer `Character Limit - 500`	I\|70010
reserved5 optional	`String` Impl Code to identify what kind of Fund transfer`Character Limit - 500`	PG Credit
reserved6 optional	`String` Reason for fund transfer `Character Limit - 500`	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/ YskkzJlAov2ZHJWnqGNLOXfBq4SQqw8Ep4sK0gCAAkRXATCb 1nSY6s=
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 
}