2025-09-11
2 days ago by marshall
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
()
incompany_name
andaccount_holder
fields whenbank_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 andaccount_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
andaccount_currency_code
is not CNH or SGD
- SWIFT payments: New validation pattern
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" andclearing_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 thepurpose_code
field options in Create Payout endpoint
Affected Endpoints:
- Create Payout, request only
Changes:
- Removed:
OTHER_SERVICES
frompurpose_code
enumeration
Notes:
- This is a breaking change - existing integrations using
OTHER_SERVICES
will need to update theirpurpose_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