API RecebeAqui
Checkout
POST Criar Checkout GET Consultar Checkout PUT Cancelar Checkout POST Criar Checkout transparenteGerenciamento de Pagamentos
Cancelar Pagamento RealizadoAssinaturas/Recorrências
POST Criar Recorrência GET Consultar Recorrências GET Pagamentos da RecorrênciaTaxas
GET Contultar TaxasConsultar Taxas
Consulte as taxas e tarifas aplicadas à sua conta, incluindo taxas de crédito por parcelamento, taxas de boleto e taxas de antecipação automática e manual.
Endpoint
GET /api/FeeGroup
Autenticação
Este endpoint requer autenticação via Bearer Token. Consulte a página de Autenticação para mais detalhes.
Exemplos de Requisição
curl -X GET "https://api.recebeaqui.com/v2/api/FeeGroup" \
-H "Authorization: Bearer {seu_token_de_api}" \
-H "Content-Type: application/json"
const response = await fetch('https://api.recebeaqui.com/v2/api/FeeGroup', {
method: 'GET',
headers: {
'Authorization': 'Bearer {seu_token_de_api}',
'Content-Type': 'application/json'
}
});
const taxas = await response.json();
using System.Net.Http.Headers;
var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "{seu_token_de_api}");
var response = await client.GetAsync("https://api.recebeaqui.com/v2/api/FeeGroup");
var content = await response.Content.ReadAsStringAsync();
Resposta de Sucesso (200 OK)
Retorna um objeto JSON com todas as taxas e tarifas aplicadas à conta:
{
"accountHasAutomaticAntecipation": true,
"bankSlipFee": 3.50,
"creditFee": 0.40,
"creditRate1Installment": 2.99,
"creditRate2To6Installments": 4.99,
"creditRate7To12Installments": 6.99,
"creditRate13To21Installments": 8.99,
"manualAdvanceRate": 2.50,
"automaticAdvanceRate1Installment": 2.99,
"automaticAdvanceRate2Installments": 3.20,
"automaticAdvanceRate3Installments": 3.40,
"automaticAdvanceRate4Installments": 3.60,
"automaticAdvanceRate5Installments": 3.80,
"automaticAdvanceRate6Installments": 4.00,
"automaticAdvanceRate7Installments": 4.20,
"automaticAdvanceRate8Installments": 4.40,
"automaticAdvanceRate9Installments": 4.60,
"automaticAdvanceRate10Installments": 4.80,
"automaticAdvanceRate11Installments": 5.00,
"automaticAdvanceRate12Installments": 5.20,
"automaticAdvanceRate13Installments": 5.40,
"automaticAdvanceRate14Installments": 5.60,
"automaticAdvanceRate15Installments": 5.80,
"automaticAdvanceRate16Installments": 6.00,
"automaticAdvanceRate17Installments": 6.20,
"automaticAdvanceRate18Installments": 6.40,
"automaticAdvanceRate19Installments": 6.60,
"automaticAdvanceRate20Installments": 6.80,
"automaticAdvanceRate21Installments": 7.00
}
Campos da Resposta
| Campo | Tipo | Descrição |
|---|---|---|
accountHasAutomaticAntecipation |
boolean | Indica se a conta possui antecipação automática habilitada |
bankSlipFee |
decimal | Tarifa cobrada por boleto gerado (em R$) |
creditFee |
decimal | Tarifa fixa por transação de crédito (em R$) |
creditRate1Installment |
decimal | Taxa percentual para pagamento à vista (1x) |
creditRate2To6Installments |
decimal | Taxa percentual para parcelamento de 2 a 6 vezes |
creditRate7To12Installments |
decimal | Taxa percentual para parcelamento de 7 a 12 vezes |
creditRate13To21Installments |
decimal | Taxa percentual para parcelamento de 13 a 21 vezes |
manualAdvanceRate |
decimal | Taxa percentual para antecipação manual de recebíveis |
automaticAdvanceRate1Installment |
decimal | Taxa de antecipação automática para 1 parcela |
automaticAdvanceRate2Installments |
decimal | Taxa de antecipação automática para 2 parcelas |
automaticAdvanceRate3Installments |
decimal | Taxa de antecipação automática para 3 parcelas |
automaticAdvanceRate4Installments |
decimal | Taxa de antecipação automática para 4 parcelas |
automaticAdvanceRate5Installments |
decimal | Taxa de antecipação automática para 5 parcelas |
automaticAdvanceRate6Installments |
decimal | Taxa de antecipação automática para 6 parcelas |
automaticAdvanceRate7Installments |
decimal | Taxa de antecipação automática para 7 parcelas |
automaticAdvanceRate8Installments |
decimal | Taxa de antecipação automática para 8 parcelas |
automaticAdvanceRate9Installments |
decimal | Taxa de antecipação automática para 9 parcelas |
automaticAdvanceRate10Installments |
decimal | Taxa de antecipação automática para 10 parcelas |
automaticAdvanceRate11Installments |
decimal | Taxa de antecipação automática para 11 parcelas |
automaticAdvanceRate12Installments |
decimal | Taxa de antecipação automática para 12 parcelas |
automaticAdvanceRate13Installments |
decimal | Taxa de antecipação automática para 13 parcelas |
automaticAdvanceRate14Installments |
decimal | Taxa de antecipação automática para 14 parcelas |
automaticAdvanceRate15Installments |
decimal | Taxa de antecipação automática para 15 parcelas |
automaticAdvanceRate16Installments |
decimal | Taxa de antecipação automática para 16 parcelas |
automaticAdvanceRate17Installments |
decimal | Taxa de antecipação automática para 17 parcelas |
automaticAdvanceRate18Installments |
decimal | Taxa de antecipação automática para 18 parcelas |
automaticAdvanceRate19Installments |
decimal | Taxa de antecipação automática para 19 parcelas |
automaticAdvanceRate20Installments |
decimal | Taxa de antecipação automática para 20 parcelas |
automaticAdvanceRate21Installments |
decimal | Taxa de antecipação automática para 21 parcelas |
Possíveis Erros
401 - Não Autorizado
Token de autenticação inválido, expirado ou ausente:
{
"title": "Unauthorized",
"status": 401,
"detail": "Token de autenticação inválido, expirado ou ausente.",
"errors": {}
}
404 - Não Encontrado
Configuração da conta ou grupo de taxas não encontrado:
{
"status": 404,
"title": "Configuração da conta não encontrada.",
"detail": "Não foi possível localizar a configuração da conta para o usuário."
}
500 - Erro Interno
Erro inesperado no servidor:
{
"status": 500,
"title": "Erro interno",
"detail": "Ocorreu um erro inesperado ao processar a solicitação."
}
💡 Caso de Uso
Este endpoint é útil para:
- Exibir as taxas para seus clientes antes de realizar um checkout
- Calcular o valor líquido que você receberá em uma transação
- Verificar se sua conta possui antecipação automática habilitada
- Integrar um simulador de taxas em sua aplicação