Transactions API

Query transaction status, retrieve transaction history, and filter transactions.

Get Transaction Status (Production)

GET/api/production/status/:id

Returns the current status of a transaction. No authentication required.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Transaction ID

Success Response

200

{
  "success": true,
  "data": {
    "transactionId": "TXN-20240101-ABC123",
    "orderId": "ORD-12345",
    "status": "SUCCESS",
    "amount": 100.5,
    "currency": "USD",
    "createdAt": "2024-01-01T12:00:00Z",
    "completedAt": "2024-01-01T12:00:05Z"
  }
}

This endpoint does not require authentication, making it suitable for public status checks. However, it only returns basic transaction status information.

Get Transaction Status (Sandbox)

GET/api/sandbox/status/:id

Returns the current status of a transaction in sandbox mode. No authentication required.

Path Parameters

Same as production endpoint.

Get Production Transactions

GET/api/v1/production-transactions

Requires API Key

Returns paginated list of production transactions with filtering options.

Query Parameters

Parameter	Type	Required	Description
page	number	No	Page number (default: 1)
limit	number	No	Items per page (default: 20, max: 100)
status	string	No	Filter by status (SUCCESS, FAILED, PENDING, etc.)
transactionId	string	No	Filter by transaction ID
orderId	string	No	Filter by order ID
startDate	string	No	Start date (ISO 8601 format)
endDate	string	No	End date (ISO 8601 format)

Example Request

GET /api/v1/production-transactions?page=1&limit=20&status=SUCCESS&startDate=2024-01-01T00:00:00Z&endDate=2024-01-31T23:59:59Z

Success Response

200

{
  "success": true,
  "data": {
    "transactions": [
      {
        "transactionId": "TXN-20240101-ABC123",
        "orderId": "ORD-12345",
        "status": "SUCCESS",
        "amount": 100.5,
        "currency": "USD",
        "createdAt": "2024-01-01T12:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 100,
      "totalPages": 5
    }
  }
}

Get Sandbox Transactions

GET/api/v1/sandbox-transactions

Requires API Key

Returns paginated list of sandbox transactions.

Query Parameters

Same query parameters as production transactions endpoint.

Get Production Wallet Transactions

GET/api/v1/production-wallet-transactions

Requires API Key

Returns paginated list of production wallet/payout transactions.

Query Parameters

Parameter	Type	Required	Description
page	number	No	Page number (default: 1)
limit	number	No	Items per page (default: 20, max: 100)

Get Sandbox Wallet Transactions

GET/api/v1/sandbox-wallet-transactions

Requires API Key

Returns paginated list of sandbox wallet/payout transactions.

Query Parameters

Same query parameters as production wallet transactions endpoint.