curl --request GET \
--url https://api.sandbox.z2pay.com/v1/fees \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.sandbox.z2pay.com/v1/fees', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sandbox.z2pay.com/v1/fees"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"currency": "BRL",
"pix": {
"percentage": 0.99,
"fixed": 0
},
"boleto": {
"percentage": 1.99,
"fixed": 350
},
"creditCard": [
{
"installments": 1,
"percentage": 3.99,
"fixed": 49
},
{
"installments": 2,
"percentage": 4.49,
"fixed": 49
},
{
"installments": 3,
"percentage": 4.99,
"fixed": 49
},
{
"installments": 4,
"percentage": 5.49,
"fixed": 49
},
{
"installments": 5,
"percentage": 5.99,
"fixed": 49
},
{
"installments": 6,
"percentage": 6.49,
"fixed": 49
},
{
"installments": 7,
"percentage": 6.99,
"fixed": 49
},
{
"installments": 8,
"percentage": 7.49,
"fixed": 49
},
{
"installments": 9,
"percentage": 7.99,
"fixed": 49
},
{
"installments": 10,
"percentage": 8.49,
"fixed": 49
},
{
"installments": 11,
"percentage": 8.99,
"fixed": 49
},
{
"installments": 12,
"percentage": 9.49,
"fixed": 49
}
],
"withdrawal": {
"percentage": 0,
"fixed": 367
},
"refund": {
"percentage": 0,
"fixed": 0
},
"chargeback": {
"fee": {
"percentage": 0,
"fixed": 1500
},
"penalty": {
"percentage": 0,
"fixed": 0
}
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"issues": [
{
"path": "status",
"message": "Status inválido. Valores aceitos: pending, waiting_payment, paid, refused, canceled, refunded"
},
{
"path": "startDate",
"message": "Data deve ser ISO 8601 com timezone (ex.: 2026-06-24T00:00:00Z)"
}
]
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API key"
}
}Tabela de taxas da conta
Retorna a tabela de taxas da sua conta, opcionalmente para uma moeda específica.
curl --request GET \
--url https://api.sandbox.z2pay.com/v1/fees \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.sandbox.z2pay.com/v1/fees', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sandbox.z2pay.com/v1/fees"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"currency": "BRL",
"pix": {
"percentage": 0.99,
"fixed": 0
},
"boleto": {
"percentage": 1.99,
"fixed": 350
},
"creditCard": [
{
"installments": 1,
"percentage": 3.99,
"fixed": 49
},
{
"installments": 2,
"percentage": 4.49,
"fixed": 49
},
{
"installments": 3,
"percentage": 4.99,
"fixed": 49
},
{
"installments": 4,
"percentage": 5.49,
"fixed": 49
},
{
"installments": 5,
"percentage": 5.99,
"fixed": 49
},
{
"installments": 6,
"percentage": 6.49,
"fixed": 49
},
{
"installments": 7,
"percentage": 6.99,
"fixed": 49
},
{
"installments": 8,
"percentage": 7.49,
"fixed": 49
},
{
"installments": 9,
"percentage": 7.99,
"fixed": 49
},
{
"installments": 10,
"percentage": 8.49,
"fixed": 49
},
{
"installments": 11,
"percentage": 8.99,
"fixed": 49
},
{
"installments": 12,
"percentage": 9.49,
"fixed": 49
}
],
"withdrawal": {
"percentage": 0,
"fixed": 367
},
"refund": {
"percentage": 0,
"fixed": 0
},
"chargeback": {
"fee": {
"percentage": 0,
"fixed": 1500
},
"penalty": {
"percentage": 0,
"fixed": 0
}
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"issues": [
{
"path": "status",
"message": "Status inválido. Valores aceitos: pending, waiting_payment, paid, refused, canceled, refunded"
},
{
"path": "startDate",
"message": "Data deve ser ISO 8601 com timezone (ex.: 2026-06-24T00:00:00Z)"
}
]
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API key"
}
}GET /fees
Faz parte do recurso Fees — como ler cada taxa e o significado de cada
campo estão lá.
Retorna a tabela de taxas vigente para a sua conta. Não é uma listagem paginada: a resposta é um
único objeto, com uma entrada por método de pagamento.
0 (percentual e fixo), o que é indistinguível de
uma taxa realmente zerada.Exemplo
# Usando a moeda padrão da conta
curl https://api.sandbox.z2pay.com/v1/fees -H "x-api-key: SUA_CHAVE_DE_SANDBOX"
# Forçando uma moeda específica
curl "https://api.sandbox.z2pay.com/v1/fees?currency=BRL" -H "x-api-key: SUA_CHAVE_DE_SANDBOX"
{
"currency": "BRL",
"pix": { "percentage": 0.99, "fixed": 0 },
"boleto": { "percentage": 0, "fixed": 350 },
"creditCard": [
{ "installments": 1, "percentage": 3.99, "fixed": 0 },
{ "installments": 2, "percentage": 4.49, "fixed": 0 },
{ "installments": 3, "percentage": 4.99, "fixed": 0 },
{ "installments": 12, "percentage": 6.99, "fixed": 0 }
],
"withdrawal": { "percentage": 0, "fixed": 367 },
"refund": { "percentage": 0, "fixed": 0 },
"chargeback": {
"fee": { "percentage": 0, "fixed": 0 },
"penalty": { "percentage": 0, "fixed": 0 }
}
}
Authorizations
API Key da Credential (gerada no Backoffice)
Query Parameters
Moeda no padrão ISO 4217. Hoje o único valor aceito é 'BRL'. Omitida, usa a moeda padrão da sua conta.
BRL Response
Taxas da conta
Taxas já resolvidas para a sua conta. Taxa não configurada vem com percentage e fixed em 0 — é a resposta desta rota, e não uma tabela publicada, que vale para a sua conta.
Moeda das taxas (ISO 4217). Sem currency na query, é a moeda padrão da conta.
Taxa do Pix.
Show child attributes
Show child attributes
Taxa do boleto.
Show child attributes
Show child attributes
Taxa de cartão por parcela — sempre 12 entradas, de 1x a 12x.
Show child attributes
Show child attributes
Taxa de saque.
Show child attributes
Show child attributes
Taxa de estorno.
Show child attributes
Show child attributes
Taxas relacionadas a chargeback.
Show child attributes
Show child attributes