Load money using API
Load money to user wallet account.
User can load amount in his wallet
account through credit, debit card, netbanking etc.
How to load money to wallet?
The POST request will be send over HTTPS to the
endpoint.
Sample Request
Sample Response
NOTE:
- verificationHash – SHA256Algorithm.generateSHA256Hash(secKey.trim()+customerId.trim()+amount.trim()+walletOwner.trim()+currency.trim()+transcationId.trim())
How to generate verification hash?
Verification Hash has to be calculated with following combination using SHA256
algorithm and need to be send along with the authentication parameters in each server-to-server
request:
<secKey><customerId><amount><walletOwner><currency><transcationId>
Sample Code
Request Parameters
This reference lists all the standard flow parameters to be send in request.
Parameter | Description | Format | Required |
---|---|---|---|
merchantTransactionId | This reference number is provided by the merchant, should be unique for the transactions and is visible on the end customer’s statement. | .\\p[0-9a-zA-Z\\p{Space}\\-{0,1024} | Yes |
amount | Amount of the transaction. | N50 [0-9] {1,50} |
Yes |
currency | User's currency | A3 [0-9]{3} |
Yes |
descriptor | Same value as merchantTransactionId | .\\p[0-9a-zA-Z\\p{Space}\\-{0,1024} | Yes |
customerEmail | User's email id. | AN255 [a-zA-Z0-9] {1,255} |
Yes |
customerFirstName | User's first name. | A255 | Yes |
customerLastName | User's last name. | A255 | Yes |
cardNumber | User's Card number. | N19 ((4[0-9]{12}([0-9]{3}))|(5[1-5][0-9]{14})) |
Yes |
cardExpiryMonth | Expiry month of the card. | N2 ([0-9])|(0[0-9])|(1[0-2]) |
Yes |
cardExpiryYear | Expiry year of the card. | N4 ((200[0-9])|(201[0-9])|(202[0-9])) |
Yes |
cardCvv | 3 or 4 digits number on card to verify card details.. | N4 [0-9]{3,4} |
Yes |
customerId | Generated unique customer id on per user sign up. | N [0-9] |
Yes |
customerContact | User's mobile number (with country code eg.91). | N [0-9] |
Yes |
walletOwnerId | Provided by Unique id. | N20 [0-9] |
Yes |
transactionType | Pass transaction type as LOAD/PURCHASE. | A255 | Yes |
customerName | User's name. | A255 | Yes |
country | Country of the user's | A255 [A-Za-z] |
Yes |
city | City of the user's | AN50 [a-zA-Z0-9\\\\#&\\p{Space}\\p{L}\\p{M}\\-;.,~`/%$#@ ]{0,1000} |
Yes |
state | State or region of the user's | AN50 [\\ra-zA-Z0-9\\\\!@#$*%^&{}\\[\\]()_+\\p{L}\\p{M}\\-=,.~'` ]{0,1000} |
Yes |
postcode | Postal code/ Zip code of the customer's shipping address. | AN10 [A-Za-z0-9]{1,10} |
Yes |
street1 | Building name, and/ or street name of the customer's shipping address. | AN1000 [a-zA-Z0-9\\p{Space}\\,]+ |
Yes |
verificationHash | Verification Hash has collected combination of parameters. | String | Yes |
Response Parameters
This reference list lists all the standard flow parameters to be received in response.
Parameter | Description | Format | Required |
---|---|---|---|
responseCode | Response code | [a-zA-Z0-9] | Yes |
amount | Amount of the transaction.. | N [0-9] |
Yes |
Response Code | Message |
---|---|
8 | Transaction Success |
9 | Transaction Declined |
10 | Transaction Failed |
3 | Invalid Request |