Get Request Status

Check the status of a specific payment or payout request.

Endpoint Information

Name: Get Payment/Payout Request Status
Method: GET
URL: {{BASE_URL}}/api/v1/payment/request-status

Description

Retrieve the current status of a payment or payout request using the reference ID. This is useful for checking transaction status without relying solely on webhooks.

Authentication

Type: Basic Auth

• Username: App Key
• Password: Secret Key

Query Parameters

Parameter	Type	Required	Description
reference	string	Yes	The unique reference ID of the payment/payout request
merchantAccountId	string	Yes	Your merchant account ID

Example Request

GET {{BASE_URL}}/api/v1/payment/request-status?reference=payout_013503&merchantAccountId=100001

Response

Success Response (Accepted)

{
  "success": true,
  "message": "Request status retrieved successfully",
  "data": {
    "reference": "payout_013503",
    "merchantAccountId": "100002",
    "status": "Accepted",
    "transactionType": "payment",
    "amount": "100.00",
    "currency": "USD",
    "customerEmail": "[email protected]",
    "customerName": "John Doe",
    "processorStatus": "Completed",
    "processorReference": "TXN123456789",
    "createdAt": "2025-12-25 10:30:45",
    "updatedAt": "2025-12-25 10:31:12",
    "paymentMethod": "Credit Card",
    "solutionName": "Trust Payments"
  }
}

Response (Pending)

{
  "success": true,
  "message": "Request status retrieved successfully",
  "data": {
    "reference": "payout_013504",
    "status": "Pending",
    "processorStatus": "Processing",
    "createdAt": "2025-12-26 14:20:30"
    // ...other fields
  }
}

Status Values

Status	Description
Pending	Transaction has been initiated but not yet processed
Accepted	Transaction was successful
Declined	Transaction was declined by the processor
Failed	Transaction failed due to an error
Refunded	Transaction has been refunded

Usage

Use this API to poll for transaction status updates if you cannot use webhooks, or to verify the status of a transaction in real-time.

Related Endpoints

• Transaction List - View all transactions