Skip to content

List payout methods ​

Lists the currencies enabled for your account and, for each, the payout methods and the recipient details they need. Use it before Create payout order to choose paymentMethod and the fields to send.

POST/api/open/order/getPaymentMethods

Full URL = your API base URL + this path. The base URL is shown in the merchant console under Developers → API & callbacks.

Request parameters ​

ParameterTypeRequiredDescription
merchantNostringYesMerchant number
currencyTypestringNoOnly this currency; omit to list all enabled currencies

Response ​

FieldTypeDescription
currencies[].currencystringCurrency code
currencies[].symbolstringCurrency symbol
currencies[].decimalsintDecimal places for amounts
currencies[].methods[].paymentMethodintMethod code, pass it as paymentMethod
currencies[].methods[].namestringMethod name
currencies[].methods[].kindstringbank transfer, wallet e-wallet, qrcode QR payment
currencies[].methods[].fields[]arrayRecipient details required
fields[].keystringField key
fields[].apiParamstringMatching parameter of Create payout order; empty means it can't be sent via the API
fields[].labelstringField label
fields[].requiredboolRequired or not
fields[].patternstringFormat rule (regular expression); empty means no rule
fields[].hintstringHint
currencies[].methods[].banks[]arrayAllowed banks (name, code); if present, choose bankName from this list
json
{
  "code": 0,
  "message": "success",
  "data": {
    "currencies": [
      {
        "currency": "THB",
        "symbol": "฿",
        "decimals": 2,
        "methods": [
          {
            "paymentMethod": 1,
            "name": "Bank transfer",
            "kind": "bank",
            "fields": [
              { "key": "owner", "apiParam": "bankAccountName", "label": "Account name", "required": true, "pattern": "", "hint": "" },
              { "key": "account", "apiParam": "bankAccountNumber", "label": "Account number", "required": true, "pattern": "^[0-9]{10,12}$", "hint": "" }
            ],
            "banks": [ { "name": "Kasikornbank", "code": "KBANK" } ]
          }
        ]
      }
    ]
  }
}

This only illustrates the format; the actual methods, fields and banks come from the API.

Common errors ​

40010, 40017.