Create Beneficiary

Paynow

This section demonstrates how to create a beneficiary for PayNow.

FieldTypeDescription
payment_methodstringMust be "LOCAL"
bank_details.bank_country_codestringMust be "SG"
bank_details.account_currency_codestringMust be "SGD"
bank_details.clearing_systemstringMust be "PayNow"
additional_info.proxy_idstringPayNow identifier; must be UEN, phone number, or VPA depending on actual user info.
first_name & last_namestringRequired when entity_type is INDIVIDUAL. Must be the real and valid name
company_namestringRequired when entity_type is COMPANY. Must be the real and valid name
Other fieldsstringIf the actual values are not available, you may provide arbitrary values. We do not perform validation on these fields, but they are still required in the request.

{
  "email": "[email protected]",
  "entity_type": "INDIVIDUAL",
  "payment_method": "LOCAL",
  "nickname": "nick name",
  "first_name": "first name", // should be real name
  "last_name": "last name", // should be real name
  "bank_details": {
    "bank_country_code": "SG",
    "account_currency_code": "SGD",
    "clearing_system": "PayNow"
  },
  "address": {
    "country": "SG",
    "city": "city",
    "street_address": "random address would be okay",
    "postal_code": "123456",
    "state": "CA",
    "nationality": "SG"
  },
  "additional_info": {
    "proxy_id": "UEN, phone number, or VPA"
  }
}

{
  "email": "[email protected]",
  "entity_type": "COMPANY",
  "company_name": "UQPAY", // should be real name
  "payment_method": "LOCAL",
  "nickname": "random name",
  "bank_details": {
    "bank_country_code": "SG",
    "account_currency_code": "SGD",
    "clearing_system": "PayNow"
  },
  "address": {
    "country": "SG",
    "city": "city",
    "street_address": "random address would be okay",
    "postal_code": "123456",
    "state": "CA",
    "nationality": "SG"
  },
  "additional_info": {
    "proxy_id": "UEN, phone number, or VPA7"
  }
}