Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

Adaptive Currency te permite mostrar precios localizados y aceptar pagos en las monedas locales de los clientes. Esto reduce la fricción en el momento del pago y genera confianza.

¿Qué es la Moneda Adaptativa?

La Moneda Adaptativa muestra los precios de los productos en la moneda local del cliente en lugar de una moneda global fija (por ejemplo, USD). Cuando está habilitada, el proceso de pago se establece por defecto en la moneda local detectada para los países soportados, con la opción de cambiar a USD.

Beneficios Clave

  • Experiencia de pago localizada: Los precios aparecen en la moneda local por defecto.
  • Más métodos de pago: Desbloquea métodos de pago disponibles para la moneda local.
  • Reembolsos en la misma moneda: Reembolsa al cliente en la moneda con la que pagó.

Habilitar la Moneda Adaptativa

1

Open Settings

Inicia sesión en tu Panel de Control del Comerciante y ve a Configuración → Negocio.
2

Toggle Adaptive Pricing

Activa el interruptor Adaptive Pricing. Puedes desactivarlo en cualquier momento.
Los cambios se aplican solo a transacciones futuras.
3

Confirm and Save

Guarda tu configuración.
Verifica que un pago de prueba muestre los precios en tu moneda local cuando esté disponible.
Moneda Adaptativa

Experiencia del Cliente

  1. Detección: El sistema detecta el país del cliente basado en la dirección de facturación.
  2. Selección de moneda: Si el país es soportado, los precios se muestran en la moneda local por defecto. Los clientes pueden cambiar a USD.
  3. Métodos de pago: Los métodos de pago localizados aparecen donde sea aplicable.
  4. Pago: El pago se completa en la moneda seleccionada.

Conversión y Tarifas

La Moneda Adaptativa cobra al cliente en su moneda local utilizando las últimas tasas de cambio.
  • Usted paga: 0 % (por defecto) o 2–4 % (cuando las tasas están incluidas)
  • Sus clientes pagan: 2–4 % basado en el valor del pedido (por defecto) o 0 % (cuando las tasas están incluidas)
Tarifas escalonadas aplicadas en el proceso de pago:
  • 4% para pedidos inferiores a $500
  • 3% para pedidos de 500a500 a 1,500
  • 2% para pedidos superiores a $1,500

Elija quién asume la tasa

Por defecto, las tasas de moneda adaptativa se añaden además del precio mostrado y son asumidas por el cliente. Con la configuración de Tasas Incluidas, puede absorber la tasa usted mismo: el cliente ve el mismo precio en moneda local que vería siempre, y la tasa se deduce de su liquidación.
1

Enable Adaptive Pricing

Vaya a Configuración → Negocio y active el interruptor de Precios Adaptativos si aún no lo ha hecho.
2

Toggle Fees Inclusive

Una vez que los Precios Adaptativos están activados, habilite el sub-interruptor de Tasas Incluidas en la misma sección.
ModoCliente veComerciante liquida
Exclusivo (por defecto)Precio local + 2–4 % de tasa adicionalPrecio base completo
InclusivoPrecio local (sin cambios)Precio base menos la tasa de 2–4 %
También puede anular el valor predeterminado del comerciante por solicitud pasando adaptive_currency_fees_inclusive (booleano) en una sesión de pago, pago o suscripción bajo demanda:
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  adaptive_currency_fees_inclusive: true, // override the business setting for this session
  return_url: 'https://yoursite.com/return'
});
Las transacciones INR → INR siempre se tratan como incluidas independientemente de la configuración de negocio o anulación por solicitud.

Monedas Soportadas

Código de MonedaNombre de la MonedaPaísesMonto Mínimo
AEDDirham de los EAUEmiratos Árabes Unidos2.00 AED
ALLLek AlbanésAlbania50.00 ALL
AMDDram ArmenioArmenia500.00 AMD
ARSPeso ArgentinoArgentina1000.00 ARS
AUDDólar AustralianoAustralia, Nauru0.50 AUD
AWGFlorín ArubanoAruba2.00 AWG
AZNManat AzerbaiyanoAzerbaiyán2.00 AZN
BAMMarco Convertible de Bosnia-HerzegovinaBosnia y Herzegovina2.00 BAM
BDTTaka BangladesíBangladesh100.00 BDT
BMDDólar BermudeñoBermudas1.00 BMD
BNDDólar de BrunéiBrunéi1.00 BND
BOBBolivianoBolivia5.00 BOB
BRLReal BrasileñoBrasil0.50 BRL
BSDDólar BahameñoBahamas1.00 BSD
BWPPula de BotsuanaBotsuana15.00 BWP
BZDDólar BeliceñoBelice2.00 BZD
CADDólar CanadienseCanadá0.50 CAD
CHFFranco SuizoSuiza, Liechtenstein0.50 CHF
CLPPeso ChilenoChile1000.00 CLP
CNYYuan ChinoChina4.00 CNY
CRCColón CostarricenseCosta Rica500.00 CRC
CZKCorona ChecaRepública Checa15.00 CZK
DKKCorona DanesaDinamarca, Groenlandia2.50 DKK
DOPPeso DominicanoRepública Dominicana100.00 DOP
EGPLibra EgipciaEgipto50.00 EGP
ETBBirr EtíopeEtiopía100.00 ETB
EUREuroAustria, Bélgica, Chipre, Estonia, Finlandia, Francia, Alemania, Grecia, Irlanda, Italia, Letonia, Lituania, Luxemburgo, Malta, Países Bajos, Portugal, Eslovaquia, Eslovenia, España, Andorra, San Marino, Montenegro0.50 EUR
FJDDólar FiyianoFiyi2.00 FJD
GBPLibra EsterlinaReino Unido0.30 GBP
GELLari GeorgianoGeorgia3.00 GEL
GMDDalasi GambianoGambia100.00 GMD
GTQQuetzal GuatemaltecoGuatemala10.00 GTQ
GYDDólar GuyanésGuyana200.00 GYD
HKDDólar de Hong KongHong Kong4.00 HKD
HNLLempira HondureñaHonduras25.00 HNL
HUFFlorín HúngaroHungría175.00 HUF
IDRRupia IndonesiaIndonesia8500.00 IDR
ILSNuevo Shéquel IsraelíIsrael3.00 ILS
INRRupia IndiaIndia5.00 INR
KZTTenge KazajoKazajistán500.00 KZT
LKRRupia de Sri LankaSri Lanka300.00 LKR
LRDDólar LiberianoLiberia200.00 LRD
LSLLoti de LesotoLesoto20.00 LSL
MADDírham MarroquíMarruecos10.00 MAD
MKDDenar MacedonioMacedonia del Norte50.00 MKD
MOPPataca MacanesaMacao10.00 MOP
MURRupia MauricianaMauricio50.00 MUR
MVRRufiyaa MaldivaMaldivas15.00 MVR
MWKKwacha MalauíMalaui2000.00 MWK
MXNPeso MexicanoMéxico10.00 MXN
MYRRinggit MalayoMalasia4.00 MYR
NGNNaira NigerianaNigeria2000.00 NGN
NOKCorona NoruegaNoruega3.00 NOK
NPRRupia NepalíNepal150.00 NPR
NZDDólar NeozelandésNueva Zelanda1.00 NZD
PENSol PeruanoPerú3.00 PEN
PGKKina de Papúa Nueva GuineaPapúa Nueva Guinea4.00 PGK
PHPPeso FilipinoFilipinas50.00 PHP
PLNZloty PolacoPolonia2.00 PLN
QARRial QataríCatar3.00 QAR
RONLeu RumanoRumanía2.00 RON
RSDDinar SerbioSerbia60.00 RSD
SARRiyal SaudíArabia Saudita2.00 SAR
SBDDólar de las Islas SalomónIslas Salomón10.00 SBD
SCRRupia de SeychellesSeychelles15.00 SCR
SEKCorona SuecaSuecia3.00 SEK
SGDDólar de SingapurSingapur0.50 SGD
SZLLilangeni SuaziEswatini20.00 SZL
THBBaht TailandésTailandia25.00 THB
TOPPaʻanga TonganoTonga2.00 TOP
TRYLira TurcaTurquía20.00 TRY
TWDNuevo Dólar de TaiwánTaiwán20.00 TWD
TZSChelín TanzanoTanzania3000.00 TZS
UYUPeso UruguayoUruguay50.00 UYU
WSTTala SamoanaSamoa2.00 WST
ZARRand SudafricanoSudáfrica20.00 ZAR
ZMWKwacha ZambianoZambia30.00 ZMW

Reembolsos y Ajustes

Dodo Payments emite reembolsos en la moneda en la que el cliente pagó originalmente, usando el tipo de cambio más reciente. El monto global en USD permanece fijo en su panel de control, facturas y en el reembolso. Esto significa que el cliente puede recibir más o menos que el monto original en moneda local dependiendo de los cambios de FX.
Las tasas de Moneda Adaptativa, que generalmente son las tasas de FX, no se reembolsan.
Ejemplo de reembolso
  1. Vende un producto por 100 USD con Moneda Adaptativa habilitada.
  2. Un cliente canadiense ve 137 CAD a un tipo de cambio de 1.37 CAD por 1 USD y completa la compra.
  3. Procesamos el pago, convirtiendo 137 CAD a 100 USD para su liquidación.
  4. Más tarde, el tipo de cambio cambia a 1.40 CAD por 1 USD y emite un reembolso completo.
  5. Deducimos 100 USD y reembolsamos al cliente 140 CAD.

Facturas e Impuestos

  • Las facturas muestran solo el monto de la moneda de liquidación.
  • Los impuestos y las tarifas de la plataforma se calculan sobre el monto de la moneda de liquidación.
  • Ejemplo: una venta de $10 convertida a 36 AED aún se refleja como $10 en el Panel de control y facturas.
Todos los montos se redondean de acuerdo con la lógica de redondeo interna de Dodo Payments.

Ejemplos de Integración

Sesiones de Checkout con moneda de facturación Pase billing_currency para establecer explícitamente la moneda de facturación para la sesión.
Cuando los Precios Adaptativos están deshabilitados, billing_currency se ignora.
const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_one_time_or_subscription',
      quantity: 1
    }
  ],
  billing_currency: 'AED',
  return_url: 'https://example.com/return'
});

Checkout Session

Configure la Moneda de Facturación usando nuestra API de Sesión de Checkout.
Last modified on May 14, 2026