> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cakto.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Receber e conciliar

> Como a venda em dólar aparece no webhook, nos pedidos e no saldo, e como o dinheiro sai.

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.

> [!WARNING]
>
> 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:

```json theme={null}
{
  "secret": "b3f1a9c2-7b4d-4a8e-9f01-2c6d5b8a4e37",
  "event": "purchase_approved",
  "data": {
    "id": "b3df956e-1998-4322-b091-ac0c54f7b4ba",
    "status": "paid",
    "baseAmount": 49.9,
    "amount": 49.9,
    "currency": "USD",
    "paymentMethod": "credit_card",
    "customer": {
      "name": "John Smith",
      "email": "john.smith@example.com",
      "docNumber": null
    },
    "offer": {
      "id": "a8BcHrY",
      "name": "Photography Masterclass",
      "price": 49.9,
      "currency": "USD"
    }
  }
}
```

> [!NOTE]
>
> 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](https://docs.cakto.com.br/conceitos/webhooks.md).

## Nos pedidos

Em [`GET /public_api/orders/`](https://docs.cakto.com.br/api-reference/orders/list), 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`:

```bash curl icon=terminal theme={null}
curl "https://api.cakto.com.br/public_api/balance/?currency=USD" \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN"
```

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:

```bash curl icon=terminal theme={null}
curl "https://api.cakto.com.br/public_api/balance/schedule/?currency=USD" \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN"
```

Referência em [Saldo](https://docs.cakto.com.br/api-reference/balance/retrieve.md) e
[Agenda de Recebimentos](https://docs.cakto.com.br/api-reference/balance/schedule.md). 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.

> [!NOTE]
>
> O saque pela API, [`POST /public_api/withdrawals/`](https://docs.cakto.com.br/api-reference/withdrawals/create),
> é 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.