Minstrel

Cobrança avulsa

Cobre a fatura avulsa do jeito que o emissor aceita

Fatura avulsa não tem acordo de recorrência com o portador. Cobrar o cartão salvo dela por iniciativa da loja é exatamente o tipo de cobrança que o emissor recusa, ou que vira contestação depois. Por isso o caminho é o link.

  • Transação iniciada pelo cliente
  • Um link ativo por fatura
  • Quitação automática

Como funciona

  1. 1

    Gere o link

    Escolha a conta do parceiro, os meios aceitos, o parcelamento máximo e a validade. O link cobra o valor que a fatura deve naquele momento.

  2. 2

    Mande ao cliente

    O endereço também vai para a fatura e alimenta a variável usada pela régua de cobrança, então os avisos já saem com o link.

  3. 3

    O cliente paga

    Na página do parceiro, com cartão, Pix ou boleto. O número do cartão não passa pelo Minstrel: guardamos só bandeira e final.

  4. 4

    A fatura se quita sozinha

    O link vira pago, nasce o pagamento, a tentativa fica registrada na conta do parceiro e a assinatura volta a ficar em dia.

No painel

A geração do link

Conta do parceiro, meios aceitos, parcelamento e validade. O valor vem da fatura, e o link aparece pronto para copiar ou enviar.

Geração de link para uma fatura avulsa, com cartão, Pix e boleto habilitados.

No painel

O checkout

O cliente escolhe o meio e paga na página do parceiro. No sandbox, o checkout simula aprovação, recusa por saldo, pagamento de Pix e compensação de boleto.

Checkout do link: o cliente escolhe entre cartão, Pix e boleto.

O que está incluído

  • Iniciada pelo cliente, como o emissor espera

    O pagamento que nasce do link é registrado como iniciado pelo cliente, com o meio que ele escolheu. É a diferença entre uma cobrança defensável e uma contestação meses depois.

    initiator: "customer"

  • Um link ativo por fatura

    Gerar outro cancela o anterior. Antes de substituir, o Minstrel confirma com o parceiro que o link antigo não foi pago: se foi, o pagamento é registrado, a fatura é quitada e a troca é recusada.

  • Ninguém paga duas vezes

    Uma baixa manual ou uma cobrança aprovada no cartão cancelam o link ativo na hora, com o motivo registrado. E duas confirmações chegando juntas criam um pagamento só.

    replaced · manual · invoice_paid · invoice_voided

  • Parcelamento e validade sob controle

    De uma a doze parcelas, e parcelamento acima de uma só quando o cartão está entre os meios aceitos. Validade de um a trinta dias, sete por padrão.

  • A confirmação não depende de aviso

    Um worker consulta os links ativos no parceiro, vence os que passaram da validade e cancela os de faturas que deixaram de aceitar pagamento. Dá para forçar a consulta a qualquer momento.

  • Estorno pelo caminho normal

    A tentativa aprovada fica registrada na conta do plugin, e é ela que permite estornar depois pelo mesmo endpoint de estorno de qualquer pagamento.

Gerar o link

POST /v1/invoices/inv_01M4.../payment-links{  "connectorAccountId": "ca_01M4...",  "methods": ["card", "pix", "boleto"],  "maxInstallments": 3,  "expiresInDays": 7}
Documentação de links de pagamento

Parceiros que geram link

O Minstrel Sandbox gera link e simula o checkout inteiro, para você construir e testar a integração hoje. Mercado Pago, PagBank, Asaas, iugu e Pagar.me estão em desenvolvimento, e a Cielo processa o cartão salvo das assinaturas mas ainda não gera link. No painel, quem ainda não gera aparece como "em breve" na escolha do plugin.

Dúvidas frequentes

O detalhe técnico de cada resposta está na documentação de links de pagamento.

  • E se o cliente estiver comigo agora, no telefone?

    Aí dá para cobrar o cartão salvo direto, declarando que o cliente está presente. Sem essa declaração, a fatura avulsa recusa a cobrança e devolve o caminho do link: é a trava que evita transformar uma cobrança avulsa numa cobrança de recorrência sem acordo.

  • A recusa no link gera retentativa?

    Não. Quem tenta de novo é o cliente: o link segue ativo e a fatura continua em aberto. Cobrança avulsa recusada não entra na fila de retentativa automática.

  • O link expira?

    Expira na validade que você definir, de um a trinta dias. Depois disso ele vira expirado, some do campo de link da fatura e um novo pode ser gerado.

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.