Cashier API init-pay-out
init-pay-out is the mechanism for a quick access to the cashier withdrawal section using REST API.
{danger.fa-exclamation} IMPORTANT: If not provided, optional customer data fields will be collected from customer upon login to Cashier One-Time Registration form.
When executing the request, you receive json response that contains redirect_url parameter. The redirect_url parameter is a link that will automatically do the customer login to Cashier.
ENDPOINTS
| Name | URL |
|---|---|
| Sandbox | https://pci-gw-test.praxispay.com/api/init-pay-out |
| Live | https://gw.praxisgate.com/api/init-pay-out |
CHECKLIST
Please contact your account manager or technical support representative in order to confirm the following merchant acccount settings.
| Item | Purpose |
|---|---|
| Cashier API v1.1 | Required for Cashier API to be allowed your CRM. |
| Dynamic Return URL | Required for return_url to work properly. There is a number of dynamic variables supported for this parameter. |
| Merchant ID and Merchant Secret | Required. The merchant credentials will be provided by the Technical Support representative. |
| Backoffice and VT - yes/no | If you consider using Backoffice and VT for customer management, please make sure to provide the Customer Sync callback URL to Technical Support representative. |
REQUEST PARAMETERS
| Variable | Type | Description |
|---|---|---|
| signature | varchar(96) | Required. Request signature. Please refer to How to Build Signature for details on signing the request. |
| merchant_id | varchar(50) | Required. Merchant API client account identifier |
| frontend | varchar(50) | Required. Cashier FrontEnd name, normally it is a common name of the website. Linked to a specific base currency. |
| locale | varchar(5) | Optional. User locale. For ex.: en-GB |
| payment_method | varchar(32) | Optional. Please note: if gateway is provided and non-null, it will override the payment_method |
| pin | varchar(50) | Required. Unique customer id in your system |
| requester_ip | varchar(10) | Optional. Customer's IP address |
| first_name | varchar(25) | Optional. Customer's first name |
| last_name | varchar(25) | Optional. Customer's last name |
| dob | date | Optional. Date of birth of the customer. MM/DD/YYYY format accepted. |
| varchar(50) | Optional. Customer's email | |
| address | varchar(100) | Optional. Customer's address |
| city | varchar(50) | Optional. City of the customer |
| country | varchar(2) | Required. ISO 3166-1 alpha-2 (US, MT, IT, GB, DE etc) |
| currency | varchar(10) | Required. Customer currency |
| state | varchar(3) | Optional |
| zip | varchar(12) | Optional. Postal Code of the customer. |
| phone | int(20) | Optional. Numeric only, includes country area code. 123456 or 111111, should be at least 6 digits long. |
| return_url | varchar(256) | Required. User will be redirected to a specified URL after successful deposit (except cases when there is another rule defined with higher priority) |
| validation_url | varchar(256) | Required. URL to which the deposit validation request will be sent. Please refer to Validation for more details. |
| notification_url | varchar(256) | Required. URL to which the deposit status notification will be sent. Please refer to Notification for more details. |
| timestamp | int(11) | Required. Request time. URL will be active during 1 min after this time |
| version | varchar(3) | Required. API version |
| balance | int(20) | Optional. Current balance in cents. Please note: for certain currencies (JPY, CLP, KRW, VND, BHD, IQD, JOD, LYD, OMR, TND) the amount is sent as-in without being converted to cents, this is important if you multiply by 100 to send the amount in cents |
| variable1 | varchar(256) | Optional. Your custom field which will consist some neсessary information |
| variable2 | varchar(256) | Optional. Your custom field which will consist some neсessary information |
| variable3 | varchar(256) | Optional. Your custom field which will consist some neсessary information |
| profile | int(2) | Optional. Customer's profile level. Different profile levels may be used to configure the transaction and payment method limits |
| gateway | varchar(32) | Optional. HASH value of gateway that should processed transaction |
RESPONSE PARAMETERS
| Variable | Type | Description |
|---|---|---|
| status | int | Required. - 0 if the request was successful - Negative integer if internal server/network error occurs - Positive integer if application/logical error occurs |
| description | varchar(75) | Required. Accurate description of the result. Return the actual error for any exception as it helps to diagnose issues in production |
| version | varchar(3) | Required. API version |
| signature | varchar(96) | Required. sha384 HASH code of response (same algorithm as request signature) |
| redirect_url | varchar(256) | Required. Cashier Autologin URL. When redirected to this URL, the customer will be navigated further to the Cashier deposit page |
| auth_token | varchar(75) | Required. Special token that allows the customer to login during 15 min |
EXAMPLE
Request
For example below: Merchant Secret = "MerchantSecretKey"
curl -X POST \ https://pci-gw-test.praxispay.com/api/init-pay-out \
-H 'Content-Type: application/json' \
-d '{"address":"Green Street 1",
"city":"London",
"country":"GB",
"currency":"USD",
"dob":"1981-09-05",
"email":"[email protected]",
"first_name":"Tom",
"frontend":"Sandbox USD",
"last_name":"Doe",
"locale":"en-GB",
"merchant_id":"praxis_test_user",
"validation_url":"https:\/\/api.merchant.com\/v1\/validate_deposits\/933399",
"notification_url":"https:\/\/api.merchant.com\/v1\/payouts\/933399",
"return_url":"https:\/\/merchant.com\/payment_result\/933399",
"phone":"6712332112","pin":"123",
"requester_ip":"216.111.222.123",
"timestamp":1560934764,
"version":"1.1",
"zip":"01234",
"signature":"a041b25c41a0a899233b548fd2631d24960f9e219781820c829d64511f52e6a666bc7a43e77795e610a0cb81488e44ba"}'Response (OK)
{
"auth_token":"eb2a7a96b3d5ff60c961062c6bedddb8",
"description":"Success",
"redirect_url":"https://compute.praxispay.com/autologin-form/eb2a7a96b3d5ff60c961062c6bedddb8",
"status":0,
"version":"1.1",
"signature":"76a6fd27676ed0851f156ae97b82d70de79e8c68f72aa9eec242d52c465bd219bf7851323d8a001a38fa6df318da86a1",
}Response (ERR)
{
"description":"Timestamp expired",
"status":1,
"version":"1.0",
"signature":"b1834f0054e439773ab7ef7b83b72f6db8d2f555189a207d86bebfc8a028c1917d197dd68191dad294c12a63ee7c991d"
}
You are currently viewing version 3.3 Latest version here