POST
/
v1
/
beneficiaries
/
schema
curl --request POST \
  --url https://api.sandbox.hit-pay.com/v1/beneficiaries/schema \
  --header 'Content-Type: application/json' \
  --header 'X-BUSINESS-API-KEY: <x-business-api-key>' \
  --data '{
  "country": "sg",
  "transfer_method": "bank_transfer",
  "transfer_type": "local",
  "currency": "sgd",
  "holder_type": "individual"
}'

Headers

X-BUSINESS-API-KEY
string
required
Example:

"b286daabf9921b5a01a4621f026c111e046f8911feba212996c92159b98427d"

Body

application/json
country
string

2-letter ISO 3166-1 country code

Required string length: 2
Example:

"sg"

transfer_method
string

The transfer method needs to be specified to ensure that accurate banking details are captured and validated for the specified transfer method. This is required for timely and accurate delivery of funds to the beneficiary account

Example:

"bank_transfer"

transfer_type
string

The transfer type needs to be specified to ensure that accurate banking details are captured and validated for the specified transfer method. This is required for timely and accurate delivery of funds to the beneficiary account

Example:

"local"

currency
string

It is beneficiary bank account currency

Example:

"sgd"

holder_type
enum<string>

The type of the account holder. Individual is for personal accounts, and company is for business accounts.

Available options:
individual,
company
Example:

"individual"