Página de pagamento hospedada

Toda fatura e depósito tem uma página de pagamento pronta. Envie ao cliente o payment_url retornado pela API assim que o endereço estiver disponível.

A página mostra o token, a rede, o endereço, o QR code e o status do pagamento. Você não precisa criar uma página de pagamento por conta própria.

Envie o link de pagamento

Use payment_url exatamente como retornado. Não construa uma URL a partir do ID da issuance nem presuma um formato fixo para public_id.

O cliente deve enviar o token exibido na rede exibida. Enviar um token diferente ou usar uma rede diferente não paga a fatura.

Defina o nome e o logotipo da loja

Edite a marca no painel ou use uma sessão de proprietário:

PATCH /api/v1/shops/{shop_id}/branding
Authorization: Bearer <owner-session-token>
Idempotency-Key: <saved-unique-key>
Content-Type: application/json

{"name":"My shop"}

A marca controla o nome e o logotipo exibidos da loja. Defina o return_url de um pagamento ao criar a fatura ou o depósito. Nenhum dos dois altera o destinatário do repasse.

Confirme o pagamento no seu servidor

O link de retorno serve para navegação. Um cliente que o abre não é prova de pagamento.

Use Status de fatura e depósito para ler o status a partir do seu back-end, ou verifique um webhook assinado. Mantenha as chaves de API no servidor; nunca as coloque no link de pagamento ou em código de navegador.