Get Status Payin by REF

Queries on Transactions

Get Status Payin by REF

4. payin_status_by_ref

 
Description:
 
Fetches the status of a pay-in using the Merchant's reference ID. This endpoint provides detailed information about the transaction status, ensuring accuracy and transparency for merchants.
 
URL: https://api.tezpay.online/api/v1/tezpay/check-payment-status-by-ref/
 

Request Parameters:

Parameter
Type
Description
payment_method
String
Service code, e.g., IMPS_IN.
merchant_reference
String
Merchant’s Unique TX (i.e. ‘PAY892384082349‘)

Expected Response:

Field
Type
Description
status
String
Status of the request (success, error).
tx_id
String
Unique transaction identifier.
data.status
String
Current transaction status, e.g., COMPLETED.
amount
Float
Amount associated with the transaction.
merchant_reference
String
Merchant’s Unique TX (i.e. ‘PAY892384082349‘)
updated_at
String
Latest time the TX was updated (UTC)

Example Request:

{ 
	"payment_method": "IMPS_IN", 
	"merchant_reference": "PAY4653613838"
}
 

Example Response:

{
    "status": "success",
    "data": {
        "tx_id": "c8e092a1-658a-4216-8747-abedca22ff6a",
        "merchant_reference": "PAY4653613844",
        "status": "PENDING",
        "amount": 11.0,
        "updated_at": "Fri, 19 Sep 2025 18:47:13 GMT"
    }
}