Skip to main content
POST
/
api
/
v1
/
payment-links
Criar Link de Pagamento
curl --request POST \
  --url https://pay.autorizou.dev/api/v1/payment-links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "amount_type": "<string>",
  "amount": 123,
  "payment_methods": [
    {}
  ],
  "description": "<string>",
  "max_installments": 123,
  "interest_mode": "<string>",
  "interest_free_installments": 123,
  "card_capture": true,
  "boleto_expiration_days": 123,
  "pix_expiration_minutes": 123,
  "expires_at": "<string>",
  "max_payments": 123,
  "collect_phone": true,
  "require_address": true,
  "soft_descriptor": "<string>",
  "notification_url": "<string>",
  "send_email_receipt": true,
  "logo_url": "<string>",
  "brand_color": "<string>"
}
'
Cria um link de pagamento — uma URL própria onde o comprador paga (Pix, boleto ou cartão). O link nasce escopado ao lojista da sua chave de API; você não envia merchant_id. A resposta traz a url para compartilhar. Veja o guia em Links de Pagamento.

​
Parâmetros

​
title
string
required
Título do link (aparece no checkout). Máx. 255 caracteres.
​
amount_type
string
required
fixed (valor fixo — envie amount) ou customer_defined (o comprador digita o valor).
​
amount
integer
Valor em centavos. Obrigatório quando amount_type = fixed. Mínimo 500 (R$ 5,00).
​
payment_methods
array
required
Métodos aceitos (mínimo 1): pix, credit_card, debit_card, bank_slip.
​
description
string
Descrição opcional exibida no checkout.
​
max_installments
integer
Máximo de parcelas no cartão (1 a 12).
​
interest_mode
string
none (sem juros) ou installments (juros por parcela, conforme a tabela do lojista).
​
interest_free_installments
integer
Até quantas parcelas ficam sem juros (1 a 12).
​
card_capture
boolean
Captura automática do cartão. Padrão: true.
​
boleto_expiration_days
integer
Validade do boleto em dias (1 a 60).
​
pix_expiration_minutes
integer
Validade do QR Pix em minutos (5 a 1440).
​
expires_at
string
Data/hora de expiração do link (ISO 8601, no futuro). Depois disso o link não paga mais.
​
max_payments
integer
Número máximo de pagamentos aceitos pelo link. Atingido o limite, o link deixa de ser pagável.
​
collect_phone
boolean
Coletar o telefone do comprador no checkout.
​
require_address
boolean
Exigir endereço do comprador. É forçado para true quando bank_slip está entre os métodos.
​
soft_descriptor
string
Texto que aparece na fatura do cartão do comprador. Máx. 22 caracteres.
​
notification_url
string
URL de webhook específica deste link (além dos webhooks globais). Deve ser HTTPS e pública.
​
send_email_receipt
boolean
Enviar recibo por e-mail ao comprador quando o pagamento for aprovado.
​
logo_url
string
URL do logo exibido no checkout. Máx. 255 caracteres.
​
brand_color
string
Cor de destaque do checkout (hex). Máx. 9 caracteres.
cURL
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,
    "interest_mode": "none",
    "send_email_receipt": true
  }'

​
Resposta

{
  "uuid": "9b2c1f7a-3e4d-4a8b-9c1d-2f3e4a5b6c7d",
  "hash": "AUTLNK01KW2P8M4Q7K3M9QP",
  "url": "https://link.autorizou.dev/p/AUTLNK01KW2P8M4Q7K3M9QP",
  "title": "Consultoria — Plano Premium",
  "amount_type": "fixed",
  "amount": 19900,
  "payment_methods": ["pix", "credit_card"],
  "max_installments": 12,
  "interest_mode": "none",
  "status": "active",
  "send_email_receipt": true,
  "created_at": "2026-07-03 13:10:00"
}
Compartilhe o campo url com o comprador. O checkout é público (resolvido pelo hash do link) — não exige a chave de API.