Query Payment

Through this API, a payment's status can be identified. After calling the Create Payment API, a payment id is returned. Using this payment id, the Query Payment API can be called at anytime.

Query a payment transaction using the following endpoint:

Endpoint: GET https://apihit.net/api/payment/status/{creedo_payment_id}

Success Response Parameters

Property	Type	Description
gateway_status	String	"accepted"
creedo_payment_id	String	Creedo-generated payment ID for this payment creation request. This payment ID can be used later to track the payment and in other payment-related APIs.
merchant_payment_id	String	Unique invoice number used on the merchant side for this specific payment.
payment_amount	Integer	Specifies the total payment amount set in the create payment API call.
received_amount	Integer or null	Indicates the amount of the payment that has been successfully received by Creedo.
payment_currency	String	Currency of the mentioned amount.
payment_method	String	Payment method of the mentioned order.
creation_time	String	The time when the payment was created.
payment_status	String	Current state of this payment.

Error Response Parameters

Property	Type	Description
gateway_status	String	"rejected"
message	String	Error message here.

Success Response

A successful response will return a JSON object containing:

{
    "gateway_status": "accepted",
    "creedo_payment_id": "8QAR88VWQ8",
    "merchant_payment_id": "37862050",
    "payment_method": "UPAY_P2C",
    "payment_currency": "BDT",
    "payment_amount": 550,
    "received_amount": 550,
    "creation_time": "2025-10-27T12:10:34.425Z",
    "payment_status": "paid"
}

Error Response

In case of an error, the API will return a JSON object with error details:

{
    "gateway_status": "rejected",
    "message": "Unknown error occurred."
}