2025-08-28

Banking

Made email and nickname optional

  • The email and nickname fields for all beneficiaries are now optional.
  • Affected Endpoints:
    • Create Beneficiary, request only
    • Create Payout, request only
  • Changes:
    • email: Required → Optional
    • nickname: Required → Optional

Field adjustments for Singapore (SGD) accounts

  • When bank_details.bank_country_code = SG and bank_details.account_currency_code = SGD, several request fields are adjusted.
  • Affected Endpoints:
    • Create Beneficiary, request only
    • Create Payout, request only
  • Changes:
    • company_name: Removed
    • first_name: Removed
    • last_name: Removed
    • email: Changed to optional
    • nickname: Changed to optional
    • address.country: Removed
    • address.street_address: Removed
    • address.city: Removed
    • address.state: Removed
    • address.postal_code: Removed

[BREAKING] New validation rule for bank_details.account_holder

  • A new format validation applies only when all three conditions are met:
    • entity_type = INDIVIDUAL
    • bank_details.bank_country_code = SG
    • bank_details.account_currency_code = SGD
  • Affected Endpoints:
    • Create Beneficiary, request only
    • Create Payout, request only
  • Changes:
    • New validation requirements for bank_details.account_holder:
      • Only English letters (A–Z, a–z) and spaces are allowed
      • Length must be 2–140 characters
      • Must include a space separating first and last name
    • If any condition is not met, the previous validation rules remain unchanged

Card Issuing

Added consumed_amount field

  • Introduced new field consumed_amount in List and Retrieve Card API responses, representing the cumulative amount of the card limit that has already been used.
  • Affected Endpoints:
    • List Cards, response only
    • Retrieve Card, response only
  • Changes:
    • Added consumed_amount field