Order Comfirmation
ORDER CONFIRMATION - Order Confirmation
Section titled “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.
https://kraken.airpay.co.in/airpay/order/verify.phpHeader
Section titled “Header”| Field | Type | Description |
|---|---|---|
| Content-Type | String | application/x-www-form-urlencoded |
Parameter
Section titled “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-DDalldata = merchant_id.merchant_txn_id.processor_id.rrn.terminal_id.txn_type.dateKey generated by : key = hash('SHA256', username."~:~".password)Hash generated by : hash('SHA256', key.'@'.alldata) |
Request-Example:
Section titled “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
Section titled “Success 200”| Field | Type | Description |
|---|---|---|
| APTRANSACTIONID | Numeric | Airpay transaction reference number |
| AMOUNT | Numeric | Amount |
| TRANSACTIONSTATUS | Numeric | Transaction Status Success - 200 Transaction is success Transaction in Process - 211 Transaction in processing Failed - 400 Transaction in failed Dropped - 401 The transaction will not register properly Cancel - 402,502 payment that has not yet been processed Incomplete - 403 Not recieved any call back from bank Bounced - 405 The transaction has bounced No 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 |
| 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 |
| CUSTOMEREMAIL | Customer Email customer@example.com (length 6-50) | |
| CUSTOMERPHONE | Numeric | Space |
| 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 - 310 Sale - 320 Capture - 330 Refund - 340 Chargeback - 350 Reversal - 360 SaleComplete - 370 SaleAdjust - 380 TipAdjust - 390 Sale+Cash - 400 Cashback - 410 Void - 420 Release - 430 Cashwithdrawal - 440 Awaiting Confirmation - 450 |
| TRANSACTIONPAYMENTSTATUS | Alphanumeric | Transaction Payment Status Transaction 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 - 3 6 Months - 6 9 Months - 9 12 Months - 12 18 Months - 18 24 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:
Section titled “Success-Response:”<?xml version="1.0"?><RESPONSE> <TRANSACTION> <TRANSACTIONSTATUS><![CDATA[200]]></TRANSACTIONSTATUS> <MESSAGE><![CDATA[Success]]></MESSAGE> <APTRANSACTIONID><![CDATA[17691556]]></APTRANSACTIONID> <TRANSACTIONID><![CDATA[TestOrder24]]></TRANSACTIONID> <AMOUNT><![CDATA[1.00]]></AMOUNT> <ap_SecureHash><![CDATA[3901005794]]></ap_SecureHash> <AP_SECUREHASH><![CDATA[3901005794]]></AP_SECUREHASH> <CUSTOMVAR><![CDATA[]]></CUSTOMVAR> <CARDCOUNTRY><![CDATA[australia]]></CARDCOUNTRY> <CHMOD><![CDATA[pg]]></CHMOD> <CONVERSIONRATE><![CDATA[]]></CONVERSIONRATE> <BANKNAME><![CDATA[anz bank]]></BANKNAME> <CARDISSUER><![CDATA[visa]]></CARDISSUER> <CARDTYPE><![CDATA[Credit]]></CARDTYPE> <CUSTOMER><![CDATA[SANEESH]]></CUSTOMER> <CUSTOMEREMAIL><![CDATA[SANEESH.KUTTAPPAN@AIRPAY.CO.IN]]></CUSTOMEREMAIL> <CUSTOMERPHONE><![CDATA[8287456879]]></CUSTOMERPHONE> <CURRENCYCODE><![CDATA[356]]></CURRENCYCODE> <RISK><![CDATA[0]]></RISK> <TRANSACTIONTYPE><![CDATA[320]]></TRANSACTIONTYPE> <TRANSACTIONTIME><![CDATA[27-07-2022 12:48:00]]></TRANSACTIONTIME> <CARD_NUMBER><![CDATA[462294XXXXXX3713]]></CARD_NUMBER> <TRANSACTIONPAYMENTSTATUS><![CDATA[success]]></TRANSACTIONPAYMENTSTATUS> <MERCHANT_NAME><![CDATA[Adam Innovations Test]]></MERCHANT_NAME> <WALLETBALANCE><![CDATA[]]></WALLETBALANCE> <SURCHARGE><![CDATA[]]></SURCHARGE> <SETTLEMENT_DATE><![CDATA[]]></SETTLEMENT_DATE> <BILLEDAMOUNT><![CDATA[1.00]]></BILLEDAMOUNT> <TRANSACTIONREASON><![CDATA[]]></TRANSACTIONREASON> <RRN><![CDATA[016153570198200]]></RRN> </TRANSACTION></RESPONSE>Fail-Response:
Section titled “Fail-Response:”<?xml version="1.0"?><RESPONSE> <TRANSACTION> <TRANSACTIONSTATUS><![CDATA[503]]></TRANSACTIONSTATUS> <MESSAGE><![CDATA[Transaction details not available]]></MESSAGE> <APTRANSACTIONID><![CDATA[]]></APTRANSACTIONID> <TRANSACTIONID><![CDATA[]]></TRANSACTIONID> <AMOUNT><![CDATA[]]></AMOUNT> <ap_SecureHash><![CDATA[]]></ap_SecureHash> <AP_SECUREHASH><![CDATA[]]></AP_SECUREHASH> <CUSTOMVAR><![CDATA[]]></CUSTOMVAR> <CARDCOUNTRY><![CDATA[]]></CARDCOUNTRY> <CHMOD><![CDATA[]]></CHMOD> <CONVERSIONRATE><![CDATA[]]></CONVERSIONRATE> <BANKNAME><![CDATA[]]></BANKNAME> <CARDISSUER><![CDATA[]]></CARDISSUER> <CARDTYPE><![CDATA[]]></CARDTYPE> <CUSTOMER><![CDATA[]]></CUSTOMER> <CUSTOMEREMAIL><![CDATA[]]></CUSTOMEREMAIL> <CUSTOMERPHONE><![CDATA[]]></CUSTOMERPHONE> <CURRENCYCODE><![CDATA[]]></CURRENCYCODE> <RISK><![CDATA[]]></RISK> <TRANSACTIONTYPE><![CDATA[]]></TRANSACTIONTYPE> <TRANSACTIONTIME><![CDATA[]]></TRANSACTIONTIME> <TRANSACTIONPAYMENTSTATUS><![CDATA[transaction details not available]]></TRANSACTIONPAYMENTSTATUS> <MERCHANT_NAME><![CDATA[]]></MERCHANT_NAME> <WALLETBALANCE><![CDATA[]]></WALLETBALANCE> <SURCHARGE><![CDATA[]]></SURCHARGE> <SETTLEMENT_DATE><![CDATA[]]></SETTLEMENT_DATE> <BILLEDAMOUNT><![CDATA[]]></BILLEDAMOUNT> <TRANSACTIONREASON><![CDATA[]]></TRANSACTIONREASON> <RRN><![CDATA[]]></RRN> </TRANSACTION></RESPONSE>