Valores e moedas
Como representar dinheiro em cada API, as moedas aceitas por método e os limites de valor.
Inteiro na menor unidade, em toda a API
Em cobranças, estornos, webhooks, saldo, saques e extrato, valores são inteiros na menor unidade da moeda. Em BRL e USD, a menor unidade é o centavo:
| Você quer cobrar | Envie |
|---|---|
| R$ 19,90 | "amount": 1990 |
| R$ 100,00 | "amount": 10000 |
| US$ 19,90 | "amount": 1990, "currency": "USD" |
Em cartão, um valor com casas decimais (19.90) é recusado com 400 amount_must_be_integer_minor_units. Nos demais métodos, envie sempre inteiro: um decimal pode ser aceito e interpretado como centavos fracionados.
O mesmo vale para saldo, saques e extrato: um saque de R$ 250,00 é "amount": 25000, e um saldo de R$ 1.834,27 vem como 183427. No saldo de uma conta USD, 10550 é US$ 105,50. No pedido de saque, decimal (250.00) e texto ("25000") são recusados com 400; a API nunca arredonda.
Moedas por método
| Método | Moedas |
|---|---|
| Pix | BRL |
| Pix parcelado | BRL |
| Cartão de crédito e débito | BRL ou USD, conforme a habilitação da conta |
| Saque | BRL |
| Saldo | BRL ou USD, a moeda da conta |
Limites de valor
| Método | Limite |
|---|---|
| Cartão | Mínimo de 50 unidades da menor unidade da moeda (R$ 0,50 em BRL). |
| Pix parcelado | De 1 a 1000000 centavos (R$ 0,01 a R$ 10.000,00). |
| Saque | Mínimo de 100 (R$ 1,00). |
A sua conta pode ter limites adicionais de valor, moeda e parcelamento, definidos no credenciamento.
Parcelas
Em crédito parcelado, amount é o total da venda. R$ 100,00 em três parcelas continua sendo "amount": 10000. Quando o total não é divisível, o ajuste de centavos fica na primeira parcela.