2025-09-11

Banking

Enhanced Chinese Character Support for Company Names

[ENHANCED] Added support for Chinese parentheses in company names and account holder names for specific payment conditions

  • Enhanced input validation to support Chinese parentheses () in company_name and account_holder fields when bank_country_code = CN, account_currency_code = CNH, payment_method = LOCAL, entity_type = COMPANY

Affected Endpoints:

  • Create Payout, request only
  • Create Beneficiary, request only

Changes:

  • Added: Support for Chinese parentheses in company_name field
  • Added: Support for Chinese parentheses in account_holder field

Notes:

  • This enhancement improves user experience for Chinese companies using local payment methods
  • Only applies to specific payment conditions

Relaxed Input Validation for Local Payments

[ENHANCED] Removed input validation for certain fields when using local payment methods with non-CNH/SGD currencies

  • Disabled input validation for multiple fields when payment_method = LOCAL and account_currency_code is not CNH or SGD

Affected Endpoints:

  • Create Payout, request only
  • Create Beneficiary, request only

Changes:

  • Updated: bank_details.account_holder field validation
  • Updated: first_name & last_name field validation
  • Updated: company_name field validation
  • Updated: address.street_address field validation
  • Updated: address.city field validation
  • Updated: address.state field validation

Notes:

  • Validation is only relaxed for local payments with currencies other than CNH or SGD
  • This change provides more flexibility for international local payment processing

Enhanced Payout Reference Validation Rules

[ENHANCED] Updated validation rules for payout_reference field based on payment method and currency

  • Adjusted payout_reference field validation to provide different rules for SWIFT payments and LOCAL payments with non-CNH/SGD currencies

Affected Endpoints:

  • Create Payout, request only

Changes:

  • Updated: payout_reference validation rules based on payment method and currency:
    • SWIFT payments: New validation pattern /^[a-zA-Z0-9/-?:().'+, ]+$/ (supports space and additional special characters)
    • LOCAL payments: No validation when payment_method = LOCAL and account_currency_code is not CNH or SGD

Invoice Document Requirement for INR Cross-Currency Payouts

[NEW] Added mandatory invoice document upload requirement for INR cross-currency payouts

  • Cross-currency payouts to INR now require invoice document upload in the documentation field

Affected Endpoints:

  • Create Payout, request only

Changes:

  • Added: Mandatory invoice document requirement

Notes:

  • Applies when beneficiary.bank_details.account_currency_code = "INR" and clearing_system = "IFSC"
  • Invoice document must be uploaded in the documentation field

Removed OTHER_SERVICES from Purpose Code Enumeration

[BREAKING] Removed OTHER_SERVICES option from purpose_code field enumeration

  • The OTHER_SERVICES value has been removed from the purpose_code field options in Create Payout endpoint

Affected Endpoints:

  • Create Payout, request only

Changes:

  • Removed: OTHER_SERVICES from purpose_code enumeration

Notes:

  • This is a breaking change - existing integrations using OTHER_SERVICES will need to update their purpose_code values

Acquiring

New Webhook Event for Payment Intent

[NEW] Added new webhook event to notify when payment requires customer interaction for authentication

Added Webhook:

  • acquiring.payment_intent.requires_action

Notes:

  • This webhook is triggered when payment intent status is REQUIRES_CUSTOMER_ACTION and occurs during customer interaction phase for authentication purposes