API ReferenceCustomersAPI Integration

Legacy APIs

Deprecated APIs

The endpoints in this section are deprecated and are no longer the standard version. They will continue to work for the foreseeable future, but should not be used for new integrations.

Please use the recommended alternatives listed below.

Migration guidance

All Legacy API endpoints have been superseded by newer versions that offer improved functionality and consistency. We strongly recommend migrating to the latest versions.

Legacy endpointRecommended alternative
POST /v2/customers/{customer_id}/paymentsCreate Payment (v3)
GET /v1/customers/{customer_id}/paymentsList Payments (v3)
GET /v1/customers/{customer_id}/payments/{payment_id}Get Payment Details (v3)

Previous endpoint versions remain available and supported, giving you time to plan and execute migration. For assistance with version migration, contact the Partner Integrations Team.

Key differences

The v3 Payments API provides several improvements over the legacy endpoints:

  • Unified workflow: Combined FX conversion and payment creation in a single request
  • Enhanced tracking: More detailed payment status information
  • Bank transfer instructions: Dedicated endpoint for retrieving funding instructions
  • Improved error handling: More detailed and actionable error responses