Skip to main content
GET
Check Transaction Status

Endpoint

Description

Retrieves the current status of the specified transaction. This endpoint is useful when:
  • Your webhook notification was not received
  • You need to verify a transaction’s current state
  • You want to poll for transaction completion
  • You need to reconcile transactions

Path Parameters

string
required
ID of the transaction to check statusThis is the transaction_id returned when the transaction was initiated

Response

string
Unique identifier for the transaction
string
Merchant-provided reference ID (if provided during transaction creation)
string
Current status of the transactionPossible values:
  • pending - Transaction is being processed
  • completed - Transaction completed successfully
  • failed - Transaction failed
string
Transaction amount (returned as a string)
string
Currency code (e.g., “USD”)
string | null
Reason for transaction failure (only present when transaction_status is “failed”, otherwise null)

Example Request

Example Response

Best Practices

Polling Strategy

If polling for status, use exponential backoff to avoid overwhelming the API

Webhook First

Always implement webhooks as the primary notification method. Use this endpoint as a fallback

Reference IDs

Use reference_id to match transactions to your internal systems

Error Handling

Handle all three status states (pending, completed, failed) appropriately
This endpoint does not require user authentication (no Authorization header), only your merchant API key.

Error Codes