Check Inquiry Status · PGSwift Docs

POST /api/check/inquiry

Request

Name	Type	Required	Description
merchant_transaction_id	string	true	Merchant-provided transaction identifier.

{
  "merchant_transaction_id": "INQ12300456"
}

Response

Name	Description
status	Request status indicator. true indicates success, false indicates failure.
data.status	Current inquiry status: pending, valid (approved, awaiting transfer), processing, success, fail
data.merchant_transaction_id	Merchant-provided transaction identifier.
data.amount	Transaction amount as a string with 2 decimal places (e.g., `"100000.00"`).
data.bank_code	Bank code used for the transaction.
data.account_number	Account number used in the transaction.
data.reason	Reason for transaction failure or status update (can be null). `Inquiry expired` when the inquiry expired before a transfer was made. See Expired Inquiries.
data.service_fee_final	Final transaction fee applied.

{
    "status": true,
    "data": {
        "status": "success",
        "created_at": "2025-01-01T00:00:00.000000Z",
        "updated_at": "2025-01-01T12:00:00.000000Z",
        "merchant_transaction_id": "INQ12300456",
        "amount": "100000.00",
        "bank_code": "009",
        "account_number": "00000000",
        "reason": "",
        "service_fee_final": "5500.00"
    }
}

{
    "status": false,
    "data": null,
    "message": "Error description"
}

Expired Inquiries

An inquiry that is still pending or valid when its 30-minute window ends is expired. There is no separate expired status. An expired inquiry returns:

data.status: fail
data.reason: Inquiry expired

Use data.reason to tell an expired inquiry apart from other failures. Webhooks report the same outcome as described in Disbursement Expired Webhook.