Skip to main content
Um link de pagamento é uma URL própria que você compartilha (WhatsApp, e-mail, redes) e o comprador abre para pagar — sem você precisar construir um checkout. A Autorizou hospeda a página de pagamento, processa Pix, boleto e cartão (com parcelas), e te avisa por webhook quando a venda é aprovada. Você pode criar e gerenciar links de duas formas, com o mesmo resultado:

Pela API

POST /payment-links — ideal para ERPs e automações: crie o link no seu sistema e receba a url pronta para compartilhar.

Pelo painel

Crie e acompanhe links pela Dashboard, sem código.

​
Como funciona

  1. Você cria o link — com valor fixo ou definido pelo comprador, métodos aceitos, parcelas, validade etc.
  2. Compartilha a url — a Autorizou serve a página de checkout no endereço link.autorizou.dev/p/{hash}.
  3. O comprador paga — o checkout é público (resolvido pelo próprio link), com Pix, boleto ou cartão.
  4. Você é notificado — quando a venda é aprovada, disparamos payment.authorized no seu webhook; o comprador recebe o recibo por e-mail (se habilitado).

​
Criando pela API

Envie os parâmetros do link para POST /payment-links. O link nasce escopado ao seu lojista (resolvido pela sua chave de API) — você não envia merchant_id. 
curl -X POST "https://pay.autorizou.dev/api/v1/payment-links" \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Consultoria — Plano Premium",
    "amount_type": "fixed",
    "amount": 19900,
    "payment_methods": ["pix", "credit_card"],
    "max_installments": 12,
    "send_email_receipt": true
  }'
A resposta traz a url para compartilhar e o hash do link: 
{
  "uuid": "9b2c...",
  "hash": "AUTLNK01KW2P8M4Q7K3M9QP",
  "url": "https://link.autorizou.dev/p/AUTLNK01KW2P8M4Q7K3M9QP",
  "title": "Consultoria — Plano Premium",
  "amount_type": "fixed",
  "amount": 19900,
  "status": "active",
  "payment_methods": ["pix", "credit_card"]
}
Precisa que o comprador informe o valor (doação, “pague o quanto quiser”)? Use amount_type: "customer_defined" e omita amount.

​
Valor fixo × definido pelo comprador

​
amount_type
string
required
  • fixed — o valor é fixo; envie amount (em centavos, mínimo 500).
  • customer_defined — o comprador digita o valor na página de pagamento.

​
Métodos, parcelas e juros

  • payment_methods — lista dos métodos aceitos (pix, credit_card, debit_card, bank_slip).
  • max_installments — máximo de parcelas no cartão (1 a 12).
  • interest_mode — none (sem juros) ou installments (juros por parcela, conforme a tabela do lojista).
  • interest_free_installments — até quantas parcelas ficam sem juros.
Quando bank_slip (boleto) está entre os métodos, o endereço do comprador passa a ser obrigatório no checkout (require_address é forçado para true).

​
Recibo por e-mail

Com send_email_receipt: true, o comprador recebe um recibo transacional por e-mail assim que o pagamento é aprovado — com o valor, a forma de pagamento e o código do recibo. É um comprovante da compra (não é marketing).

​
Notificação da venda (webhook)

Configure notification_url no link (ou um webhook global) para ser avisado das transições da venda. O evento principal é payment.authorized (venda aprovada). Veja Eventos de Webhook e Configuração de Webhooks.

Criar

POST /payment-links

Listar

GET /payment-links

Consultar

GET /payment-links/{uuid}

Desativar

DELETE /payment-links/{uuid}
Desativar não apaga o link nem as vendas já feitas — só impede novos pagamentos (o link deixa de ser pagável). Um link também deixa de pagar ao expirar (expires_at) ou ao atingir max_payments.

​
Conciliação

As vendas feitas por link aparecem na listagem de pagamentos como qualquer outra — concilie por status, período e referência. O split configurado da conta também se aplica às vendas por link (canal link); veja Split de Pagamento.