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

# Links de pagamento

> Checkout hospedado para PIX, boleto e cartão.

Crie e compartilhe links de pagamento com seus clientes. O link direciona para uma página de checkout com os produtos selecionados.

## Formas de vincular produtos aos links de pagamento

## 1. Usando produto já cadastrado

Informe o `externalId` de um produto existente no catálogo:

```json theme={null}
{
  "products": [
    { "externalId": "SKU-001", "quantity": 2 }
  ]
}
```

## 2. Criando produto na hora

Informe os dados do produto diretamente, sem precisar cadastrar antes:

```json theme={null}
{
  "products": [
    { "name": "Produto X", "value": 49.90, "quantity": 1 }
  ]
}
```

## Vincular um cliente (opcional)

Você pode vincular um `customer` ao link informando `fullName` e `document`. Quando vinculado, os dados do cliente **já aparecem preenchidos automaticamente na página de checkout**, agilizando o pagamento.

```json theme={null}
{
  "customer": {
    "fullName": "Maria Silva",
    "document": "12345678900"
  }
}
```

## Limite de pagamentos (opcional)

Use `paymentLimit` para definir quantas vezes o link pode ser pago. **Use `0` ou omita o campo para não limitar** (pagamentos ilimitados).

## Métodos de Pagamento Aceitos

| Método | Descrição |
| - | - |
| `PIX_IN` | Pagamento via PIX |
| `CARD` | Pagamento via cartão de crédito |
| `BOLETO` | Pagamento via boleto bancário |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.