Preciso de arquivo CNAB ou de VAN?

Não. Todo o registro e toda a confirmação acontecem on-line, pelo webservice do banco. Não há remessa, não há retorno e não há janela de processamento.

Não automático, e a API é explícita quanto a isso. Para devolver, faça um Pix ou uma transferência para a conta do pagador e registre a devolução no seu controle.

Como testo um pagamento no sandbox?

Pela simulação: você marca a cobrança como paga ou vencida e o resultado segue o mesmo caminho da consulta e do webhook, com fluxo retomado e eventos iguais aos de produção.

Meios de pagamento

Pix e boleto por API, sem VAN e sem CNAB

Não há arquivo de remessa nem retorno: o registro e a confirmação acontecem pelo webservice do banco. E a venda só é confirmada depois que o Minstrel consulta, nunca por acreditar num aviso.

Copia e cola na resposta
Consultamos antes de acreditar
Sem VAN, sem CNAB

Testar no sandbox Documentação de Pix e boleto

Como funciona

1
Crie a cobrança
O pagamento nasce aguardando ação, com o que o pagador precisa já na resposta da API.
2
Mostre ao cliente
O copia e cola do Pix ou a linha digitável do boleto, só com dígitos. A formatação fica com você.
3
O banco avisa, nós conferimos
O aviso só aponta o que mudou. Quem decide é a consulta: o corpo do webhook nunca muda um pagamento.
4
A venda é confirmada
O fluxo retoma de onde parou, o pagamento vira capturado e o evento sai para o seu sistema.

No painel

Um Pix aguardando pagamento

O QR Code, o copia e cola e a validade correndo. Quando o banco confirma, o pagamento vira capturado e o fluxo retoma de onde parou.

Pix emitido: copia e cola, validade e a confirmação conferida com o banco.

No painel

Um boleto registrado

Linha digitável, vencimento, tolerância, multa e juros. A confirmação continua sendo consultada por dois dias úteis depois do vencimento.

Boleto registrado, com linha digitável, vencimento e as regras de atraso.

O que está incluído

Tudo que o pagador precisa, na resposta
No Pix, o copia e cola no padrão do Banco Central, o identificador da transação e a validade. No boleto, o código de barras de 44 dígitos, a linha digitável de 47, o vencimento e o nosso número.
nextAction.type: "pix_qr_code" | "boleto"
Consultamos antes de acreditar
O Pix pendente é consultado a cada 90 segundos e o boleto a cada 30 minutos. Um aviso forjado, mesmo com o endereço certo, não paga nada. E sem webhook cadastrado nada se perde: a consulta confirma do mesmo jeito, só que mais devagar.
Multa, juros e tolerância do boleto
Dias de tolerância após o vencimento, multa e juros ao mês em basis points, e instruções livres. A validade segue a regra de mercado: fim do dia de Brasília do vencimento mais a tolerância, levado ao próximo dia útil.
daysAfterDue · fineBps · interestMonthlyBps
O boleto pago no último dia não se perde
Pagamento feito no último dia só compensa no dia útil seguinte. Por isso, passada a data limite, o Minstrel segue consultando por dois dias úteis antes de dar baixa.
Cancelar consulta antes de cancelar
O cancelamento tira a cobrança do banco. Mas, antes, consulta: se o pagador acabou de pagar, o pagamento é confirmado e o cancelamento é recusado. Nunca se cancela um Pix pago.
Vencido não é recusado
Uma cobrança que venceu ou foi cancelada fica registrada como tal, não como recusa. Ninguém negou nada, e misturar os dois estraga qualquer relatório de aprovação.
Estorno de Pix em segundos
Total ou parcial, até o valor pago. A devolução é pedida ao provedor que recebeu, pelo identificador gravado na confirmação.

Criar um Pix

POST /v1/payments{  "amount": 14990,  "methodType": "pix",  "customerId": "cus_01M5...",  "pix": { "expiresInSeconds": 3600 },  "description": "Pedido 1234"}→ 201 { "status": "requires_action",        "nextAction": { "type": "pix_qr_code",                        "qrCode": "00020126580014br.gov.bcb.pix…" } }

Documentação de Pix e boleto

Bancos em integração

O Minstrel Sandbox já emite Pix e boleto bem formados, com código válido e impagável de verdade, para você construir e testar a integração inteira hoje. Inter, Itaú, Bradesco, Santander, Banco do Brasil, Sicredi, Sicoob e Caixa, além dos provedores de Pix Efí e Celcoin, aparecem como "em breve" até a integração ficar pronta.

Dúvidas frequentes

O detalhe técnico de cada resposta está na documentação de pix e boleto.

Preciso de arquivo CNAB ou de VAN?
Não. Todo o registro e toda a confirmação acontecem on-line, pelo webservice do banco. Não há remessa, não há retorno e não há janela de processamento.
Boleto tem estorno?
Não automático, e a API é explícita quanto a isso. Para devolver, faça um Pix ou uma transferência para a conta do pagador e registre a devolução no seu controle.
Como testo um pagamento no sandbox?
Pela simulação: você marca a cobrança como paga ou vencida e o resultado segue o mesmo caminho da consulta e do webhook, com fluxo retomado e eventos iguais aos de produção.

Continua em

Veja funcionando no sandbox

Gratuito, ilimitado e sem prazo. Dá para simular aprovação, cada recusa da ABECS e falha de rede antes de credenciar a primeira adquirente.

Primeiros passos Ver preços