Skip to main content
POST
/
query
Query transfer
curl --request POST \
  --url https://wallet-sandbox.ipps.co.th/v1/query \
  --header 'Content-Type: application/json' \
  --header 'X-Signature: <api-key>' \
  --header 'X-Timestamp: <x-timestamp>' \
  --header 'X-Wallet-Code: <x-wallet-code>' \
  --data '
{
  "walletId": "TEPACODE311234567890123",
  "amount": "100.00",
  "receiverType": "MSISDN",
  "receiverValue": "+66812345678"
}
'
{
  "code": "SUCCESS",
  "receiverNameEn": "John Doe",
  "receiverDisplayNameTh": "จอห์น โด",
  "referenceNo": "300211014163956648763720",
  "retrievalReferenceNumber": "128709084489"
}

Authorizations

​
X-Signature
string
header
required

HMAC-SHA256 signature of the request body and timestamp.

Headers

​
X-Wallet-Code
string
required
Example:

"MORETA"

​
X-Timestamp
string
required

Timestamp unix time in milliseconds.

Example:

1715606400000

Body

application/json
​
walletId
string
required
Example:

"TEPACODE311234567890123"

​
amount
string
required
Example:

100

​
receiverType
enum<string>
required
Available options:
NATID,
MSISDN,
EWALLETID
​
receiverValue
string
required

National ID (13 digits) or MSISDN (10 digits) or EWALLETID (15 digits)

Example:

"0066XXXXXXXXX"

Response

Successful query

​
responseCode
string
required

Response code of payment

Example:

"SUCCESS"

​
receiverNameEn
string
required

Receiver display name in English

Example:

"John Doe"

​
receiverDisplayNameTh
string
required

Receiver display name in Thai

Example:

"นายสมชาย ใจดี"

​
referenceNo
string
required

BBL reference number of payment

Example:

"300211014163956648763720"

​
retrievalReferenceNumber
string

Retrieval reference number of payment for cross bank transactions

Example:

"128709084489"