Initiate Payment
POS : Point of Sale is a device that is used to process transactions by merchant. This API will initiate Payment Request on the POS Machine through merchant’s laptop or desktop if we pass the order id and amount of the payment.
https://kraken.airpay.co.in/airpay/ms/pos/api/createRequest Body
Section titled “Request Body”| Parameter | Type Value | Description | Value Like |
|---|---|---|---|
| mercid required | String (1-12) | Merchant Id | 767807 |
| orderid required | String (4-12) | Order Id | 100553 |
| amount required | Number (2-12) | Amount Not required in the case of save card. | 1.00 |
| currency required | Number (3) | Numeric currency code | 356 |
| isocurrency required | String (3) | ISO Currency code | INR |
| customvar required | String (1-250) | Any information passed in the request, which can be received in the response exactly as it was sent. We can pass multiple data in ‘CustomVar’ separated by the ' | ' symbol. |
| uniqueid required | String (4-10) | Unique ID is a unique identifier and have unique value | 011686 |
| mobile required | Number (10-15) | Mobile Number | 9XXXXXX157 |
| buyerEmail required | String | Buyer email id | xyz@yopmail.com |
| buyerPhone required | Number (10-15) | Mobile number (length 10-15) | 9XXXXXX157 |
| buyerFirstName required | String | Buyer first name | RAJESH |
| buyerLastName required | String | Buyer last name | BABU |
| privatekey required | String | Privatekey | 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps |
| checksum required | String | Checksum calculated | 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps |
Success 200
Section titled “Success 200”| Parameter | Type Value | Description | Value Like |
|---|---|---|---|
| status required | Number | Status Code | 200 |
| message required | Array | Status Message 200 - Success 502 - Failed 100 - Merchant Id not valid 112 - Invalid Order id 113 - Amount not valid | Success |
Request Example
Section titled “Request Example”curl --location --request POST 'https://kraken.airpay.co.in/airpay/ms/pos/api/create' \--header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'buyerEmail=xyz@yopmail.com' \ --data-urlencode 'buyerPhone=9XXXXXX157' \ --data-urlencode 'buyerFirstName=RAJESH' \ --data-urlencode 'buyerLastName=BABU' \ --data-urlencode 'amount=1.00' \ --data-urlencode 'mobile=9XXXXXX157' \ --data-urlencode 'orderid=100553' \ --data-urlencode 'customvar=' \ --data-urlencode 'privatekey=91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \ --data-urlencode 'checksum=91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \ --data-urlencode 'mercid=767807' \ --data-urlencode 'currency=356' \ --data-urlencode 'isocurrency=INR' \ --data-urlencode 'uniqueid=011686'Success Response
Section titled “Success Response”HTTP/1.1 200 OK{ "status": 200, "order_id": "100553", "message": "order created successfully"
}Error Response
Section titled “Error Response”{ "status": 500, "message": []}