Skip to main content
A venda em dólar é registrada em dólar do começo ao fim: no webhook, nos pedidos, no saldo e no reembolso. Isso vale mesmo quando o comprador paga na moeda local dele (peso mexicano, por exemplo). A moeda registrada é sempre a do produto.
Nunca some valores de moedas diferentes. Um relatório que junta BRL e USD na mesma conta produz um número que não existe. Separe por moeda antes de somar.

​
No webhook

O evento de pedido traz o campo currency. Ele diz a moeda de baseAmount, amount, fees, discount e das comissões, e é a moeda do produto, não a do país do comprador. Exemplo abreviado de purchase_approved de uma venda em dólar, só com os campos que mudam:
O comprador de fora costuma vir sem documento (docNumber nulo): o checkout só pede documento nos países que exigem, como Argentina e Colômbia. Se a sua integração usa o CPF como chave do cliente, use o e-mail para os pedidos internacionais.
Formato completo em Webhooks.

​
Nos pedidos

Em GET /public_api/orders/, os valores do pedido (baseAmount, amount, fees) estão na moeda do produto, que vem em product.currency. Para conciliar, agrupe por esse campo.

​
No saldo

As vendas em dólar entram num saldo em dólar, separado do saldo em reais. A mesma rota de saldo responde nas duas moedas, pelo parâmetro currency:
curl
A resposta tem os mesmos campos do saldo em reais (available, pending, reserved e os demais), com "currency": "USD". Sem o parâmetro, a rota responde em BRL. A agenda do que vai ser liberado também separa por moeda:
curl
Referência em Saldo e Agenda de Recebimentos. As duas pedem o escopo payments.

​
Para usar o dinheiro

O saldo em dólar sai pelo Financeiro do painel, de um destes dois jeitos:
  • Converter para reais: o valor passa para o saldo em reais, com o custo da conversão mostrado antes de você confirmar.
  • Sacar pela Payoneer: o saque em dólar vai para a sua conta Payoneer, cadastrada e confirmada no Financeiro.
Há valor mínimo para converter e para sacar.
O saque pela API, POST /public_api/withdrawals/, é do saldo em reais. Para sacar o que veio de vendas em dólar pela API, converta o valor para reais no painel antes.

​
Reembolso

O reembolso de uma venda em dólar sai do saldo em dólar. Na API de reembolsos, a moeda do pedido vem em currency.

​
Taxas e prazos

As taxas e os prazos das vendas internacionais mudam conforme o país do comprador. Eles ficam no painel, em Planos e Taxas, com um seletor de país. A taxa fixa aparece em dólar, porque a venda é registrada em dólar.