🤖 Explicar con IA

Pago en varias monedas: aceptación de pagos a nivel mundial¶

Descripción general¶

4Geeks Payments le permite aceptar pagos en múltiples monedas, brindando experiencias de pago localizadas para clientes de todo el mundo. Como su comerciante registrado, 4Geeks maneja automáticamente la conversión de moneda, el cumplimiento transfronterizo y los métodos de pago locales.

En este tutorial, podrás:

• Configurar monedas admitidas
• Configurar la conversión de moneda dinámica
• Implementar experiencias de pago localizadas
• Manejar suscripciones multidivisa
• Monitorear los tipos de cambio y las tarifas de conversión.

Monedas admitidas¶

4Geeks Payments admite más de 135 monedas. Los más utilizados incluyen:

Paso 1: Configurar las monedas admitidas¶

1. Inicie sesión en console.4geeks.io
2. Vaya a Pagos → Configuración → Monedas
3. Habilite las monedas que desea aceptar:
4. Activar/desactivar cada moneda
5. Establecer reglas de redondeo (por ejemplo, redondear al 0,99 más cercano)
6. Configurar el formato de visualización (posición del símbolo, decimales)

Configuración de visualización de moneda¶

Paso 2: Implementar la conversión dinámica de moneda¶

Uso de enlaces de pago¶

Los enlaces de pago detectan automáticamente la ubicación del cliente y muestran los precios en su moneda local:

const paymentLink = await axios.post('https://api.4geeks.io/v1/payment-links', {
  amount: 4900,           // Base amount in your default currency
  currency: 'USD',        // Base currency
  description: 'Pro Plan',
  customer_email: 'customer@example.com',
  auto_convert: true,     // Enable automatic currency conversion
  supported_currencies: ['USD', 'EUR', 'GBP', 'MXN', 'BRL'],
  success_url: 'https://yoursite.com/success',
  cancel_url: 'https://yoursite.com/cancel'
}, {
  headers: { 'Authorization': `Bearer ${SECRET_KEY}` }
});

// Customer sees the price in their local currency
// based on their location and browser settings

Usando API directa¶

Para realizar un pago personalizado, especifique la moneda preferida del cliente:

const charge = await axios.post('https://api.4geeks.io/v1/charges', {
  amount: 99000,          // Amount in the target currency's smallest unit
  currency: 'EUR',        // Customer's currency
  customer_id: 'cus_xxx',
  description: 'Annual Plan',
  metadata: {
    original_amount: 10800,  // Original USD amount
    original_currency: 'USD',
    exchange_rate: 0.917     // Rate at time of transaction
  }
}, {
  headers: { 'Authorization': `Bearer ${SECRET_KEY}` }
});

Paso 3: configurar el pago localizado¶

Detectar ubicación del cliente¶

// Option 1: Browser locale
const browserCurrency = navigator.language;
// 'en-US' → USD, 'es-MX' → MXN, 'de-DE' → EUR

// Option 2: IP geolocation (server-side)
const customerCountry = req.headers['cf-ipcountry']; // Cloudflare
// 'US' → USD, 'MX' → MXN, 'DE' → EUR

// Option 3: Customer preference (stored in profile)
const preferredCurrency = customer.preferences.currency;

Mostrar precios localizados¶

// Fetch real-time exchange rate
const rate = await getExchangeRate('USD', targetCurrency);

// Convert and format
const localAmount = Math.round(baseAmount * rate);
const formattedPrice = formatCurrency(localAmount, targetCurrency);
// "$49.00" → "€45.00" → "MX$980.00"

// Display on checkout page
document.getElementById('price').textContent = formattedPrice;

Métodos de pago locales¶

4Geeks Payments ofrece automáticamente métodos de pago relevantes según la moneda y la ubicación:

Paso 4: Manejar las suscripciones multidivisa¶

Creando un plan multidivisa¶

// Create plan with multiple currency prices
const plan = await axios.post('https://api.4geeks.io/v1/plans', {
  name: 'Pro Plan',
  currencies: {
    USD: { amount: 4900, display: '$49.00/month' },
    EUR: { amount: 4500, display: '€45.00/month' },
    GBP: { amount: 3900, display: '£39.00/month' },
    MXN: { amount: 98000, display: 'MX$980.00/month' },
    BRL: { amount: 24500, display: 'R$245.00/month' }
  },
  interval: 'month',
  trial_period_days: 14
}, {
  headers: { 'Authorization': `Bearer ${SECRET_KEY}` }
});

Bloqueo de moneda para suscripciones¶

Cuando un cliente se suscribe, su moneda se bloquea:

• La facturación continúa en la misma moneda durante la vigencia de la suscripción
• Las fluctuaciones del tipo de cambio no afectan el precio del cliente
• Cambios de plan (actualización/baja de categoría) utilizan la misma moneda
• El cliente puede solicitar cambio de moneda (requiere intervención de soporte)

Paso 5: Monitorear los tipos de cambio y la conversión¶

Panel de tipos de cambio¶

1. Vaya a Pagos → Análisis → Múltiples monedas
2. Ver:
3. Tipos de cambio actuales para todas las monedas habilitadas
4. Historial de tarifas a lo largo del tiempo
5. Volumen de conversión por moneda
6. Ingresos por moneda

Tarifas de conversión¶

Informes de ingresos¶

Ver los ingresos desglosados por:

• Moneda de transacción: Lo que pagó el cliente
• Moneda de liquidación: lo que recibió
• Impacto de la conversión: Ganancia/pérdida por movimientos del tipo de cambio

Mejores prácticas¶

Estrategia de precios¶

• Establezca precios locales competitivos: no se limite a realizar conversiones: investigue las tarifas del mercado local
• Usa precios psicológicos: \(49.99 → €44.99 → MX\)949
• Considere el poder adquisitivo: ajuste los precios para diferentes regiones
• Revisar precios trimestralmente: Los tipos de cambio y las condiciones del mercado cambian

Experiencia del cliente¶

• Mostrar precios en moneda local de forma predeterminada
• Mostrar la moneda original para mayor transparencia
• Explicar la conversión si la moneda de la tarjeta del cliente es diferente
• Oferta de selección de moneda en la página de pago

Gestión de riesgos¶

• Monitorear la volatilidad del tipo de cambio: las grandes oscilaciones pueden afectar los márgenes
• Establezca montos mínimos de transacción por moneda para evitar pequeños cargos
• Utilice cobertura cambiaria para obtener ingresos internacionales cuantiosos y predecibles
• Revisar regulaciones transfronterizas: Algunos países tienen restricciones de pago

¿Qué sigue?¶

• Obtenga más información sobre Manejo de reembolsos y devoluciones de cargo
• Lea acerca de 3D Secure para la prevención del fraude

¿Necesitas ayuda?¶

• Documentación: docs.4geeks.io/es/pagos
• Referencia de API: docs.4geeks.io/en/api
• Soporte: disponible a través del panel de la consola

Aún con dudas? Pregunta en Discord o explore tutoriales