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.transfer_type | Transfer type used: bifast or rtol. |
| 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. |
| data.similarity_score | Name similarity score from 0 to 100 between the name in your request and the account holder name returned by the bank. 0 when the bank returned no name. null when name validation is off for your account, when the bank inquiry failed, or for inquiries created before the score was recorded. |
| data.trigger_source | Who decided the name check: auto_approve (score at or above your auto-approve threshold), auto_reject (score below your auto-reject threshold with auto-reject in Enforce mode; reason is Rejected), admin_telegram (a reviewer decided via Telegram; a rejection has reason Rejected), admin_dashboard (a reviewer approved it or marked it as failed from the dashboard while it was held; Mark as Failed has reason Marked as Failed). null while the inquiry is held (for review or by the amount threshold), after it expired without a decision, or when similarity_score is null. |
{
"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",
"transfer_type": "bifast",
"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:faildata.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.