Balance Exchange Request

Use this interface for initiating exchange requests between account balances

Typical scenarios:

  • For payin business, the merchant needs to switch the settlement currency.
  • For payout business, the merchant needs to convert to the originating currency as the available balance for remittance when the local currency balance is insufficient.

Typical applications:

  • Converting 10.00 CNY to the corresponding USD

    Parameters: currency_buy: USD, currency_sell: CNY, amount_sell: 10.00

  • Convert CNY balance to 10.00 USD

    Parameters: currency_buy: USD, currency_sell: CNY, amount_buy: 10.00

Description of returned parameters

  • status: pending (when requested), succeeded (when accepted)
  • fx_converted: currency_sell / currency_buy
    • For accounts of type payin: apply currency conversion fee rate for payout.
    • For accounts of type payout: apply currency conversion fee rate for payout.
  • time_expired: defaults to 23:59:59 on the day of expiration.
Language
Click Try It! to start a request and see the response here!