Payment integration
Check Status API
Use the status API to fetch the saved payment state and transaction details using the transaction ID.
Overview
The status API allows you to verify whether a payment has been created, is pending, succeeded, failed, or cancelled. It is useful for polling or confirming payment completion after a customer returns from the checkout flow.
This endpoint returns the latest status saved by the payment system; it does not request a fresh status from the payment gateway. Webhook delivery fields can be null if no webhook has been sent.
Check payment status
Fetch the current state of a live payment using its transaction identifier.
GET: https://staging.login.tpipay.ai/api/v1/status/{transaction_id}
Request data
Headers
| Header | Value | Description |
|---|---|---|
X-API-KEY | your-api-key | Merchant API key. |
Authorization | your-api-secret | Merchant API secret. Authorization: Bearer your-api-secret may also be used. |
JSON headers
{
"X-API-KEY": "your-api-key",
"Authorization": "your-api-secret"
}
Body
| Field | Type | Required | Description |
|---|---|---|---|
transaction_id | string | Yes | Transaction ID included in the URL path. |
Example request
GET <?php echo e($apiBaseUrl); ?>/api/v1/status/{transaction_id}
Success response
Check sandbox payment status
Sandbox uses the same transaction-ID URL pattern as live. Authenticate with the sandbox API key and secret.
GET: https://staging.login.tpipay.ai/api/sandbox/status/{transaction_id}
curl --location --request GET 'https://staging.login.tpipay.ai/api/sandbox/status/TXN-abc123' \
--header 'X-API-KEY: your-sandbox-api-key' \
--header 'Authorization: your-sandbox-api-secret'
Example request
Use the payment transaction ID returned when the payment was created.
curl --location --request GET 'https://staging.login.tpipay.ai/api/v1/status/TXN-abc123' \
--header 'X-API-KEY: your-api-key' \
--header 'Authorization: your-api-secret'
Example response
The response contains the saved payment state, supplied return/webhook URLs, and webhook delivery details.
{
"success": true,
"data": {
"transaction_id": "TXN-abc123",
"payment_id": 123,
"currency": "INR",
"amount": "1500.00",
"status": "success",
"success_url": "https://merchant.example/success",
"failure_url": "https://merchant.example/failure",
"cancel_url": "https://merchant.example/cancel",
"webhook_url": "https://merchant.example/webhook",
"webhook_status": "sent",
"webhook_attempts": 1,
"webhook_last_response": "HTTP 200",
"webhook_sent_at": "2026-11-04 16:00:00",
"bank_ref_num": "630713982686",
"payment_method": "UPI",
"paid_at": "2026-11-04 15:59:30"
}
}
