Cartão de crédito
Antecipação
Simulação e efetivação da antecipação de recebíveis de cartão, com a grade de horário da BW.
A chave da API de cartão vai no header X-API-KEY. A URL base é entregue pela BW na habilitação do meio. Nos exemplos, BASE representa essa URL.
Grade e regras
| Dia | Janela |
|---|---|
| Segunda a sexta, dias úteis | 09:00 às 20:00 |
Não há antecipação em sábado, domingo ou feriado nacional. A regra vale no painel e na API. Enviar o pedido não aprova a antecipação: há análise interna e validação na registradora de recebíveis. O resultado chega por e-mail.
Pedido até 15h30: os recebíveis antecipados liquidam na próxima data de repasse da conta. Depois das 15h30, a liquidação se divide. Transações do dia anterior seguem na próxima data de repasse. Transações do mesmo dia da solicitação liquidam a partir de D+2, conforme a frequência de repasse, por causa do registro. Indisponibilidade de terceiros pode alterar o prazo. A data de pagamento respeita a frequência configurada.
Alguns lançamentos podem ficar indisponíveis no processamento, e o valor efetivado pode ser menor que o simulado. O complemento pode ser feito com uma nova antecipação. Parcela antecipada não pode ser estornada.
POST /v2/anticipation/simulate
| Campo | Obrigatório | Descrição |
|---|---|---|
| PaymentStartDate | Sim | Início do período de pagamento, AAAA-MM-DD. |
| PaymentEndDate | Sim | Fim do período de pagamento, AAAA-MM-DD. |
{
"PaymentStartDate": "2026-10-01",
"PaymentEndDate": "2026-12-31"
}| Campo da resposta | Descrição |
|---|---|
| TotalAmount | Limite bruto disponível. Pode não ser atingível conforme o valor de cada recebível. |
| TotalAmountNet | Limite líquido, já com a taxa de antecipação. |
| AmountReceivables | Bruto dos recebíveis futuros no filtro. |
| AmountNetReceivables | Líquido dos recebíveis futuros no filtro. |
| Tax | Taxa de antecipação, percentual ao mês. |
| ExpectedPaymentDate | Data de liquidação da antecipação. |
| GroupedListByDate | Recebíveis agrupados por dia: ReleaseDate, totais bruto e líquido, taxa do dia e quantidade. |
| SessionGuid | Identificador da simulação. É obrigatório para efetivar. |
Se existirem outras contas com o mesmo CPF ou CNPJ e saldo negativo, a resposta inclui essas contas em MerchantsWithTheSameIdentityButWithNegativeBalance.
POST /v2/anticipation/effectSimulate
| Campo | Obrigatório | Descrição |
|---|---|---|
| SessionGuid | Sim | Código devolvido na simulação. |
| EffectivenessList | Sim | Lista de dias a antecipar. |
| EffectivenessList.ReleaseDate | Sim | Data do grupo, AAAA-MM-DD. |
{
"SessionGuid": "2553476f-2299-457a-a9a7-ca185645d1e5",
"EffectivenessList": [
{ "ReleaseDate": "2026-10-31" }
]
}{
"HasError": true,
"ErrorCode": "243",
"Error": "Você não possui valor disponível para antecipação."
}