Query Transaction Status

Returns live transaction details from DigetPay for a completed payment.

Use this endpoint after checkout to confirm payment server-side. Do not rely on redirect URLs alone — always verify with the status API or webhooks.

Request


Method	`GET`
URL	`{baseUrl}/payment/checkout/status?id={gatewayTransactionId}`
Auth	Header `x-api-key` (required)

Parameters

Parameter	Location	Required	Description
`id`	Query string	Yes	DigetPay gateway transaction ID from the original payment
`x-api-key`	Header	Yes	DigetPay merchant API key

Critical: Pass the gateway transaction UUID in id. Using the checkout session ID from Create Payment Link will not return the correct payment state.

Request payload

{
  "headers": {
    "x-api-key": "YOUR_API_KEY"
  },
  "query": {
    "id": "2232e99b-0257-47d5-bbfd-022c8951767f"
  }
}

Important: The id query parameter is required. Omitting it returns 400 Bad Request.

Responses

{
  "success": {
    "status": 200,
    "body": {
      "code": 200,
      "message": "Success",
      "errorCode": null,
      "data": {
        "content": [
          {
            "transactionId": "2232e99b-0257-47d5-bbfd-022c8951767f",
            "amount": "0.20",
            "transactionStatus": "SUCCESS",
            "paymentStatus": "APPROVED",
            "refundStatus": "NONE",
            "totalRefundAmount": "0.00",
            "pan": "5387  7** **** 4254",
            "cardScheme": "MC"
          }
        ],
        "totalElements": 1
      }
    }
  }
}

{
  "failed": {
    "status": 200,
    "body": {
      "code": 200,
      "message": "Success",
      "errorCode": null,
      "data": {
        "content": [
          {
            "transactionId": "2232e99b-0257-47d5-bbfd-022c8951767f",
            "amount": "0.20",
            "transactionStatus": "FAILED",
            "paymentStatus": "DECLINED",
            "refundStatus": "NONE"
          }
        ],
        "totalElements": 1
      }
    }
  }
}

Key response fields

Field	Description
`transactionStatus`	`SUCCESS`, `FAILED`, `PENDING`
`paymentStatus`	Gateway payment state (e.g. `APPROVED`)
`refundStatus`	`NONE`, `PARTIAL`, `FULL`
`totalRefundAmount`	Total amount already refunded
`transactionId`	Same ID used in the query

Confirmed payment: Treat a payment as successful only when transactionStatus is SUCCESS and paymentStatus is APPROVED.

Important: Use the DigetPay payment gateway transaction ID, not the checkout session ID. See Transaction Identifiers.