Moneda Adaptativa

Adaptive Currency muestra los precios de los productos en la moneda local del cliente en lugar de mostrarlos únicamente en tu moneda base. Cuando está habilitado, el checkout usa de forma predeterminada la moneda local detectada para los países compatibles, con la opción de volver a tu moneda base.

Cómo funciona

Tu moneda base es aquella en la que estableciste el precio del producto o complemento; puede ser cualquier moneda que Dodo Payments pueda cobrar, no solo USD. Adaptive Currency convierte ese precio base según los tipos de cambio actuales. Para establecer tu propio precio fijo por moneda o país, consulta Precios localizados.

Beneficios principales

Checkout localizado — Los precios aparecen de forma predeterminada en la moneda local del cliente
Más métodos de pago — Desbloquea métodos de pago disponibles únicamente para la moneda local
Reembolsos en la misma moneda — Reembolsa al cliente en la moneda con la que pagó
Precios avanzados — Habilita la Paridad del poder adquisitivo y los Precios psicológicos para optimizar automáticamente los precios según el mercado

Habilitar Adaptive Currency

Open Settings

Inicia sesión en tu Merchant Dashboard y ve a Settings → Business.

Enable Adaptive Currency

Activa Adaptive Currency. Puedes deshabilitarlo en cualquier momento.

Los cambios se aplican únicamente a transacciones futuras.

Save and Test

Guarda la configuración y verifica que un checkout de prueba muestre los precios en tu moneda local cuando sea compatible.

Experiencia del cliente

Cuando Adaptive Currency está habilitado:

Detección — El sistema detecta el país del cliente según su dirección de facturación
Selección de moneda — Si el país es compatible, los precios se muestran de forma predeterminada en la moneda local. Los clientes pueden volver a tu moneda base
Métodos de pago — Los métodos de pago localizados aparecen cuando corresponde
Checkout — El pago se completa en la moneda seleccionada

Conversión y comisiones

Adaptive Currency cobra al cliente en su moneda local utilizando los tipos de cambio actuales. Las comisiones se establecen por niveles según el valor del pedido:

4 % para pedidos inferiores a $500
3 % para pedidos de $500 a $1,500
2 % para pedidos superiores a $1,500

De forma predeterminada, estas comisiones se añaden al precio mostrado y las asume el cliente. Con la configuración Fees Inclusive, puedes asumir la comisión: el cliente ve el mismo precio en moneda local y la comisión se deduce de tu liquidación.

Habilitar Fees Inclusive

Open Settings

Ve a Settings → Business y habilita Adaptive Currency si aún no lo has hecho.

Enable Fees Inclusive

Una vez activado Adaptive Currency, habilita el interruptor Fees Inclusive en la misma sección.

Modo	Lo que ve el cliente	Lo que liquida el comerciante
Exclusivo (predeterminado)	Precio local + comisión del 2–4 % adicional	Precio base completo
Inclusivo	Precio local (sin cambios)	Precio base menos la comisión del 2–4 %

Anular por solicitud

Puedes anular el valor predeterminado del comerciante por solicitud pasando adaptive_currency_fees_inclusive (boolean) en un pago único, una suscripción bajo demanda (on_demand.adaptive_currency_fees_inclusive), un cargo de suscripción o un cambio de plan. En las sesiones de checkout, solo se acepta para suscripciones bajo demanda, como subscription_data.on_demand.adaptive_currency_fees_inclusive, y no en el nivel superior de la solicitud:

// Note: POST /payments is deprecated. Checkout sessions don't accept
// `adaptive_currency_fees_inclusive` for one-time payments, so this override
// still runs through the one-time payment route.
const payment = await client.payments.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  billing: { country: 'US' },
  adaptive_currency_fees_inclusive: true, // override the business setting for this payment
  return_url: 'https://yoursite.com/return'
});

Las transacciones INR → INR siempre se tratan como inclusivas, independientemente de la configuración de la empresa o de la anulación por solicitud.

Cuando coincide una regla de Precios localizados, la transacción siempre se trata como inclusiva, independientemente de tu configuración Fees Inclusive o de cualquier anulación por solicitud. El cliente paga exactamente el importe localizado que estableciste y la comisión de conversión se deduce de tu liquidación.

Monedas compatibles

Código de moneda	Nombre de la moneda	Países	Importe mínimo
AED	Dírham de los EAU	Emiratos Árabes Unidos	2.00 AED
ALL	Lek albanés	Albania	50.00 ALL
AMD	Dram armenio	Armenia	500.00 AMD
AUD	Dólar australiano	Australia, Nauru	0.50 AUD
AWG	Florín arubeño	Aruba	2.00 AWG
AZN	Manat azerbaiyano	Azerbaiyán	2.00 AZN
BAM	Marco convertible de Bosnia-Herzegovina	Bosnia y Herzegovina	2.00 BAM
BDT	Taka bangladesí	Bangladés	100.00 BDT
BMD	Dólar bermudeño	Bermudas	1.00 BMD
BND	Dólar de Brunéi	Brunéi	1.00 BND
BOB	Boliviano	Bolivia	5.00 BOB
BRL	Real brasileño	Brasil	0.50 BRL
BSD	Dólar bahameño	Bahamas	1.00 BSD
BWP	Pula botsuanés	Botsuana	15.00 BWP
BZD	Dólar beliceño	Belice	2.00 BZD
CAD	Dólar canadiense	Canadá	0.50 CAD
CHF	Franco suizo	Suiza, Liechtenstein	0.50 CHF
CLP	Peso chileno	Chile	1000.00 CLP
CNY	Yuan chino	China	4.00 CNY
CRC	Colón costarricense	Costa Rica	500.00 CRC
CZK	Corona checa	República Checa	15.00 CZK
DKK	Corona danesa	Dinamarca, Groenlandia	2.50 DKK
DOP	Peso dominicano	República Dominicana	100.00 DOP
EGP	Libra egipcia	Egipto	50.00 EGP
ETB	Birr etíope	Etiopía	100.00 ETB
EUR	Euro	Austria, Bélgica, Chipre, Estonia, Finlandia, Francia, Alemania, Grecia, Irlanda, Italia, Letonia, Lituania, Luxemburgo, Malta, Países Bajos, Portugal, Eslovaquia, Eslovenia, España, Andorra, Mónaco, Croacia, San Marino, Montenegro	0.50 EUR
FJD	Dólar fiyiano	Fiyi	2.00 FJD
GBP	Libra esterlina	Reino Unido	0.30 GBP
GEL	Lari georgiano	Georgia	3.00 GEL
GMD	Dalasi gambiano	Gambia	100.00 GMD
GTQ	Quetzal guatemalteco	Guatemala	10.00 GTQ
GYD	Dólar guyanés	Guyana	200.00 GYD
HKD	Dólar de Hong Kong	Hong Kong	4.00 HKD
HNL	Lempira hondureño	Honduras	25.00 HNL
HUF	Forinto húngaro	Hungría	175.00 HUF
IDR	Rupia indonesia	Indonesia	8500.00 IDR
ILS	Nuevo séquel israelí	Israel	3.00 ILS
INR	Rupia india	India	5.00 INR
JPY	Yen japonés	Japón	50 JPY
KRW	Won surcoreano	Corea del Sur	50 KRW
KZT	Tenge kazajo	Kazajistán	500.00 KZT
LKR	Rupia de Sri Lanka	Sri Lanka	300.00 LKR
LRD	Dólar liberiano	Liberia	200.00 LRD
LSL	Loti lesotense	Lesoto	20.00 LSL
MAD	Dírham marroquí	Marruecos	10.00 MAD
MKD	Denar macedonio	Macedonia del Norte	50.00 MKD
MOP	Pataca macaense	Macao	10.00 MOP
MUR	Rupia mauriciana	Mauricio	50.00 MUR
MVR	Rufiya maldiva	Maldivas	15.00 MVR
MWK	Kwacha malauí	Malaui	2000.00 MWK
MXN	Peso mexicano	México	10.00 MXN
MYR	Ringgit malasio	Malasia	4.00 MYR
NGN	Naira nigeriana	Nigeria	2000.00 NGN
NOK	Corona noruega	Noruega	3.00 NOK
NPR	Rupia nepalesa	Nepal	150.00 NPR
NZD	Dólar neozelandés	Nueva Zelanda	1.00 NZD
PEN	Sol peruano	Perú	3.00 PEN
PGK	Kina de Papúa Nueva Guinea	Papúa Nueva Guinea	4.00 PGK
PHP	Peso filipino	Filipinas	50.00 PHP
PLN	Złoty polaco	Polonia	2.00 PLN
PYG	Guaraní paraguayo	Paraguay	4000 PYG
QAR	Rial catarí	Catar	3.00 QAR
RON	Leu rumano	Rumanía	2.00 RON
RSD	Dinar serbio	Serbia	60.00 RSD
SAR	Riyal saudí	Arabia Saudita	2.00 SAR
SBD	Dólar de las Islas Salomón	Islas Salomón	10.00 SBD
SCR	Rupia seychellense	Seychelles	15.00 SCR
SEK	Corona sueca	Suecia	3.00 SEK
SGD	Dólar singapurense	Singapur	0.50 SGD
SZL	Lilangeni suazi	Esuatini	20.00 SZL
THB	Baht tailandés	Tailandia	25.00 THB
TOP	Paʻanga tongano	Tonga	2.00 TOP
TRY	Lira turca	Turquía	20.00 TRY
TWD	Nuevo dólar taiwanés	Taiwán	20.00 TWD
TZS	Chelín tanzano	Tanzania	3000.00 TZS
UYU	Peso uruguayo	Uruguay	50.00 UYU
VND	Dong vietnamita	Vietnam	12000 VND
WST	Tala samoano	Samoa	2.00 WST
XAF	Franco CFA de África Central	Camerún, República Centroafricana, Chad, República del Congo, Guinea Ecuatorial, Gabón	300 XAF
XOF	Franco CFA de África Occidental	Benín, Burkina Faso, Costa de Marfil, Guinea-Bisáu, Malí, Níger, Senegal, Togo	300 XOF
ZAR	Rand sudafricano	Sudáfrica	20.00 ZAR
ZMW	Kwacha zambiano	Zambia	30.00 ZMW

Reembolsos y ajustes

Dodo Payments emite los reembolsos en la moneda con la que pagó originalmente el cliente, utilizando el tipo de cambio más reciente. El importe en tu moneda base permanece fijo en tu dashboard, las facturas y el reembolso. El cliente puede recibir más o menos que el importe original en moneda local según las variaciones del tipo de cambio.

Las comisiones de Adaptive Currency (comisiones de FX) no se reembolsan.

Ejemplo de reembolso

Vendes un producto por 100 USD con Adaptive Currency habilitado
Un cliente canadiense ve 137 CAD a un tipo de cambio de 1.37 CAD por 1 USD y completa la compra
Dodo Payments procesa el pago y convierte 137 CAD a 100 USD para tu liquidación
Más tarde, el tipo de cambio cambia a 1.40 CAD por 1 USD y emites un reembolso completo
Dodo Payments deduce 100 USD y reembolsa al cliente 140 CAD

Facturas e impuestos

Las facturas muestran únicamente el importe en la moneda de liquidación
Los impuestos y las comisiones de la plataforma se calculan sobre el importe en la moneda de liquidación
Ejemplo: una venta de $10 convertida a 36 AED sigue reflejándose como $10 en el Dashboard y en las facturas

Todos los importes se redondean según la lógica de redondeo interna de Dodo Payments.

Establecer la moneda de facturación por checkout

Pasa billing_currency para establecer explícitamente la moneda de facturación de una sesión de checkout:

Cuando Adaptive Currency está deshabilitado, billing_currency se ignora.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_one_time_or_subscription',
      quantity: 1
    }
  ],
  billing_currency: 'AED',
  return_url: 'https://example.com/return'
});

Páginas relacionadas

Purchasing Power Parity

Reduce los precios automáticamente según el país. Requiere Adaptive Currency.

Charm Pricing

Redondea los precios convertidos a terminaciones sencillas como 49.99. Requiere Adaptive Currency.

Localized Pricing

Establece un precio exacto por país o moneda en lugar de utilizar la conversión automática.

Tax-Inclusive Pricing

Controla si tus precios incluyen impuestos.

Checkout Session

Crea sesiones de checkout con la configuración de la moneda de facturación.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Cómo funciona

Beneficios principales

Habilitar Adaptive Currency

Experiencia del cliente

Conversión y comisiones

Habilitar Fees Inclusive

Anular por solicitud

Monedas compatibles

Reembolsos y ajustes

Ejemplo de reembolso

Facturas e impuestos

Establecer la moneda de facturación por checkout

Páginas relacionadas

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

​Cómo funciona

​Beneficios principales

​Habilitar Adaptive Currency

​Experiencia del cliente

​Conversión y comisiones

​Habilitar Fees Inclusive

​Anular por solicitud

​Monedas compatibles

​Reembolsos y ajustes

​Ejemplo de reembolso

​Facturas e impuestos

​Establecer la moneda de facturación por checkout

​Páginas relacionadas

Purchasing Power Parity

Charm Pricing

Localized Pricing

Tax-Inclusive Pricing

Checkout Session

Cómo funciona

Beneficios principales

Habilitar Adaptive Currency

Experiencia del cliente

Conversión y comisiones

Habilitar Fees Inclusive

Anular por solicitud

Monedas compatibles

Reembolsos y ajustes

Ejemplo de reembolso

Facturas e impuestos

Establecer la moneda de facturación por checkout

Páginas relacionadas