Scan To Pay

KYC Resource

KYC Object

Example KYC Object

{
    "reason": "success",
    "merchantCustomerId": "194285785469288448",
    "createTime": "1762495787664",
    "status": "PROCESSING"
}

KYC Attributes

merchantCustomerId string

merchantCustomerId

createTime string

Timestamp.

reason string

Reason

status string

Status	Description
NONE	No KYC information has been submitted.
PROCESSING	KYC verification is in progress (under system or manual review).
VERIFIED	KYC verification has been successfully completed.
REJECTED	KYC verification failed or was rejected.

Account Capability Resource

Account Capability Object

Example Account Capability Object

{
    "merchantCustomerId": "1991339818717679616",
    "status": false,
    "country": "PH"
}

Account Capability Attributes

merchantCustomerId string

merchantCustomerId

country string

status boolean

ScanToPay Order Resource

Order Object

Example Order Object

{
  "tradeNo": "1965738216225083393",
  "merchantTradeNo": "1990313394997170176",
  "fiatAmount": "100.50",
  "fiatCurrency": "VND",
  "country": "VN",
  "qrData": {
    "qrType": "com.p2pqrpay",
    "bankAccountNumber": "888812345678",
    "bankCode": "TECHCOMBANK"
  },
  "merchantCustomerId": "1990313394997170176",
  "status": "READY",
  "description": "Sell order description",
  "createTime": "1732636500000",
  "completeTime": "1732636500000",
  "type": "PAYMENT",
  "statusCode": "SUCCESS",
  "statusMsg": "Transaction completed successfully"
}

Order Attributes

tradeNo string

Qbit generated order number, globally unique and idempotent.

merchantTradeNo string

Merchant-generated order number, globally unique and idempotent.

fiatCurrency string

Order currency.

fiatAmount string

Order amount, represented as a string with up to 6 decimal places.

country string

Order country.

qrData object

QR code information related to this order, such as type, bank account, and bank code.

merchantCustomerId string

Customer identifier provided by the merchant.

status string

Status	Description
READY	The order has been created and is ready to process. No payment has been made yet.
CLEARING	The payment is being processed or settled through the banking or blockchain network.
PENDING	The order is awaiting payment confirmation or further action before it can proceed.
PAID	The payment has been successfully received and confirmed.
FAILED	The order has failed due to an error, timeout, or unsuccessful payment.

description string

Order description or note provided by the merchant.

createTime string

Timestamp in milliseconds representing the order creation time.

completeTime string

Timestamp in milliseconds representing when the order was completed.

type string

Payment type. Allowable values: PAYMENT

statusCode string

Error or status code returned to the merchant (typically from a third-party provider).

statusMsg string

Error or status message returned to the merchant (typically from a third-party provider).