Convert

Binance Pay Onchain provides a flexible and powerful Convert capability as part of the On-ramp (Buy) functionality, through which you can quickly convert one cryptocurrency to another with competitive rates!

The Convert capability is a branch of the On-ramp flow that allows users to exchange their existing cryptocurrency holdings directly without going through fiat currency. This is particularly useful for:

• Converting between different cryptocurrencies
• Portfolio rebalancing
• Taking advantage of market opportunities

As a partner (client), the conversion process is seamless and uses the same On-ramp APIs with specific parameters. There are no separate Convert APIs - it utilizes the existing On-ramp infrastructure.

Key Differences for Convert Operations

When using the On-ramp APIs for Convert operations, there are some key differences:

1. Fiat Fields

For Convert operations, the following fields will be empty since no fiat currency is involved:

• fiat - This field will be empty
• fiatAmount - This field will be 0

2. Additional Response Fields

The Get order detail API and webhook payload will include an additional object field when processing Convert orders:

For API responses:

{
  "convertInfo": {
    "fromCoin": "BTC",
    "fromCoinAmount": "0.01"
  }
}

For webhook payloads:

{
  "convertInfo": {
    "fromCoin": "BTC",
    "fromCoinAmount": "0.01"
  }
}

ConvertInfo Fields:

• fromCoin: The source cryptocurrency being converted from
• fromCoinAmount: The amount of source cryptocurrency being converted

3. Order Status Flow

Convert operations will use the following order statuses:

• CONVERT_PROCESSING (3): In the process of converting crypto
• CONVERT_COMPLETED (4): Successfully converted crypto. The converted crypto is in the user's Binance wallet, but the withdrawal has not been initiated yet

For detailed order status information, refer to Order Status.