---
title: Order Comfirmation
description: This API can PULL transaction updates like transaction status to the merchant host after the order is confirmed.
---
# ORDER CONFIRMATION - Order Confirmation
This API can PULL transaction updates like transaction status to the merchant host after the order is confirmed. This API will work only on live MID, for the sandbox MID this API will not work.
## POST
```
https://kraken.airpay.co.in/airpay/order/verify.php
```
## Header
| Field | Type | Description |
| --- | --- | --- |
| Content-Type | String | application/x-www-form-urlencoded |
## Parameter
| Field | Type | Required | Description |
| --------------- | ------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| merchant_id | Numeric | Yes | Merchant ID (length 1-12) |
| merchant_txn_id | Alphanumeric | No | Order ID sent to Airpay system (length 1-30) |
| processor_id | Numeric | No | Airpay transaction reference number (length 4-20) |
| rrn | Numeric | No | Retrieval Reference Number (length 4-20) |
| private_key | Alphanumeric | Yes | Private Key (length 10-200)`private_key = hash('sha256', secret.'@'.username.':\|:'.password)` |
| terminal_id | Numeric | No | POS terminal ID (length 8) |
| txn_type | Alphanumeric | No | Type of transaction, e.g. `pos` |
| checksum | Alphanumeric | Yes | Checksum generation:`date = YYYY-MM-DD``alldata = merchant_id.merchant_txn_id.processor_id.rrn.terminal_id.txn_type.date`Key generated by : `key = hash('SHA256', username."~:~".password)`Hash generated by : `hash('SHA256', key.'@'.alldata)` |
## Request-Example:
```
curl --location --request POST 'https://kraken.airpay.co.in/airpay/order/verify.php' \
--form 'merchant_id=1' \
--form 'merchant_txn_id=123Sqt753579854' \
--form 'processor_id=1866' \
--form 'private_key=71a4efaf21c79864ec154babfc494f45fd1f65a570805084965d5b29486f1dfe' \
--form 'terminal_id =12395678' \
--form 'txn_type=pos' \
--form 'checksum=faf21c79864ec154babfc494f45fd1f65a570805084965d5'
```
## Success 200
| Field | Type | Description |
| --- | --- | --- |
| APTRANSACTIONID | Numeric | Airpay transaction reference number |
| AMOUNT | Numeric | Amount |
| TRANSACTIONSTATUS | Numeric | Transaction StatusSuccess - 200 Transaction is successTransaction in Process - 211 Transaction in processingFailed - 400 Transaction in failedDropped - 401 The transaction will not register properlyCancel - 402,502 payment that has not yet been processedIncomplete - 403 Not recieved any call back from bankBounced - 405 The transaction has bouncedNo Records - 503 There is no records found |
| MERCHANT_NAME | Varchar | Merchant name |
| WALLETBALANCE | Numeric | Remaining balance in wallet |
| SURCHARGE | Numeric | Additional charges for particular transaction |
| SETTLEMENT_DATE | Date | Settlement date |
| BILLEDAMOUNT | Numeric | Billed amount |
| TERMINALID | Alphanumeric | Terminal id |
| POSENTRYMODE | Alphanumeric | Pos entry mode |
| CC_EXPIRY | Date | Card expiry |
| RRN | Alphanumeric | RRN |
| AUTHCODE | Numeric | Authentication Code (length 6)In case of sale completion it is required. |
| TOKEN | Alphanumeric | Token |
| CARDUNIQUECODE | Alphanumeric | Card unique code |
| REASON | Alphanumeric | Reason |
| TRANSACTIONREASON | Alphanumeric | Transaction reason |
| CUSTOMERBANKBAL | Numeric | Customer bank balance |
| CARDCOUNTRY | Alphanumeric | Card country |
| CONVERSIONRATE | Numeric | Conversion rate |
| MESSAGE | Alphanumeric | Response message received from the payment gateway |
| CUSTOMERVPA | Alphanumeric | VPA will return if channel is upi |
| ap_SecureHash | AlphaNumeric | Secure hash generated by airpay |
| AP_SECUREHASH | AlphaNumeric | Secure hash generated by airpay If Channel is upi,Hash generated by : crc32(TRANSACTIONID. : .APTRANSACTIONID. : .AMOUNT. : .TRANSACTIONSTATUS. : .MESSAGE. : .MID. : .USERNAME. : . CUSTOMERVPA); Otherwise,Hash generated by : crc32(TRANSACTIONID. : .APTRANSACTIONID. : .AMOUNT. : .TRANSACTIONSTATUS. : .MESSAGE. : .MID. : .USERNAME); |
| TRANSACTIONID | Numeric | Merchant order ID (length 1-20) |
| CUSTOMVAR | Alphanumeric|Space|Equal | Any customized info affiliate can pass (length 120 max) |
| CHMOD | Alphanumeric | Payment channel used to make payment ppc - Prepaid cardpg - Payment gatewaynb - Netbankingpgcc - Credit cardpgdc - Debit cardcash - Cashemi - EMIrtgs - RTGSupi - UPIbtqr - Bharat QRpayltr - Pay laterva - Virtual accountenach - eNACHremit - Remittancewallet - Walletpos - POSpayltr - paylateraloan - Aloanaeps - AEPS |
| BANKNAME | Alphanumeric | Bank name used to do the transaction |
| CARDISSUER | Alphanumeric | Card Issuer (length 1-50) |
| CUSTOMER | Alphanumeric|Space | Customer Name |
| CUSTOMEREMAIL | Email | Customer Email customer@example.com (length 6-50) |
| CUSTOMERPHONE | Numeric|Space|Hyphen | Customer Phone (length 8-15) |
| CURRENCYCODE | Numeric | Currency Code (length 3)Indian Rupee - 356 |
| RISK | Numeric | Risk Transaction (0 or 1) |
| TRANSACTIONTYPE | Numeric | Transaction Type (length 3)Mandate approved, Auth - 310Sale - 320Capture - 330Refund - 340Chargeback - 350Reversal - 360SaleComplete - 370SaleAdjust - 380TipAdjust - 390Sale+Cash - 400Cashback - 410Void - 420Release - 430Cashwithdrawal - 440Awaiting Confirmation - 450 |
| TRANSACTIONPAYMENTSTATUS | Alphanumeric | Transaction Payment StatusTransaction Payment Status are: authorize,fail,capture,dropped,bounced,voided,risk,refunded,chargeback,release,reversal,void,mandate approved,incomplete,cancelled and bounced |
| CARD_NUMBER | Numeric | Masked card number (length 12-19) |
| CARDTYPE | Alphanumeric | Card type (length 5) |
| EMITENURE | Numeric | EMI Tenure (length 2)3 Months - 36 Months - 69 Months - 912 Months - 1218 Months - 1824 Months - 24 |
| TRANSACTIONTIME | Alphanumeric | Transaction datetime d-m-Y H:i:s (length 11) |
| SUBSCRIPTIONNEXTRUNDATE | Date | subscription next run date, if subscription transaction |
| SUBSCRIPTIONID | Numeric | Subscription ID, if subscription transaction |
| CAMPAIGNID | Numeric | Campaign ID |
| CAMPAIGNTITLE | Alphanumeric | Campaign title |
| CAMPAIGNDISCOUNT | Numeric | Discount price in campaign |
| CHARGEDAMOUNT | Numeric | Amount charged |
| AUTH_ID | Numeric | Authentication ID |
| IPNID | Numeric | IPN request ID |
| ORIGINAL_CURRENCY | Numeric | Original currency |
| ORIGINAL_FXRATE | Numeric | Foreign currency exchange rate |
| UTRNO | Alphanumeric | Unique Transaction Reference No (length 16-22) |
## Success-Response:
```
```
## Fail-Response:
```
```