​

Check Status

• Verify payment completion
• Track transaction status
• Validate redirected payments
• Reconcile transactions securely

​

Endpoint

POST /api/v3/pg/order/status

​

To view all available base URLs and environments, refer to:

​

Authentication required.

​

Request Parameters

​

Example Request Body

{
  "order_id": 6116229263036
}

​

Example cURL Request

curl --request POST \
--url https://sandbox.Elite Neo Bank.com/api/v3/pg/order/status \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "X-API-KEY: pk_test_xxxxxxxxx" \
--header "X-SIGNATURE: GENERATED_SIGNATURE" \
--header "X-TIMESTAMP: GENERATED_TIMESTAMP" \
--data '{
  "order_id": 6116229263036
}'

​

Example Success Response

{
  "code": "200",
  "status": "success",
  "message": "API authentication successful!",
  "return_data": {
    "kwikX_order_id": "kp_9b9e725b-b415-40fd-ac1c-068ab508f7e7",
    "order_id": "6873654104683",
    "order_amount": "105.00",
    "order_currency": "INR",
    "order_status": "PAID",
    "payment_id": "pay_dfg4fgffghfh454",
    "order_source": "API",
    "created_at": null
  }
}

​

Response Parameters

​

Payment Status Values

​

Recommended Verification Flow

1. Create Order API
2. Redirect customer to hosted checkout
3. Customer completes payment
4. Receive redirect/webhook
5. Call Order Status API
6. Verify final payment status server-side

​

Why Order Status Verification is Important

• Browser interruptions
• Network failures
• Customer closing the payment page
• Delayed bank confirmations

​

Best Practices

• Always validate payment status server-side
• Verify webhook notifications
• Store kwikX_order_id for reconciliation
• Retry status checks for processing transactions
• Avoid duplicate order IDs

​

Common Errors

​

400 Bad Request

• Missing order_id
• Invalid payload structure
• Incorrect request format

​

401 Unauthorized

• Invalid API key
• Incorrect signature
• Expired timestamp

​

Order Not Found

• Invalid order ID
• Order does not exist
• Incorrect merchant credentials

​

Recommended Retry Logic

PROCESSING

​

Security Recommendations

• Generate signatures server-side only
• Never expose secret keys publicly
• Use HTTPS only
• Validate webhook signatures
• Verify timestamps before processing responses