> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autorizou.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar Link de Pagamento

> Cria um link de pagamento compartilhável, escopado ao seu lojista

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](/casos-uso/links-de-pagamento).

## Parâmetros

<ParamField body="title" type="string" required>
  Título do link (aparece no checkout). Máx. 255 caracteres.
</ParamField>

<ParamField body="amount_type" type="string" required>
  `fixed` (valor fixo — envie `amount`) ou `customer_defined` (o comprador digita o valor).
</ParamField>

<ParamField body="amount" type="integer">
  Valor em **centavos**. Obrigatório quando `amount_type = fixed`. Mínimo `500` (R\$ 5,00).
</ParamField>

<ParamField body="payment_methods" type="array" required>
  Métodos aceitos (mínimo 1): `pix`, `credit_card`, `debit_card`, `bank_slip`.
</ParamField>

<ParamField body="description" type="string">
  Descrição opcional exibida no checkout.
</ParamField>

<ParamField body="max_installments" type="integer">
  Máximo de parcelas no cartão (1 a 12).
</ParamField>

<ParamField body="interest_mode" type="string">
  `none` (sem juros) ou `installments` (juros por parcela, conforme a tabela do lojista).
</ParamField>

<ParamField body="interest_free_installments" type="integer">
  Até quantas parcelas ficam sem juros (1 a 12).
</ParamField>

<ParamField body="card_capture" type="boolean">
  Captura automática do cartão. Padrão: `true`.
</ParamField>

<ParamField body="boleto_expiration_days" type="integer">
  Validade do boleto em dias (1 a 60).
</ParamField>

<ParamField body="pix_expiration_minutes" type="integer">
  Validade do QR Pix em minutos (5 a 1440).
</ParamField>

<ParamField body="expires_at" type="string">
  Data/hora de expiração do link (ISO 8601, no futuro). Depois disso o link não paga mais.
</ParamField>

<ParamField body="max_payments" type="integer">
  Número máximo de pagamentos aceitos pelo link. Atingido o limite, o link deixa de ser pagável.
</ParamField>

<ParamField body="collect_phone" type="boolean">
  Coletar o telefone do comprador no checkout.
</ParamField>

<ParamField body="require_address" type="boolean">
  Exigir endereço do comprador. É forçado para `true` quando `bank_slip` está entre os métodos.
</ParamField>

<ParamField body="soft_descriptor" type="string">
  Texto que aparece na fatura do cartão do comprador. Máx. 22 caracteres.
</ParamField>

<ParamField body="notification_url" type="string">
  URL de webhook específica deste link (além dos webhooks globais). Deve ser HTTPS e pública.
</ParamField>

<ParamField body="send_email_receipt" type="boolean">
  Enviar recibo por e-mail ao comprador quando o pagamento for aprovado.
</ParamField>

<ParamField body="logo_url" type="string">
  URL do logo exibido no checkout. Máx. 255 caracteres.
</ParamField>

<ParamField body="brand_color" type="string">
  Cor de destaque do checkout (hex). Máx. 9 caracteres.
</ParamField>

```bash cURL theme={null}
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

```json theme={null}
{
  "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"
}
```

<Note>
  Compartilhe o campo **`url`** com o comprador. O checkout é público (resolvido pelo `hash` do link) —
  não exige a chave de API.
</Note>