Summary

🚀 Currency Expansion & Recipient Management Enhancements: Added support for payout currencies and enhanced recipient management with currency-specific fields for better compliance and data management.

Recipient APIs now support currency-specific additional details, enabling compliance with local regulatory requirements for different payout currencies.

New Features

Payout Currencies Support

Get Currencies

  • What’s New: Added payout_currencies array to the currencies reference endpoint
  • Purpose: Returns the list of currencies that can be used for payouts in your organisation
  • Benefits:
    • Enables clients to programmatically determine available payout currencies
    • Supports dynamic currency selection in payment workflows
    • Provides clear visibility into supported payout options

Enhanced Recipient Management

Add a New Recipient & Update a Recipient’s Account

  • What’s New: Added additional_details object to both recipient creation and update payloads
  • Purpose: Support currency-specific fields required for different payout currencies
  • Key Features:
    • Flexible map structure for currency-specific information
    • Example structure:
      1"additional_details": {
      2 "tax_id": "AH12345678"
      3}
    • Supported Currencies and Fields:
      • BRL (Brazilian Real): Tax ID must be provided in the tax_id field
      • KRW (South Korean Won): Business Registration number must be provided in the tax_id field
      • PKR (Pakistani Rupee): Identification number must be provided in the tax_id field
      • ISK (Icelandic Króna): Supported currency for currency-specific recipient payloads
    • Enables compliance with local regulatory requirements
    • Allows modification of tax identification numbers or registration details when updating recipients

Get Recipients & Get Recipient Details

  • What’s New: Response now includes additional_details object
  • Purpose: Retrieve tax identification numbers or registration numbers for recipients when available
  • Key Features:
    • Returns currency-specific recipient information
    • Provides complete recipient profile including compliance data
    • Supports audit and compliance workflows

Breaking Changes

  • None. All changes are additive and backward compatible.