> ## 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.

# Links de Pagamento

> Cobre sem escrever uma linha de checkout — um link que você compartilha e o comprador paga

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:

<CardGroup cols={2}>
  <Card title="Pela API" icon="code" href="/api-reference/payment-links/create-payment-link">
    `POST /payment-links` — ideal para ERPs e automações: crie o link no seu sistema e receba a `url`
    pronta para compartilhar.
  </Card>

  <Card title="Pelo painel" icon="browser" href="https://dash.autorizou.com.br">
    Crie e acompanhe links pela Dashboard, sem código.
  </Card>
</CardGroup>

## Como funciona

```mermaid theme={null}
flowchart LR
    A[Você cria o link] -->|API ou painel| B[URL: link.autorizou.dev/p/HASH]
    B --> C[Comprador abre e paga]
    C --> D[Pix / Boleto / Cartão]
    D --> E[Aprovado]
    E --> F[Webhook payment.authorized]
    E --> G[Recibo por e-mail ao comprador]
```

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](/api-reference/webhooks/events); o comprador recebe o **recibo por e-mail** (se habilitado).

## Criando pela API

Envie os parâmetros do link para [`POST /payment-links`](/api-reference/payment-links/create-payment-link).
O link nasce **escopado ao seu lojista** (resolvido pela sua chave de API) — você não envia `merchant_id`.

```bash 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,
    "send_email_receipt": true
  }'
```

A resposta traz a **`url`** para compartilhar e o **`hash`** do link:

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

<Tip>
  Precisa que o **comprador** informe o valor (doação, "pague o quanto quiser")? Use
  `amount_type: "customer_defined"` e omita `amount`.
</Tip>

## Valor fixo × definido pelo comprador

<ParamField body="amount_type" 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.
</ParamField>

## 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**.

<Note>
  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`).
</Note>

## 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](/api-reference/webhooks/events) e
[Configuração de Webhooks](/api-reference/webhooks/configuration).

## Ciclo de vida do link

<CardGroup cols={2}>
  <Card title="Criar" icon="plus">
    [`POST /payment-links`](/api-reference/payment-links/create-payment-link)
  </Card>

  <Card title="Listar" icon="list">
    [`GET /payment-links`](/api-reference/payment-links/list-payment-links)
  </Card>

  <Card title="Consultar" icon="magnifying-glass">
    [`GET /payment-links/{uuid}`](/api-reference/payment-links/get-payment-link)
  </Card>

  <Card title="Desativar" icon="ban">
    [`DELETE /payment-links/{uuid}`](/api-reference/payment-links/deactivate-payment-link)
  </Card>
</CardGroup>

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](/partner-visibility) 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](/casos-uso/split-pagamento).