Tarifas¶

Para: Fin — Conferido em 2026-10-18.

O Dracma não desconta tarifa do valor que você credita no depósito nem do valor que o jogador recebe no saque. As tarifas do Dracma são combinadas em contrato e não aparecem na API. Esta página diz o que a API mostra hoje sobre tarifas e o que ela deixa de mostrar.

O que é¶

Objeto	O que a API mostra sobre tarifa
Depósito	Nenhum campo de tarifa. O caixa da operação sobe o valor cheio do depósito pago.
Saque	fee sempre null e fees sempre []. O jogador recebe o valor cheio de amount.
Relatório diário	Nenhum item fee. totals.fees sempre "0".

Em números: um depósito pago de R$ 50,00 aumenta available em R$ 50,00. Um saque de R$ 50,00 faz o jogador receber R$ 50,00. Nenhuma tarifa é descontada de um lado nem do outro.

Quando usar¶

Leia esta página ao:

• montar o fluxo de caixa e o orçamento do financeiro;
• escrever a conferência diária (os totais não trazem tarifa);
• perguntar por que a API não tem extrato de tarifas.

Como funciona¶

Tarifa do Dracma¶

A tarifa comercial do Dracma é definida em contrato, caso a caso. Este guia não publica valores nem modelos de cobrança. A API não calcula, não desconta e não mostra tarifa do Dracma: o crédito do depósito e o valor do saque são sempre integrais.

Tarifa do PSP¶

Cada PSP tem a sua própria tarifa. O Dracma não a repassa no crédito do depósito nem no valor do saque, e nenhum item fee aparece no relatório diário. O guia não publica valores, tetos nem a forma como o Dracma acerta a tarifa com os PSPs: isso faz parte do contrato comercial.

Consequências para a sua conferência:

• totals.fees é "0" e o relatório não tem item fee.
• O caixa da operação só se move pelos movimentos listados em Modelo de dinheiro.
• Se available ou o caixa livre mudar por um motivo que esses movimentos não explicam, abra um chamado com a data, a moeda e os trace_id envolvidos (veja Suporte). Não ajuste o seu livro por conta própria.

Uso e consumo¶

O painel não tem tela de uso, consumo ou faturamento. O que existe de volume é o relatório diário e o extrato de transações (veja Painel: transações). Para totais por período, some os itens deposit e withdrawal do relatório de cada dia.

Exemplos¶

Trecho de um saque: fee nulo, fees vazio e o jogador recebendo o valor cheio de amount.

{
  "id": "wdr_0192a3b40c6d7e8f9a0b1c2d3e4f5a6c",
  "external_id": "wdr_0192a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6c",
  "status": "paid",
  "version": 5,
  "amount": { "amount": "5000", "currency": "BRL" },
  "fee": null,
  "fees": [],
  "method": "pix",
  "player_ref": "0192a3b4-0000-7000-8000-000000000001",
  "decision": {
    "mode": "automatic",
    "reasons": [],
    "ruleset_version": 7,
    "decided_by": [],
    "decided_at": "2026-10-18T15:00:01Z"
  },
  "psp_reference": "E00000000202610181500AbCdEfGhIjKl",
  "failure_code": null,
  "created_at": "2026-10-18T15:00:00Z",
  "updated_at": "2026-10-18T15:00:09Z",
  "paid_at": "2026-10-18T15:00:09Z"
}

Erros e casos de borda¶

• kind: fee num cliente tolerante. Se o relatório trouxer um item fee, ele entra no digest como qualquer outro. O seu conector deve tratar kind desconhecido como item de revisão, sem lançamento automático no livro (veja Reconciliar com o seu livro).
• Tarifa e Money. Qualquer tarifa visível na API é Money (inteiro na menor unidade) em fee, nunca float.
• Não confunda fee: null com "sem tarifa no contrato". A API só diz que não há tarifa visível nela.

Veja também¶

• Modelo de dinheiro
• Reconciliar com o seu livro
• PSPs
• Referência: reconciliação
• Referência: superfícies reservadas