Documentation
Beneficiaries
Singapore Beneficiary

Singapore Beneficiary

Before making a payment to a Singapore bank account, you must add the account as a beneficiary. Singapore supports two transfer types: BANK (SGD domestic) and SWIFT (USD).

BANK Transfer (SGD)

Below is a sample request for creating a Singapore BANK beneficiary:

cURL
curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
  "reference": "<sample-reference>",
  "country": "SG",
  "currency": "SGD",
  "destination": {
    "type": "BANK",
    "accountName": "Wei Ling Tan",
    "accountNumber": "1234567890",
    "bankCode": 7171,
    "remittancePurpose": "FAMILY_SUPPORT",
    "beneficiary": {
      "type": "INDIVIDUAL"
    },
    "sender": {
      "type": "INDIVIDUAL",
      "accountName": "John Smith",
      "postCode": "10001",
      "dateOfBirth": "1985-03-15",
      "countryOfBirth": "US"
    }
  }
}'

The parameters for adding Singapore BANK beneficiaries are:

ParameterDescriptionRequired
countryCountry of beneficiary payload. Must be SG.
currencyCurrency of transfer. Must be SGD.
destination.typeDestination type. Must be BANK.
accountNameBeneficiary account name.
accountNumberBeneficiary account number (7–16 digits).
bankCodeNumeric bank code for the receiving bank.
remittancePurposeRemittance purpose. Must be one of the supported enumerations below.
💡

The remittance purpose can be any one of the following values: FAMILY_SUPPORT, EDUCATION, GIFT_AND_DONATION, MEDICAL_TREATMENT, MAINTENANCE_EXPENSES, TRAVEL, SMALL_VALUE_REMITTANCE, LIBERALIZED_REMITTANCE, OTHER, CONSTRUCTION_EXPENSES, HOTEL_ACCOMMODATION, ADVERTISING_EXPENSES, ADVISORY_FEES, BUSINESS_INSURANCE, INSURANCE_CLAIMS, DELIVERY_FEES, EXPORTED_GOODS, SERVICE_CHARGES, LOAN_PAYMENT, OFFICE_EXPENSES, PROPERTY_PURCHASE, PROPERTY_RENTAL, ROYALTY_FEES, SHARES_INVESTMENT, FUND_INVESTMENT, TAX_PAYMENT, TRANSPORTATION_FEES, UTILITY_BILLS, PERSONAL_TRANSFER, SALARY_PAYMENT, OTHER_FEES, COMPUTER_SERVICES, REWARD_PAYMENT, INFLUENCER_PAYMENT.

Sender Parameters (Business)

ParameterDescriptionRequired
sender[type]Must be BUSINESS.
sender[accountName]Sender account name.
sender[country]Sender country.
sender[city]Sender city.
sender[address]Sender address.
sender[postCode]Sender postal code.
sender[businessRegistrationNumber]Business registration number.

Sender Parameters (Individual)

ParameterDescriptionRequired
sender[type]Must be INDIVIDUAL.
sender[accountName]Sender full name (must include first and last name).
sender[postCode]Sender postal code.
sender[dateOfBirth]Sender date of birth (YYYY-MM-DD).
sender[countryOfBirth]Sender country of birth.

Beneficiary Parameters

ParameterDescriptionRequired
beneficiary[type]Must be INDIVIDUAL or BUSINESS.

SWIFT Transfer (USD)

Below is a sample request for creating a Singapore SWIFT beneficiary:

cURL
curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
  "reference": "<sample-reference>",
  "country": "SG",
  "currency": "USD",
  "destination": {
    "type": "SWIFT",
    "accountName": "Wei Ling Tan",
    "accountNumber": "1234567890",
    "swiftCode": "DBSSSGSG",
    "bankName": "DBS Bank",
    "bankAddress": "12 Marina Boulevard",
    "bankCity": "Singapore",
    "bankPostCode": "018982",
    "bankCountry": "SG",
    "remittancePurpose": "FAMILY_SUPPORT",
    "beneficiary": {
      "type": "BUSINESS",
      "country": "SG",
      "city": "Singapore",
      "postCode": "018982",
      "address": "12 Marina Boulevard"
    },
    "sender": {
      "type": "INDIVIDUAL",
      "accountName": "John Smith",
      "country": "US",
      "city": "New York",
      "address": "123 Main St",
      "postCode": "10001",
      "dateOfBirth": "1985-03-15",
      "countryOfBirth": "US"
    }
  }
}'

The parameters for adding Singapore SWIFT beneficiaries are:

ParameterDescriptionRequired
countryCountry of beneficiary payload. Must be SG.
currencyCurrency of transfer. Must be USD.
destination.typeDestination type. Must be SWIFT.
accountNameBeneficiary account name.
accountNumberBeneficiary account number.
swiftCodeSWIFT/BIC code (8 or 11 chars, uppercase letters/numbers).
bankNameReceiving bank name.
bankAddressReceiving bank address.
bankCityReceiving bank city.
bankPostCodeReceiving bank postal code.
bankCountryReceiving bank country.
remittancePurposeRemittance purpose. Must be one of the supported enumerations below.
💡

The remittance purpose can be any one of the following values: FAMILY_SUPPORT, EDUCATION, GIFT_AND_DONATION, MEDICAL_TREATMENT, MAINTENANCE_EXPENSES, TRAVEL, SMALL_VALUE_REMITTANCE, LIBERALIZED_REMITTANCE, OTHER, CONSTRUCTION_EXPENSES, HOTEL_ACCOMMODATION, ADVERTISING_EXPENSES, ADVISORY_FEES, BUSINESS_INSURANCE, INSURANCE_CLAIMS, DELIVERY_FEES, EXPORTED_GOODS, SERVICE_CHARGES, LOAN_PAYMENT, OFFICE_EXPENSES, PROPERTY_PURCHASE, PROPERTY_RENTAL, ROYALTY_FEES, SHARES_INVESTMENT, FUND_INVESTMENT, TAX_PAYMENT, TRANSPORTATION_FEES, UTILITY_BILLS, PERSONAL_TRANSFER, SALARY_PAYMENT, OTHER_FEES, COMPUTER_SERVICES, REWARD_PAYMENT, INFLUENCER_PAYMENT.

Sender Parameters (Business)

ParameterDescriptionRequired
sender[type]Must be BUSINESS.
sender[accountName]Sender account name.
sender[country]Sender country.
sender[city]Sender city.
sender[address]Sender address.
sender[postCode]Sender postal code.
sender[businessRegistrationNumber]Business registration number.

Sender Parameters (Individual)

ParameterDescriptionRequired
sender[type]Must be INDIVIDUAL.
sender[accountName]Sender account name.
sender[country]Sender country.
sender[city]Sender city.
sender[address]Sender address.
sender[postCode]Sender postal code.
sender[dateOfBirth]Sender date of birth (YYYY-MM-DD).
sender[countryOfBirth]Sender country of birth.

Beneficiary Parameters

ParameterDescriptionRequired
beneficiary[type]Must be BUSINESS in this schema.
beneficiary[country]Beneficiary country.
beneficiary[city]Beneficiary city.
beneficiary[postCode]Beneficiary postal code.
beneficiary[address]Beneficiary address.