Requery Payment Code

URL: https://api-sandbox.accessbankplc.com/breezepay/requeryPayment

Description : This API is used to retrieve the status of a payment code, including details on whether the code has been used, its validity, and associated transaction details. 

Method: POST

Media Type: application/json

Request Parameter Definition

S/N	Parameter Name	Type	Parameter Required	Description
1	terminal_id	string	Required	Represents the terminal identifier for the transaction, likely indicating the source or device handling the transaction .
2	amount	string	Required	Transaction amount.
3	channel_code	string	Required	Client application code.
4	payment_code	string	Required	Unique code associated with the payment.

Expected Response

S/N	Parameter Name	Description
1	response_code	Response code to indicate success or failure.
2	response_message	Response description to provide more details, e.g., error description.
3	post_resp_code	Indicates the response code from the debit of the customer’s account. "00" confirms that the transaction was successfully posted.
4	post_resp_message	A message confirming the status of the debit of the customer’s account.
5	account_number	Represents the account number involved in the transaction.
6	status	Indicates the current status of a payment or transaction code.
7	code_status	Description of the current status of a payment or transaction code.
8	reversal_status	Indicates whether the transaction has been reversed.
9	release_status	Indicates whether funds held when the code was generated have been released.
10	settlement_status	Describes the status of settlement processing for the transaction.

Sample Payload

Request:

{ 
    "payment_code": "2775351", 
    "terminal_id": "209840G", 
    "amount": "1400", 
    "channel_code": "YOUR CHANNEL CODE" 
} 

Response:

{ 
    "response_code": "00", 
    "response_message": "Successful Request", 
    "transaction_details": { 
        "post_resp_code": "00", 
        "account_number": "09485829003", 
        "post_resp_message": "Successful", 
        "status": "0", 
        "code_status": "USED", 
        "reversal_status": "N", 
        "release_status": "Y", 
        "settlement_status": "Successful Request" 
    } 
}