Transfer lookup outcomes

Every lookup with the bank ends in one of the values below. The API value and the label on screen are the same set.

outcomeLabelCredit
FOUNDFound1 credit taken
NOT_FOUNDNot foundNo credit taken
DUPLICATEDuplicateNo credit taken
PENDINGWaiting for bankNo credit taken
UNAVAILABLEUnavailableNo credit taken
INVALID_QRInvalid QRNo credit taken
INVALID_FILEUnreadable fileNo credit taken
QR_TAMPEREDQR mismatchNo credit taken
TOO_OLDToo oldNo credit taken

FOUND Found

Meaning

The sending bank holds a transfer for this reference and returned its data, as of the time we asked.

What to do

Compare the amount, receiver and time with your order, then decide yourself.

NOT_FOUND Not found

Meaning

The sending bank holds no transfer for this reference at the time we asked.

What to do

Hold the order and ask the payer for the slip again, straight from their bank app.

DUPLICATE Duplicate

Meaning

Your account already looked up this transfer.

What to do

Open the first lookup in duplicate_of and check which order it belongs to before accepting it again.

PENDING Waiting for bank

Meaning

The bank does not show this transfer yet; we ask again for you for up to 15 minutes.

What to do

Wait for the webhook, or read this lookup again after Retry-After.

UNAVAILABLE Unavailable

Meaning

No definite answer from the banking system right now.

What to do

Send again with the same Idempotency-Key after Retry-After.

INVALID_QR Invalid QR

Meaning

No Thai bank transfer-slip QR in what was sent.

What to do

Send a slip image with a clear QR, or the QR text from the slip.

INVALID_FILE Unreadable file

Meaning

The file is empty, broken, too large or not a supported image.

What to do

Save the slip as a JPEG / PNG / WebP image and send again.

QR_TAMPERED QR mismatch

Meaning

The QR content is not what the bank issued.

What to do

Ask the payer for the original slip from their bank app.

TOO_OLD Too old

Meaning

The date in the reference is older than the sending bank lets us look back.

What to do

Check this transfer with the bank directly (days per bank on /docs/banks).