Skip to main content

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 R2,00aR 2,00 a R 2.000,00.
  • Cartão: de R5,00aR 5,00 a 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.
Criar o link ainda não emite uma cobrança. Ela é preparada quando o cliente informa seu nome e escolhe a forma de pagamento. Depois dessa escolha, o método permanece vinculado ao link, inclusive em novas abas e tentativas simultâneas.

Experiência do cliente

O cliente abre https://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.
O prazo do link permite iniciar a cobrança. Depois de emitida, o Pix ou checkout tem seu próprio prazo, exibido quando informado pelo processamento. Expirar ou desativar um link não invalida um pagamento já emitido. Uma confirmação posterior continua sendo conciliada.

Criar pela API

Exige uma API key com permissão charges. Use read para listar. O header X-Master-Subaccount é opcional e vincula o crédito à subconta escolhida; sem ele, o valor pertence à operação principal.
O campo 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 com 409, 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.