Initiate Payment

PUSH TO POS - 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.

POST

https://kraken.airpay.co.in/airpay/ms/pos/api/create

Parameter

Field	Type	Required	Description
mercid	String	Yes	Merchant ID (length 1-12)
orderid	String	Yes	Order ID (length 4-12)
amount	Number	Yes	Amount (length 12,2) Not required in the case of save card.
currency	Number	Yes	Numeric currency code eg: 356 (length 3)
isocurrency	String	Yes	ISO Currency code eg: INR (length 3)
customvar	String	No	Any information passed in the request, which can be received in the response exactly as it was sent. Multiple values can be passed separated by |. Example: 1234567|test|ABC1234 (length 250)
uniqueid	String	Yes	Unique identifier with unique value (length 4-10)
mobile	Number	No	Mobile Number (length 10-15)
buyerEmail	String	No	Buyer email ID
buyerPhone	Number	No	Mobile number (length 10-15)
buyerFirstName	String	No	Buyer first name
buyerLastName	String	No	Buyer last name
privatekey	String	No	Private Key
checksum	String	No	Calculated checksum

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 200

Field	Type	Description
status	Number	Status Code
message	String	Status Message 200 - Success 502 - Failed 100 - Merchant Id not valid 112 - Invalid Order id 113 - Amount not valid

Success-Response:

HTTP/1.1 200 OK
{
        "status": ​200​,
         "order_id": "100553",
          "message": "order created successfully"

}

Error-Response:

{
    "status": 500,
    "message": []
}