Todas as rotas exigem o header
x-api-key (sua chave de sandbox). Veja
Autenticação. Os exemplos nas páginas de cada endpoint usam a base URL de
sandbox https://api.sandbox.z2pay.com/v1.Endpoints
Cada endpoint tem sua própria página, com os campos aceitos, exemplos e o playground para testar.Como ler uma taxa
Toda taxa da resposta tem os mesmos dois componentes, e eles se somam. Ler um sem o outro dá o número errado — uma venda de R$ 100,00 compercentage: 3.99 e fixed: 350 custa R$ 7,49, não
R$ 3,99.
Três detalhes que mudam a leitura
creditCard sempre traz 12 itens, de 1x a 12x, mesmo que sua conta não opere com todas as
parcelas. Não conte com a posição no array: procure pelo campo installments da parcela que você
quer.Taxa não configurada vem como
0, não ausente. O campo existe na resposta com valor zero, o
que significa “sem cobrança configurada” — e não “informação indisponível”.A taxa é resolvida por moeda. Sem uma configuração específica para a moeda pedida, vale a taxa
que não distingue moeda. Hoje o único valor aceito é
BRL (veja
Convenções).Veja também
Conceito de Taxas
Como as taxas são modeladas e resolvidas por precedência.
Liquidação
Como a taxa entra no cálculo do valor líquido a receber.
Split
Quem paga a taxa quando o valor é dividido entre recebedores.
Chargebacks
Onde a taxa e a multa de chargeback são cobradas.