Trabaja con varias monedas

Stripe admite el procesamiento de pagos en más de 135 monedas. Esto te permite presentar los precios en la moneda local del cliente y evitarle costos de conversión. El uso de la moneda de pago local también puede mejorar la conversión de clientes y las tasas de autorización de pagos.

La conversión de monedas (FX) puede ocurrir en pagos, transferencias, envíos de fondos, comisiones de la plataforma y otros tipos de transacciones. La conversión de monedas ocurre cuando la moneda inicial de un flujo de fondos es diferente de la moneda de destino. Por ejemplo, la conversión de moneda en un pago se produce cuando la moneda de pago difiere de la moneda de cobro. En las transferencias, la conversión de moneda se produce cuando el saldo de la plataforma que envía la transferencia está en una moneda diferente del saldo de la cuenta conectada que la recibe.

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 un presupuesto de cambio de moneda al crear un 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 Payment Intent. Especifica la moneda del cliente final como el parámetro 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-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 sin on_behalf_of. Al crear un cargo, especifica el ID de cotización de divisas en el Payment Intent. En el ejemplo anterior, esto te da certeza sobre la tasa de cambio utilizada para la conversión de EUR (moneda del cliente final) a USD (moneda de la plataforma). En los presupuestos de cambio de moneda, especifica la moneda del cliente final como el parámetro from_currency. Especifica la moneda de cobro predeterminada de tu plataforma como el valor to_currency. No puedes usar presupuestos de cambio de moneda para ninguna conversión que ocurra en la transferencia desde la plataforma a la cuenta conectada, ni para 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
:" \
  -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}}

Las comisiones de la plataforma cobradas usando el parámetro application_fee_amount no se vuelven a convertir en el caso de cargos a un destino. Las plataformas siempre reciben sus comisiones 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 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 con on_behalf_of. Al crear un cargo, especifica el ID de la cotización de divisas en el Payment Intent. En el ejemplo anterior, esto te da certeza sobre la tasa de cambio utilizada para la conversión de USD (moneda del cliente final) a EUR (moneda de la cuenta conectada). En los presupuestos de cambio de moneda, especifica la moneda del cliente final como el valor 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
:" \
  -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}}

Las comisiones de la plataforma cobradas usando el parámetro application_fee_amount no se vuelven a convertir en el caso de cargos a un destino. Las plataformas siempre reciben sus comisiones 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

Siempre que haya fondos suficientes en el saldo en 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 monedas de USD a GBP se produce como parte del tramo 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 transferencias separados sin on_behalf_of. Esto se aplica tanto en el tramo del cargo como en el tramo de los envíos de fondos independientes.

Presupuesto para el cambio de moneda correspondiente al pago

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
:" \
  -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 el ID de cotización de divisas en el Payment Intent. En el ejemplo anterior, esto te da certeza sobre la tasa de cambio utilizada para la conversión de USD (moneda del cliente final) a GBP (moneda de la plataforma Connect). En los presupuestos de cambio de moneda, especifica la moneda del cliente final como el valor from_currency. Especifica la moneda de cobro predeterminada de tu plataforma como el valor to_currency.

Al crear una transferencia, especifica el ID de cotización de divisas en la transferencia. 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 valor 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 de la plataforma es GBP. La conversión de monedas de USD a GBP se produce como parte del tramo 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 extendidas de la API FX Quotes para reducir la incertidumbre sobre el tipo de cambio cuando uses cargos y transferencias separados con on_behalf_of. Esto se aplica tanto en el tramo del cargo como en el tramo de los envíos de fondos independientes.

Presupuesto para el cambio de moneda correspondiente al tramo de cobro

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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}}

Presupuesto para el cambio de moneda correspondiente al tramo de envío de fondos

curl https://api.stripe.com/v1/fx_quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 el ID de cotización de divisas en el Payment Intent. En el ejemplo anterior, esto te da certeza sobre la tasa de cambio utilizada para la conversión de USD (moneda del cliente final) a GBP (moneda de la plataforma Connect). En los presupuestos de cambio de moneda, especifica la moneda del cliente final como el valor from_currency. Especifica la moneda de cobro predeterminada de tu plataforma como el valor to_currency.

Al crear una transferencia, especifica el ID de cotización de divisas en la transferencia. 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.

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: