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 --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:
| Parameter | Description | Required |
|---|---|---|
| country | Country of beneficiary payload. Must be SG. | ✅ |
| currency | Currency of transfer. Must be SGD. | ✅ |
| destination.type | Destination type. Must be BANK. | ✅ |
| accountName | Beneficiary account name. | ✅ |
| accountNumber | Beneficiary account number (7–16 digits). | ✅ |
| bankCode | Numeric bank code for the receiving bank. | ✅ |
| remittancePurpose | Remittance 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)
| Parameter | Description | Required |
|---|---|---|
| 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)
| Parameter | Description | Required |
|---|---|---|
| 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
| Parameter | Description | Required |
|---|---|---|
| beneficiary[type] | Must be INDIVIDUAL or BUSINESS. | ✅ |
SWIFT Transfer (USD)
Below is a sample request for creating a Singapore SWIFT beneficiary:
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:
| Parameter | Description | Required |
|---|---|---|
| country | Country of beneficiary payload. Must be SG. | ✅ |
| currency | Currency of transfer. Must be USD. | ✅ |
| destination.type | Destination type. Must be SWIFT. | ✅ |
| accountName | Beneficiary account name. | ✅ |
| accountNumber | Beneficiary account number. | ✅ |
| swiftCode | SWIFT/BIC code (8 or 11 chars, uppercase letters/numbers). | ✅ |
| bankName | Receiving bank name. | ✅ |
| bankAddress | Receiving bank address. | ✅ |
| bankCity | Receiving bank city. | ✅ |
| bankPostCode | Receiving bank postal code. | ✅ |
| bankCountry | Receiving bank country. | ✅ |
| remittancePurpose | Remittance 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)
| Parameter | Description | Required |
|---|---|---|
| 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)
| Parameter | Description | Required |
|---|---|---|
| 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
| Parameter | Description | Required |
|---|---|---|
| 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. | ✅ |