Criar no painel
Abra Pagamentos → Links de pagamento → Criar link. Informe um nome, valor, descrição opcional, os métodos aceitos e a validade para iniciar o pagamento. Copie o endereço gerado e envie ao seu cliente.- Pix: de R 2.000,00.
- Cartão: de R 2.000,00. O valor também deve superar a taxa da conta.
- Validade para iniciar: entre 1 e 168 horas; o painel oferece 1 hora, 24 horas e 7 dias.
- Cada link aceita um único pagamento. Para uma nova venda, crie outro link.
Experiência do cliente
O cliente abrehttps://www.pagmaster.site/pay/IDENTIFICADOR_PUBLICO sem precisar de conta na Pagmaster. O valor e a descrição vêm do servidor e não podem ser alterados pelo navegador.
No Pix, a página mostra o QR Code e o código copia e cola. No cartão, ela abre o checkout seguro em outra aba: a Pagmaster não coleta número completo do cartão, CVV ou validade do cartão nessa página. O cliente pode acompanhar a confirmação na página do link.
O status segue a confirmação financeira existente: polling autenticado de conciliação no backend, com primeira consulta agendada após um segundo e acompanhamento enquanto pendente ou incerto. O navegador consulta a atualização a cada segundo enquanto visível. Abrir o link ou clicar em pagar não confirma o pagamento.
Criar pela API
Exige uma API key com permissão charges. Use read para listar. O headerX-Master-Subaccount é opcional e vincula o crédito à subconta escolhida; sem ele, o valor pertence à operação principal.
url é compartilhável e funciona como uma credencial para consultar somente essa cobrança. Não publique links de clientes em logs ou páginas indexadas. A página pública não expõe e-mail, saldo, taxas da conta ou outros pagamentos.
Repetir requestKey com os mesmos campos devolve o mesmo link e preserva a validade original. Alterar os campos com a mesma referência retorna 409. Um timeout não deve levar à geração de outra referência: repita a original para consultar a criação.
Listar e acompanhar
GET /api/v1/public/payment-links?page=1 retorna links, total, page e pageSize (20). O resultado pertence à conta e ao contexto de subconta selecionado. O paymentId aparece quando a cobrança é emitida e pode ser consultado em GET /api/v1/public/payments/{id} com o mesmo contexto.
No painel, Atualizar busca os status atuais. Os pagamentos também aparecem no histórico financeiro normal e geram os eventos de webhook já documentados. Não existe um evento de crédito separado para o link: o mesmo pagamento é contabilizado uma única vez.
Desativar e lidar com falhas
O painel permite desativar um link que ainda não foi iniciado. Depois de escolhida a forma de pagamento, a desativação é recusada com409, para não aparentar o cancelamento de uma cobrança emitida.
Pausas globais de Pix ou cartão, limites e taxas da conta continuam sendo aplicados no momento da emissão. Uma criação incerta de cartão nunca gera automaticamente um segundo checkout. Um método já escolhido não é trocado para contornar uma falha; consulte o status antes de emitir outro link.