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": "Success",
    "data": {
        "status": "Accepted"
    }
}

Response (Pending)

{
    "success": true,
    "message": "Success",
    "data": {
        "status": "Pending"
    }
}

or

{
    "success": true,
    "message": "Success",
    "data": {
        "status": "No transaction processed yet"
    }
}

Status Values

Status	Description
Pending	Transaction has been initiated but not yet processed
No transaction processed yet	No transaction has been processed for this request
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