REST API Specifications
Introduction
We created a complete and detailed description of the Platform API. Here you can find all parameter descriptions.
Hosts
- Test:
- Live:
Request Parameters
This reference lists all the standard flow parameters to be send in request.
| Parameter | Description | Format | Required |
|---|---|---|---|
| walletOwnerId | Provided by Unique id. | N20
[0-9] |
Yes |
| token | Provided by Unique token. | String | Yes |
| country_code | User country code eg: 91. | A3
[0-9] |
Yes |
| cust_contact | User contact number. | N10
[0-9]{10} |
Yes |
| cust_email | User email id. | AN255
[a-zA-Z0-9] {255} |
Yes |
| cust_password | Set user password. | AN8
[A-Za-z0-9] {1,8} |
Yes |
| account_type | Sign up as Customer/Merchant. | A255
[a-zA-z] {255} |
Yes |
| secKey | Generated secret key for per user. | String | Yes |
| deviceId | User's Mobile device id. | String | Yes |
| platformId | App platform Id Android-1 and iOS-2. | AN2048
[0-9] |
Yes
|
| custCurrency | Set currency for user. | AN2048
[0-9] |
Yes
|
| custFirstName | Set user's first name. | A | Yes
|
| custLastName | Set user's last name. | A | Yes
|
| custDOB | Set user's date of birth. | N
[0-9] |
Yes
|
| custCountry | Set user's country. | A
[0-9] |
Yes
|
| isTosOfTWAccepted | Terms and conditions accepted (true or false). | A255 | Yes
|
| termsConsent | Terms of consents. | A255 | Yes
|
| cust_id | Generated unique customer id on per user sign up. | A255 | Yes
|
| verificationHash | Verification Hash has collected combination of parameters. | String | Yes
|
| amount | Amount of the transaction.. | N [0-9] |
Yes
|
| toMobile | Receiver's mobile number (with country code eg.91) | N [0-9] |
Yes
|
| fromCurrency | Sender's currency | N [0-9] |
Yes
|
| from_cust_id | Sender's customer_id | N [0-9] |
Yes
|
| fromMobile | Sender's mobile number (with country code eg.91) | N [0-9] |
Yes
|
| from_cust_name | Sender's name | A255 | Yes
|
| comment | Description of the transaction | AN [0-9] |
Conditional
|
| fromCurrencyCode | Sender's currency | AN [0-9] |
Yes
|
| isMoneyFromRequest | Amount sent from pending list (set true) or directly from send money (set false) | A255 | Yes
|
| requestId | Amount sent from pending list pass request Id or pass 0 | N [0-9] |
Yes
|
| vendorName | Amount sent to merchant (Merchant name) | A255 | Yes
|
| vendorUserId | Amount sent to merchant (Merchant user id) | AN255 [a-zA-Z0-9] {255} |
Yes
|
| vendorUserPassword | Amount sent to merchant (Merchant password) | AN255 [a-zA-Z0-9] {255} |
Yes
|
| requestAmount | Request amount to recipient | N [0-9] |
Yes
|
| requestComment | Description of the requested amount | AN255 [a-zA-Z0-9] {255} |
Yes
|
| fromCustid | Sender's customer_id | AN255 [0-9] |
Yes
|
| fromCustomerName | Sender's name | AN255 [a-zA-Z0-9] {255} |
Yes
|
| lastActivityId | Activity List last id (If no id keep 0) | N [0-9] |
Yes
|
| lastTransactionId | Transaction List last id (If no id keep 0) | N [0-9] |
Yes
|
| custId | Generated unique customer id on per user sign up | N [0-9] |
Yes
|
| custEmail | User's email id | AN [a-zA-Z0-9] |
Yes
|
| custEmail | User's email id | AN [a-zA-Z0-9] |
Yes
|
| custName | User's name | A255 | Yes
|
| custMobile | User's mobile number (with country code eg.91) | N [0-9] |
Yes
|
| currency | User's currency | A3 [0-9]{3} |
Yes
|
| paymentMode | Payment method for paying amount. For ex: CC for Credit Cards | AN32 [a-zA-Z0-9] {1,32} |
Yes
|
| paymentBrand | Type of Card while placing the transaction.For ex: VISA, MC | AN32 [a-zA-Z0-9] {1,32} |
Yes
|
| 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
|
| descriptor | Description of the transaction. | AN255 | Yes
|
| customerEmail | User's email id. | AN255 [a-zA-Z0-9] {1,255} |
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
|
| customerContact | User's mobile number (with country code eg.91). | N [0-9] |
Yes
|
| transactionType | Pass transaction type as LOAD/PURCHASE. | A255 | Yes
|
| customerName | User's name. | A255 | Yes
|
| mobilePlatform | Mobile device platform android/iOS. | A255 | 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
|
| 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
|
| loyaltyPoints | Points to redeem. | N [0-9] |
Yes
|
| User's email address. | AN255 [a-zA-Z0-9] |
Yes
|
|
| title | User's gender suffix (Mr or Mrs). | A255 [a-zA-Z] |
Yes
|
| zip | Postal code/ Zip code of the customer's shipping address. | AN10 [A-Za-z0-9]{1,10} |
Yes
|
| ssn | Social security number (US citizens). | N9 [0-9{9}] |
Yes
|
| idProofType | ID Proof type number (provided table). | N9 [0-9{9}] |
Yes
|
| idDocumentNumber | ID Document number of the user. | AN255 [a-zA-Z0-9] |
Yes
|
| idIssuer | ID Document issuer name or provider. | AN255 [a-zA-Z0-9] |
Yes
|
| idIssuer | ID Document issuer name or provider. | AN255 [a-zA-Z0-9] |
Yes
|
| idIssueDate | ID Document issue date. | AN255 [A-Z0-9] |
Yes
|
| idExpriryDate | ID Document expiry date | AN255 [A-Z0-9] |
Yes
|
| countryCode | ISO country code (provided table) | N255 [0-9] |
Yes
|
| citizenshipCode | ISO citizenship code | N255 [0-9] |
Yes
|
| addressLine | Building name, and/ or street name of the customer's shipping address. | AN1000 [A-Za-z0-9]{1,1000} | Yes
|
| dateOfBirth | User's date of birth | N255 [0-9] | Yes
|
| mobileNumber | User's mobile number (with country code eg.0091) | N255 [0-9] | Yes
|
| cardType | Card Type assigned to user for prepaid card (Personalized or Non-personalized) | A | Yes
|
Response Parameters
This reference list lists all the standard flow parameters to be received in response.
| Parameter | Description | Format | Required |
|---|---|---|---|
| isMerchant | Create account for merchant if flag is enable(eg: 0 or 1). | N20
[0-9] |
Yes |
| currencyList | Get list of currencies available for signup | A3 [A-Z]{3} |
Yes |
| status | Response status (SUCCESS/FAILED). | A [A-Z] |
Conditional |
| cust_id | Generated unique customer id on per user sign up. | N50
[0-9]{50} |
Yes |
| secKey | Generated secret key for per user. | String | Yes |
| amount | Amount of the transaction. | N50
[0-9] {1,50} |
Yes |
| trackingId | Unique transaction Id for Load money operation. | N50
[0-9] {50} |
Yes |
| id | Unique transaction id for each transaction. | N50 [0-9] {50} |
Yes |
| toCustName | Receiver's Name of the verify user and currency. | A255 [a-zA-Z] | Yes |
| exchangeCurrency | Sending amount to different currency will get the exchange currency amount. | N50
[0-9] |
Conditaional
|
| toCurrencyCode | Displays for different currency user's only. | N50
[0-9] |
Conditaional
|
| to_cust_name | Receiver's Name of the sent amount. | A255 [a-zA-Z] |
Yes
|
| customerName | Receiver's Name of the requested amount. | A255 | Yes
|
| fromCustName | Requested Pending list names. | A255 | Yes
|
| narration | Requested amount description from pending list. | AN255
[0-9] |
Conditaional
|
| requestId | Get request id from pending list for requested amount | N255 [0-9] |
Yes
|
| activityType | Gets the activity type for activities or operations performed in Activity logs. | A255 | Yes
|
| toMobile | Receiver's mobile number (with country code eg.91). | N10 [0-9] |
Yes
|
| registeredTime | Transactions or activities performed time. | N50 | Yes
|
| statusDescription | Transaction status description. | A255 | Conditaional |
| billingDescriptor | Transaction descriptor | A [0-9] |
Conditional
|
| cardFirstSix | User's Card number First six digits | N6 [0-9]{6} |
Yes
|
| cardLastFour | User's Card number Last four digits | N4 0-9{4} |
Yes
|
| paymentMode | Payment method for paying amount. For ex: CC for Credit Cards |
AN32 [a-zA-Z0-9] {1,32} |
Yes
|
| voucherNumber | Will get voucher number on withdraw with voucher. | N50 [0-9] |
Conditional
|
| PaymentModeResponse | Payment modes list for withdraw | A255 | Yes
|
| loyaltyPoints | Points to redeem | N50 [0-9] |
Yes
|
| loyaltyAmount | Points redeemed converted to amount | N50 [0-9] |
Yes
|
| cardToken | Card token for prepaid card | N100 [0-9] |
Yes
|
| nameOnCard | Name on Prepaid Card | A255 [a-zA-Z] |
Yes
|
| maskedCardNumber | Prepaid Card number | N50 [0-9] |
Yes
|
| expirationDate | Prepaid card expiry date | datetime | Yes
|
| expiration | Prepaid card expiry month and year | N50 [0-9] |
Yes
|
| cardStatus | Prepaid Card status | A255 [a-zA-Z] |
Yes
|
| cardProductType | Prepaid Card product type (Virtual or physical) | A255 [a-zA-Z] |
Yes
|
| cardType | Prepaid Card card type (Personalized or non-personalized) | A255 [a-zA-Z] |
Yes
|
| isPhysicalCardApplied | Applied for physical prepaid card flag(eg. 0 or 1) | N50 [0-9] |
Yes
|
| blockedAmount | Amount blocked for prepaid card | N50 [0-9] |
Yes
|
| transactionDetails | Prepaid Card Transaction Details | N [0-9] |
Yes
|
| Transactions | Prepaid card transactions list | AN [a-zA-Z0-9] |
Yes
|
| cardHolderDetails | Prepaid card holder details | AN [a-zA-Z0-9] |
Yes
|