Pagamentos
Checkout e dados de cartão
Coleta integralmente hospedada pelo parceiro, APIs somente com tokens e limites atuais das integrações.
Guia de integração · 3 min de leitura
Nesta página
Coleta hospedada pelo parceiro
O Minstrel não oferece coleta de cartão em suas páginas. Não crie campos de número, validade ou código de segurança no painel, no checkout de assinatura ou em páginas de pagamento do Minstrel. Não envie esses dados ? API, ao MCP, a logs ou ao atendimento.
O fluxo admitido para uma nova integração real ? o redirecionamento para uma página de pagamento integralmente hospedada pela adquirente, subadquirente ou gateway. O parceiro coleta o cartão e executa a autenticação necessária. O Minstrel trabalha apenas com tokens e referências de transações.
Disponibilidade atual: a integração Cielo API E-commerce não implementa esse checkout hospedado. Silent Order Post e MPI com campos na página do lojista estão desativados, inclusive no sandbox da Cielo e para pagamentos criados antes da mudança. Informar suas credenciais não libera a coleta.
O SDK @minstrel/js recusa os provedores cielo_sop e cielo_mpi com
hosted_checkout_required, sem carregar seus scripts. As rotas públicas de
sessão, confirmação e resultado de 3DS só aceitam o simulador Minstrel Sandbox.
O painel não importa o SDK de coleta.
Pagamentos com tokens existentes
O servidor do integrador pode continuar usando card.token ou
paymentMethodId para um token obtido legitimamente no parceiro, respeitando
o cofre, a conta de conector, o consentimento e as regras de credencial
armazenada. Um token não ? portável automaticamente entre adquirentes.
As APIs autenticadas continuam disponíveis para orquestrar essas cobranças, Pix, boleto, consulta, captura e estorno. A ausência de cartão na API não certifica por si só o enquadramento PCI da plataforma ou do integrador.
Assinatura por link
O fluxo real de assinatura por link está suspenso até existir uma integração hospedada homologada que devolva token reutilizável e referências de credencial armazenada para as cobranças seguintes.
Checkout/Link Cielo ? um produto diferente da API E-commerce. A recorrência programada do Checkout/Link ? executada pela Cielo. Ela não pode ser ligada junto ao cobrador recorrente do Minstrel: isso poderia gerar cobrança duplicada. Não converta links avulsos em assinaturas nem use SOP como alternativa.
A confirmação do pagamento deve vir de consulta autenticada ao parceiro ou de
webhook validado. Uma volta do navegador, parâmetro paid=true ou URL de retorno
não ? prova de pagamento.
Testar sem cartão
No painel, selecione Minstrel Sandbox ao gerar uma assinatura por link. O comprador aceita os termos e escolhe Pagamento aprovado ou Pagamento recusado, sem informar cartão. O teste usa tokens fictícios; nenhuma chamada ? enviada a uma adquirente e nenhum valor real ? cobrado.
A simulação exige simultaneamente ambiente sandbox e conector
minstrel_sandbox. Selecionar Cielo sandbox não ativa o simulador.
Responsabilidades de segurança
Terceirizar a coleta reduz a exposição a dados de cartão. Isso não equivale a certificação nem garante ausência de obrigações PCI para o Minstrel como prestador de serviços. O enquadramento precisa ser confirmado com o parceiro e o responsável pela avaliação antes da ativação em produção.
Referências oficiais: