TPI Pay
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

HeaderValueDescription
X-API-KEYyour-api-keyMerchant API key.
Authorizationyour-api-secretMerchant API secret. Authorization: Bearer your-api-secret may also be used.
JSON headers
{
  "X-API-KEY": "your-api-key",
  "Authorization": "your-api-secret"
}

Body

FieldTypeRequiredDescription
transaction_idstringYesTransaction 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"
  }
}