---
title: Initiate Payment
description: Initiate payment requests on POS machines via the API.
---

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
```

## Request Body

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| mercid  required | String  <br>(1-12) | Merchant Id | `767807` |
| orderid  required | String  <br>(4-12) | Order Id | `100553` |
| amount  required | Number  <br>(2-12) | Amount<br>Not required in the case​​ of save card. | `1.00` |
| currency  required | Number  <br>(3) | Numeric currency code | `356` |
| isocurrency  required | String  <br>(3) | ISO Currency code | `INR` |
| customvar  required | String  <br>(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. | `1234567|test|ABC1234` |
| uniqueid  required | String  <br>(4-10) | Unique ID is a unique identifier and have unique value | `011686` |
| mobile  required | Number  <br>(10-15) | Mobile Number | `9XXXXXX157` |
| buyerEmail  required | String | Buyer email id | `xyz@yopmail.com` |
| buyerPhone  required | Number  <br>(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

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| status  required | Number | Status Code | `200` |
| message  required | Array | Status Message<br>200 - Success<br>502 - Failed<br>100 - Merchant Id not valid<br>112 - Invalid Order id<br>113 - Amount not valid | `Success` |

## 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

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

}
```

### Error Response

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