Usa la API FX Quotes en Connect

Usa la API FX Quotes para localizar los precios en las monedas de tus clientes y reducir la incertidumbre en torno a las modificaciones en las tasas de cambio. Puedes especificar una cotización de divisas al crear una PaymentIntent con la moneda de pago de tu cliente. También puedes definir un presupuesto de cambio de moneda al crear una transferencia para confirmar el importe de acreditación de fondos en la cuenta conectada. Para obtener más información, consulta Presupuestos de cambio de moneda.

Ejemplos de cambio de moneda

En los diferentes tipos de cargos de Connect, el cambio de moneda se produce de las siguientes maneras.

Cargos Direct

Los cargos Direct siempre se convierten de la moneda de pago a la moneda predeterminada de la cuenta conectada. La comisión de la plataforma se convierte a la moneda predeterminada de la plataforma.

Por ejemplo, supongamos que aceptas un cargo en USD para una cuenta conectada. La cuenta conectada recibe los fondos en EUR. Los fondos enviados a la cuenta conectada se convierten a EUR, y la comisión de la plataforma vuelve a convertirse de EUR a USD en tu plataforma.

Puedes usar las cotizaciones de tasas ampliadas de la API FX Quotes para reducir la incertidumbre sobre el tipo de cambio en los cargos directos. Al crear un cargo Direct, especifica el ID de la cotización de divisas en el PaymentIntent. Especifica la moneda del cliente final como from_currency. Especifica la moneda de cobro predeterminada de tu cuenta conectada como el valor to_currency.

Crea un presupuesto de cambio de moneda

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d "from_currencies[]"=eur \
  -d lock_duration=hour \
  -d "usage[type]"=payment

Si bien los cargos Direct se expresan en la moneda predeterminada de la cuenta conectada, tu plataforma recibe las comisiones de la aplicación por cargos Direct en la moneda predeterminada de tu plataforma. El uso de presupuestos ampliados de tasa en cargos directos en la API FX Quotes no afecta la tasa de cambio de moneda a la que se convierten las comisiones de la plataforma.

Si tu plataforma no utiliza las comisiones de la plataforma y, en cambio, retiene una parte de los cargos, esos fondos se pagan de la misma manera que otros cargos en la cuenta de la plataforma.

Cargos a un destino sin on_behalf_of

Al procesar cargos a un destino sin el parámetro on_behalf_of, Stripe primero los convierte de la moneda de pago a la moneda predeterminada de la plataforma. Los fondos enviados a la cuenta conectada se convierten a la moneda predeterminada de la cuenta conectada.

• Si usas el parámetro application_fee_amount, la comisión de la plataforma se cobra después de la conversión a la moneda predeterminada de la cuenta conectada. La comisión permanece en esa moneda cuando se agrega a la plataforma.
• Si usas el parámetro transfer_data[amount], la comisión se cobra después de la primera conversión de moneda y permanece en la moneda predeterminada de la plataforma.

Por ejemplo, supongamos que aceptas un cargo a un destino para una cuenta conectada en EUR. La cuenta conectada cobra en GBP, y tu plataforma lo hace en USD. El cargo se convierte de EUR a USD, y los fondos enviados a la cuenta conectada se convierten a GBP.

• Si se usas el parámetro application_fee_amount, el importe de la comisión de la plataforma se convierte de EUR a GBP y se toma del importe que se cobra en la cuenta conectada.
• Si usas transfer_data[amount], la comisión se retiene en USD después de convertirla desde la moneda de pago inicial.

Puedes utilizar las cotizaciones de tasas ampliadas de la API FX Quotes para reducir la incertidumbre sobre el tipo de cambio en los cargos a un destino sinon_behalf_of. Al crear un cargo, especifica la ID de cotización de divisas en el PaymentIntent. En el ejemplo anterior, esto te brinda certeza sobre el tipo de cambio utilizado para la conversión de EUR (la moneda del cliente final) a USD (la moneda de la plataforma). En las cotizaciones de divisas, especifica la moneda del cliente final como from_currency. Especifica la moneda de cobro predeterminada de tu plataforma como el valor to_currency. No puedes utilizar las cotizaciones de divisas para ninguna conversión que se produzca en la transferencia de la plataforma a la cuenta conectada, ni en ninguna conversión de las comisiones de la plataforma.

Cómo crear un presupuesto de cambio de moneda

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d "from_currencies[]"=eur \
  -d lock_duration=hour \
  -d "usage[type]"=payment \
  -d "usage[payment][destination]"=
{{CONNECTED_ACCOUNT_ID}}

No volvemos a convertir las comisiones de la aplicación cobradas usando el parámetro application_fee_amount para cargos a un destino. Las plataformas siempre reciben las comisiones de la aplicación en la moneda de cobro de la cuenta conectada. Utiliza el parámetro transfer_data[amount] para transferir menos del importe de la transacción y cobrar comisiones en la moneda de cobro predeterminada de la plataforma.

Cargos a un destino con on_behalf_of

Al procesar cargos a un destino con el parámetro on_behalf_of, Stripe primero los convierte de la moneda de pago a la moneda predeterminada de la cuenta conectada. La comisión de la plataforma permanece en la moneda de la cuenta conectada, independientemente de si usas los parámetros application_fee_amount o transfer_data[amount].

Por ejemplo, la cuenta conectada acepta un cargo en USD, pero cobra en EUR. El cargo se convierte a EUR y se envía a la cuenta conectada en EUR. Cobramos la comisión en EUR, independientemente de si usas los parámetros application_fee_amount o transfer_data[amount].

Puedes usar cotizaciones de tasas ampliadas de la API FX Quotes para reducir la incertidumbre de las cotizaciones de divisas en los cargos a un destino con on_behalf_of. Al crear un cargo, especifica la ID de la cotización de divisas en el PaymentIntent. En el ejemplo anterior, esto te da la certeza del tipo de cambio utilizado para la conversión de USD (la moneda del cliente final) a EUR (la moneda de la cuenta conectada). En las cotizaciones de divisas, especifica la moneda del cliente final como from_currency. Especifica la moneda de cobro predeterminada de tu cuenta conectada como el valor to_currency.

Cómo crear un presupuesto de cambio de moneda

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d "from_currencies[]"=eur \
  -d lock_duration=hour \
  -d "usage[type]"=payment \
  -d "usage[payment][on_behalf_of]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "usage[payment][destination]"=
{{CONNECTED_ACCOUNT_ID}}

No volvemos a convertir las comisiones de la aplicación cobradas usando el parámetro application_fee_amount para cargos a un destino. Las plataformas siempre reciben las comisiones de la aplicación en la moneda de cobro de la cuenta conectada. Utiliza el parámetro transfer_data[amount] para transferir menos del importe de la transacción y cobrar comisiones en la moneda de cobro predeterminada de la plataforma.

Si creas cargos en la plataforma con los parámetros destination o on_behalf_of, es posible acumular saldos en varias monedas. Si no tienes cuentas bancarias para estas otras monedas, Stripe te ofrece una forma de transferir los saldos a la cuenta bancaria predeterminada de tu plataforma en monedas no predeterminadas.

Stripe convierte las monedas, y estas se representan como transferencias manuales con el valor currency definido como la moneda del saldo de origen:

curl https://api.stripe.com/v1/payouts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=xaf

Si hay fondos suficientes en el saldo para la moneda especificada, Stripe convierte automáticamente los fondos a la moneda de la cuenta bancaria predeterminada. No admitimos el uso de presupuestos de cambio de moneda en las transferencias.

Cargos y envíos de fondos separados sin on_behalf_of

Los cargos separados se convierten de la moneda de pago a la moneda predeterminada de la plataforma y, luego, la plataforma transfiere los fondos a la cuenta conectada. Los parámetros application_fee_amount y transfer_data[amount] no se utilizan para cobrar comisiones, ya que la plataforma puede elegir el importe correcto que debe enviarse en el momento de la transferencia.

Tomemos como ejemplo un cargo en USD. La moneda predeterminada de la cuenta de la plataforma es GBP. La conversión de moneda de USD a GBP se produce como parte del cargo. Cuando la plataforma transfiere estos fondos a una cuenta conectada que tiene EUR como moneda predeterminada, se produce otra conversión de moneda, esta vez de GBP a EUR.

Puedes utilizar cotizaciones de tasas ampliadas de la API FX Quotes para reducir la incertidumbre sobre el tipo de cambio cuando uses cargos y envíos de fondos separados sin on_behalf_of. Esto se aplica tanto al cargo como a la transferencia independiente.

Presupuesto para el cambio de moneda correspondiente al pago

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d "from_currencies[]"=cad \
  -d lock_duration=hour \
  -d "usage[type]"=payment

Presupuesto para el cambio de moneda correspondiente a la transferencia

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -d to_currency=eur \
  -d "from_currencies[]"=gbp \
  -d lock_duration=five_minutes \
  -d "usage[type]"=transfer \
  -d "usage[transfer][destination]"=
{{CONNECTED_ACCOUNT_ID}}

Al crear un cargo, especifica la ID de cotización de divisas en el PaymentIntent. En el ejemplo anterior, esto te da la certeza del tipo de cambio utilizado para la conversión de USD (la moneda del cliente final) a GBP (la moneda de la plataforma Connect). En las cotizaciones de divisas, especifica la moneda del cliente final como from_currency. Especifica la moneda de cobro predeterminada de tu plataforma como el valor to_currency.

Al crear un envío de fondos, especifica la ID de cotización de divisas en el envío de fondos. En el ejemplo anterior, esto te da certeza sobre la tasa de cambio utilizada para la conversión de GBP (moneda de la plataforma Connect) a EUR (moneda de la cuenta conectada). En los presupuestos de cambio de moneda, especifica la moneda de la plataforma Connect como el parámetro from_currency. Especifica la moneda predeterminada de tu cuenta conectada como el parámetro to_currency.

Cargos y envíos de fondos separados con on_behalf_of

Los cargos separados se convierten de la moneda de pago a la moneda predeterminada de la cuenta conectada y, luego, la plataforma transfiere los fondos a la cuenta conectada. Los parámetros application_fee_amount y transfer_data[amount] no se utilizan para cobrar comisiones, ya que la plataforma puede elegir el importe correcto que debe enviarse en el momento de la transferencia.

Tomemos como ejemplo un cargo en USD. La moneda predeterminada de la cuenta conectada es EUR. La conversión de moneda de USD a EUR se produce como parte del cargo. No hay conversión de moneda durante la transferencia porque los fondos ya están en la moneda de la cuenta conectada.

Puedes utilizar cotizaciones de tasas ampliadas de la API FX Quotes para reducir la incertidumbre de las cotizaciones de divisas cuando uses cargos y envíos de fondos separados con on_behalf_of.

Presupuesto para el cambio de moneda correspondiente al cargo

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-07-30.basil; fx_quote_preview=v1" \
  -d to_currency=gbp \
  -d "from_currencies[]"=usd \
  -d lock_duration=hour \
  -d "usage[type]"=payment \
  -d "usage[payment][on_behalf_of]"=
{{CONNECTED_ACCOUNT_ID}}

Cambio de moneda en los reembolsos

Cuando reembolsas un pago que originalmente se convirtió a otra moneda, usamos la tasa de cambio activa en el momento del reembolso. Esto aplica incluso si utilizaste presupuestos de cambio de moneda para fijar la tasa de cambio en el pago original. Stripe no cobra ninguna comisión por cambio de moneda en el reembolso. Stripe no reembolsa la comisión por cambio de moneda cobrada en la transacción original.

Cambio de moneda en las transferencias

La moneda de cobro es la moneda en la que puedes recibir transferencias. Consulta las monedas de cobro admitidas.

Según la disponibilidad de cuentas bancarias o tarjetas de débitos, esto es lo que sucede cuando se transfiere un saldo: