2025-10-16

Acquiring

ENHANCED Payment Intent Billing Address State Validation

• Enhanced billing address validation for US and Canada payments

Affected Endpoints:

• Create a PaymentIntent, request only
• Confirm a PaymentIntent, request only

Changes:

• Changed: payment_method.card.billing.address.state field validation
• Updated: State field is now conditionally required when billing.address.country_code is "US" or "CA"

NEW Multiple Payment Methods Support

• Added support for additional payment methods in Payment Intent creation

Affected Endpoints:

• Create a PaymentIntent
• Confirm a PaymentIntent

Changes:

• Added: Support for new payment methods: TRUEMONEY, TNG, GCASH, DANA, KAKAOPAY, TOSSPAY, NAVERPAY
• Enhanced: payment_method field now accepts expanded payment method options

Notes:

• These new payment methods expand UQPAY's coverage in Southeast Asian markets

NEW Manual Payment Capture

• Added manual capture functionality for card payments

Affected Endpoints:

• Capture a PaymentIntent (POST /v2/payment_intents/{id}/capture), new endpoint

Changes:

• Added: New endpoint for manual payment capture
• Enhanced: Support for auto_capture = false payment flows
• Added: Configurable capture window period (1-24 hours)

Notes:

• Use this endpoint when auto_capture is set to false or empty
• UQPAY will automatically capture funds after the window period if not manually captured
• Merchants can cancel orders within the capture window period

Banking

ENHANCED Beneficiary Entity Type Notification

• Added beneficiary entity type information to webhook notifications

Affected Endpoints:

• beneficiary.* webhooks

Changes:

• Added: beneficiary_entity_type field to webhook payload
• Enhanced: Webhook notifications now include entity type classification

Notes:

• The new field indicates whether the beneficiary is "INDIVIDUAL" or "COMPANY"

Issuing

ENHANCED Cardholder Phone Number Validation Rules

• Updated phone number length validation for multiple countries

Affected Endpoints:

• Create Cardholder, request only

Changes:

• Updated: Phone number validation rules for the following countries:
  • Nigeria (NG): Now accepts 8 or 10 digits (previously 8 only)
  • Bangladesh (BD): Now accepts 8 or 10 digits (previously 8 only)
  • Libya (LY): Now accepts 8 or 9 digits (previously 8 only)
  • Senegal (SN): Now accepts 7 or 9 digits (previously 7 only)
  • Mayotte (YT): Now accepts 8 or 9 digits (previously 8 only)
  • Ecuador (EC): Now accepts 7 or 9 digits (previously 7 only)
• Updated: Republic of the Congo area code changed from 2420 to 242

Notes:

• Length validation applies to the phone number excluding country/region/area codes