Checkout hospedado e links de pagamento
Receba por cartão e compartilhe links do painel.
Para pagamentos por cartão, crie um checkout de produto ou link de pagamento no painel e compartilhe a URL copiada, normalmente https://pay.quiblypay.com/<shortCode>. Os links legados /p/<hashLink> e /l/<hashCode> redirecionam para a URL curta. O endereço base do checkout não identifica um pedido específico. Os produtos também oferecem uma URL separada de sandbox. Nunca inclua segredos de API em URLs de checkout.
A API v3 oferece cobranças PIX, saques PIX e consulta de transações. Ela não possui endpoint para criar pagamentos por cartão. Pagamentos por cartão estão disponíveis no checkout hospedado, conforme os métodos habilitados pelo produtor.
O PIX do sandbox não pode ser pago em banco; use a simulação ou a ação Marcar como pago no painel antes do vencimento. Para testar cartão exclusivamente no checkout sandbox, use os números de teste abaixo:
| Número | Resultado |
|---|---|
| 4242 4242 4242 4242 | Aprovado |
| 5555 5555 5555 4444 | Aprovado |
| 4000 0000 0000 0002 | Recusado |
| 4000 0000 0000 9995 | Saldo insuficiente |
| 4000 0000 0000 0069 | Cartão vencido |
| 4000 0000 0000 0127 | CVV inválido |
| 4000 0000 0000 3220 | Pendente, depois aprovado em cerca de um minuto |
| 4000 0000 0000 0259 | Aprovado com fluxo simulado de contestação (chargeback) |
Use uma validade futura e qualquer CVV de três dígitos. A produção rejeita esses cartões de teste. Nunca informe um cartão real no sandbox.
Crie as credenciais em Desenvolvedor > Credenciais de API, teste com qp_test_, valide o webhook e confirme a transação antes de entregar o produto. Para vender sem código ou receber por cartão, copie o link do checkout no painel.