Conversão de moeda

A capacidade de conversão de moeda da DEUNA permite que os comerciantes apresentem preços e processem pagamentos em diversas moedas, mantendo o controle sobre a moeda de liquidação, as estruturas de custos e a experiência do usuário.
Ao centralizar as integrações com fornecedores de FX, a DEUNA simplifica as operações internacionais e garante que os detalhes da conversão fluam de forma consistente ao longo do ciclo de vida da transação.

Os comerciantes podem fornecer os seus próprios dados FX ou contar com os serviços de taxas integradas da DEUNA.

Principais benefícios#

• Aceitação em várias moedas
  Ofereça preços localizados e opções de pagamento para clientes em todos os mercados.

• Experiência do usuário aprimorada
  Reduza o atrito permitindo que os compradores paguem na moeda que entendem.

• Eficiência Operacional
  Evite gerenciar múltiplas integrações de provedores de FX; DEUNA lida com formatos específicos do provedor.

• Opções de liquidação flexíveis
  Processe em uma moeda enquanto exibe ou cobra em outra.

Quando usar a conversão de moeda#

• Comércio eletrônico transfronteiriço – Exiba a moeda local ao liquidar na moeda base do comerciante.
• Remessas e Pagamentos – Converta fundos ao enviar ou receber transferências internacionais.
• Viagens e companhias aéreas – Apoie pagamentos de viajantes globais e diferentes moedas de ponto de venda.
• Serviços Financeiros – Gerencie conversões de câmbio para ativos denominados em diversas moedas.

Conceitos Básicos#

Taxa de câmbio
Determina o valor usado para converter uma moeda para outra. Pode ser fixo, definido pelo fornecedor ou baseado em condições de mercado em tempo real.

Moeda base
Moeda da qual a conversão se origina.

Moeda do comprador
Moeda em que o cliente será cobrado.

Spread cambial
Margem do fornecedor aplicada sobre a taxa de câmbio subjacente.

Taxas em tempo real
Taxas devolvidas e aplicadas no momento em que o comerciante ou a DEUNA solicita a conversão.

Opções de arquitetura#

Fluxo de conversão de moeda proprietária do comerciante

Conversão de moeda em tempo real

Opções de integração#

DEUNA suporta dois modelos para aplicação de conversão de moeda durante o processamento de pagamentos:

1. Taxa de câmbio fornecida pelo comerciante
2. DEUNA Rate Service (recuperação de FX gerenciada pela DEUNA)

Ambas as opções permitem cobrar do comprador em uma moeda e liquidar em outra, dependendo da sua configuração comercial e operacional.

1. Taxa de câmbio fornecida pelo comerciante

Se a sua empresa já obtém taxas de câmbio de um fornecedor de câmbio externo, você pode encaminhar essas informações para a DEUNA como parte da solicitação de pagamento.
A DEUNA incluirá esses detalhes FX ao encaminhar a transação para o adquirente ou processador.

Exemplo de solicitação de pagamento com Merchant FX

{
  "amount": {
    "currency": "COP",
    "value": 5000,
    "currency_conversion": {
      "external_rate_reference": "AAA01SADOIAJSDLAKSJM",
      "shopper_currency": "ARS",
      "shopper_amount": 1146.55
    }
  }
}

2. Serviço de Tarifas DEUNA

O DEUNA Rate Service permite que os comerciantes confiem na DEUNA para obter taxas de câmbio diretamente de um provedor FX integrado. Esta opção é ideal quando você deseja que a DEUNA padronize o fluxo de trabalho FX em todos os provedores sem gerenciar múltiplas integrações ou formatos de taxas.

Este fluxo usa um processo em duas etapas:

1. Solicite uma taxa de câmbio de DEUNA
2. Use the returned FX rate ID ao criar o pagamento

Isto garante que a taxa de câmbio cotada esteja corretamente vinculada à transação final.

Converter moedas#

1. Solicite uma taxa de câmbio

Envie uma solicitação indicando:

• A moeda da transação original
• A moeda preferida do usuário
• O provedor de FX do qual a DEUNA deve recuperar as taxas

Solicitação

{
  "amount": 30000,
  "original_currency": "MXN",
  "destination_currency": "USD",
  "provider_info": {
     "id": "f8e3a9bb-1f28-4b6c-ac12-7d9e3e84d04a"
  }
}

Resposta

{
  "currency_conversion": {
    "id": "ccv_7b29c4ab-f61d-4e58-9dc5-1a9fceb823b3",
    "original_currency": "MXN",
    "destination_currency": "USD",
    "original_amount": 30000,
    "destination_amount": 1764.71,
    "rate": 0.0588237,
    "provider_info": {
      "id": "f8e3a9bb-1f28-4b6c-ac12-7d9e3e84d04a",
      "name": "NUVEI",
      "timestamp": "2025-01-04T18:15:23Z"
    },
    "expires_at": "2025-01-04T18:20:23Z",
    "metadata": {
      "rate_type": "real_time",
      "precision": 6
    }
  }
}

2. Use o ID da taxa de câmbio na criação de pagamentos

Envie uma solicitação indicando:

• A moeda da transação original
• A moeda preferida do comprador
• O provedor de FX do qual a DEUNA deve recuperar as taxas

Exemplo de solicitação na API de compra

{
  ...
  "total_amount": {
      "currency_conversion": {
          "external_rate_reference": "...",
          "original_currency": "MXN",
          "destination_currency": "USD",
          "original_amount": 30000,
          "destination_amount": 1764.71
      }
  }
  ...
}

Requisitos de ativação

Para ativar qualquer fluxo de conversão de moeda, entre em contato com o Gerente de Implementação da DEUNA. A configuração depende do provedor FX, da região e da configuração do comerciante.