> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.redpincompany.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.redpincompany.com/_mcp/server.

# Legacy APIs

> Deprecated API endpoints that are no longer the standard version

> **Warning**
>
> **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 endpoint                                         | Recommended alternative                                                                           |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `POST /v2/customers/{customer_id}/payments`             | [Create Payment](/api-reference/customers/api-integration/payments/create-payment) (v3)           |
| `GET /v1/customers/{customer_id}/payments`              | [List Payments](/api-reference/customers/api-integration/payments/list-payments) (v3)             |
| `GET /v1/customers/{customer_id}/payments/{payment_id}` | [Get Payment Details](/api-reference/customers/api-integration/payments/get-payment-details) (v3) |

> **Info**
>
> 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