🤖 Explicar com IA

Check-out em várias moedas: aceitando pagamentos globalmente¶

Visão geral¶

4Geeks Payments permite aceitar pagamentos em várias moedas, proporcionando experiências de checkout localizadas para clientes em todo o mundo. Como seu comerciante oficial, a 4Geeks lida automaticamente com a conversão de moeda, conformidade transfronteiriça e métodos de pagamento locais.

Neste tutorial, você irá:

• Configurar moedas suportadas
• Configure a conversão dinâmica de moeda
• Implementar experiências de checkout localizadas
• Lidar com assinaturas em várias moedas
• Monitorar taxas de câmbio e taxas de conversão

Moedas suportadas¶

4Geeks Payments suporta mais de 135 moedas. Os mais comumente usados incluem:

Etapa 1: Configurar moedas suportadas¶

1. Faça login em console.4geeks.io
2. Navegue até Pagamentos → Configurações → Moedas
3. Habilite as moedas que deseja aceitar:
4. Ativar/desativar cada moeda
5. Definir regras de arredondamento (por exemplo, arredondar para 0,99 mais próximo)
6. Configurar formato de exibição (posição do símbolo, casas decimais)

Configurações de exibição de moeda¶

Etapa 2: Implementar conversão dinâmica de moeda¶

Usando links de pagamento¶

Os links de pagamento detectam automaticamente a localização do cliente e exibem os preços na moeda 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 direta¶

Para checkout personalizado, especifique a moeda preferida do 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}` }
});

Etapa 3: configurar o check-out localizado¶

Detectar localização do 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;

Exibir preços localizados¶

CODE_BLOCO_3

Métodos de pagamento locais¶

4Geeks Payments oferece automaticamente métodos de pagamento relevantes com base na moeda e localização:

Etapa 4: lidar com assinaturas em várias moedas¶

Criando um plano multimoeda¶

// 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}` }
});

Bloqueio de moeda para assinaturas¶

Quando um cliente assina, sua moeda fica bloqueada:

• A cobrança continua na mesma moeda durante a vigência da assinatura
• Flutuações nas taxas de câmbio não afetam o preço do cliente
• Alterações de plano (upgrade/downgrade) usam a mesma moeda
• O cliente pode solicitar alteração de moeda (requer intervenção do suporte)

Etapa 5: Monitore as taxas de câmbio e a conversão¶

Painel de taxas de câmbio¶

1. Vá para Pagamentos → Analytics → Multi-Moeda
2. Visualizar:
3. Taxas de câmbio atuais para todas as moedas habilitadas
4. Histórico de taxas ao longo do tempo
5. Volume de conversão por moeda
6. Receita por moeda

Taxas de conversão¶

Relatório de receita¶

Veja a receita dividida por:

• Moeda da transação: quanto o cliente pagou
• Moeda de liquidação: O que você recebeu
• Impacto na conversão: Ganho/perda de movimentos cambiais

Melhores práticas¶

Estratégia de preços¶

• Defina preços locais competitivos: não se limite a converter — pesquise as taxas do mercado local
• Use preço psicológico: US$ 49,99 → € 44,99 → MX$ 949
• Considere o poder de compra: ajuste os preços para diferentes regiões
• Revise os preços trimestralmente: As taxas de câmbio e as condições de mercado mudam

Experiência do Cliente¶

• Mostrar preços na moeda local por padrão
• Exibir a moeda original para maior transparência
• Explicar a conversão se a moeda do cartão do cliente for diferente
• Ofereça seleção de moeda na página de checkout

Gestão de Risco¶

• Monitorar a volatilidade da taxa de câmbio: Grandes oscilações podem impactar as margens
• Defina valores mínimos de transação por moeda para evitar pequenas cobranças
• Use hedge cambial para obter receitas internacionais grandes e previsíveis
• Revisar regulamentações transfronteiriças: alguns países têm restrições de pagamento

O que vem a seguir?¶

• Saiba mais sobre Como lidar com reembolsos e estornos
• Leia sobre 3D Secure para prevenção de fraudes

Precisa de ajuda?¶

• Documentação: docs.4geeks.io/en/payments
• Referência da API: docs.4geeks.io/en/api
• Suporte: disponível no painel do console

Ainda tem dúvidas? Pergunte na Discord or explore tutoriais