PayZu Gateway

Checkout


Nesta páginaModalidadesRotasRegras de todas as rotas

Monte a sua página de pagamento com as mesmas rotas da página da PayZu, que levam toda venda a uma fatura paga no cartão ou no Pix.

Modalidades

O plano e o link são portas de entrada e não recebem pagamento.

Porta de entradaO que a rota cria
PlanoA assinatura incomplete e a fatura de adesão, que ativa a assinatura quando é paga.
Link de pagamentoUma fatura sem cliente, a cada compra.

Só a fatura recebe pagamento, seja ela criada pela API, pela adesão ou pelo link. A fatura paga é o comprovante da venda.

Rotas

Regras de todas as rotas

  • Chave: as rotas do plano e da assinatura levam a chave de checkout no cabeçalho x-checkout-key e exigem a Recorrência ativa na conta. As rotas do link e da fatura não levam chave, porque o id no caminho identifica a cobrança.
  • Limite por IP: as consultas dividem um contador de 60 chamadas por minuto. Pagar a fatura e comprar pelo link dividem outro, de 10 por minuto, e criar a assinatura tem o próprio, também de 10. Acima do limite, a resposta é 429.
  • IP de quem chama: o limite e a análise antifraude usam o IP de quem chama, então chamadas feitas do seu servidor somam todos os compradores num IP só.
  • Valores: inteiros em centavos, como em Valores em dinheiro.
  • Nome da conta: as consultas trazem em merchant.display_name o nome de exibição da sua conta, para a página mostrar quem recebe. Sem nome cadastrado, ele vem null.

Libere o pedido com a fatura paga e o acesso com a assinatura active.

Leia a fatura paid na consulta ou no evento invoice.paid dos seus webhooks, e a assinatura active na consulta ou em subscription.activated. No cartão, o resultado vem na resposta do pagamento; no Pix, a fatura fica pending até o cliente pagar o QR Code.