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

# Criar link de afiliado

> Cria um link de indicação para uma afiliada que aceitou o programa.

Cria um link compartilhável para uma participação ativa. O link usa o percentual e a duração que a afiliada aceitou. Publicar outras condições depois não altera esse acordo.

A oferta precisa estar ativa, no mesmo ambiente e conter somente preços do produto do programa. Adicionais de outro produto são recusados. Configure a oferta com `affiliates: null` para aceitar indicações; a operação não altera essa escolha por conta própria.

**id** `string` *required*

ID do programa.

**affiliation** `string` *required*

ID da parceria ativa da afiliada que aceitou o programa.

**payment\_link** `string` *required*

ID da oferta do produto.

Use uma API key da organização com escopo de escrita e uma `Idempotency-Key`. Repetir a associação da mesma participação e oferta devolve o mesmo link.

```bash cURL theme={"theme":"css-variables"}
curl -X POST "https://api.chargefy.io/v1/affiliate-programs/afp_7Dk9mQ2vX5rT8pWN/links" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: indicacao-sandy-curso" \
  -d '{"affiliation":"aff_7Dk9mQ2vX5rT8pWN","payment_link":"plink_7Dk9mQ2vX5rT8pWN"}'
```

```json 200 theme={"theme":"css-variables"}
{
  "id": "afl_7Dk9mQ2vX5rT8pWN",
  "object": "affiliate_link",
  "affiliation": "aff_7Dk9mQ2vX5rT8pWN",
  "created_at": "2026-10-27T12:00:00Z",
  "livemode": true,
  "payment_link": "plink_7Dk9mQ2vX5rT8pWN",
  "program": "afp_7Dk9mQ2vX5rT8pWN",
  "url": "https://pay.chargefy.io/link/8a1e74c38e016eff9862374918b493c208f175cf164cad19f70c6be913b286789?affiliate_link=afl_7Dk9mQ2vX5rT8pWN"
}
```

No checkout que aceita indicação, um cupom válido associado a uma afiliada tem prioridade sobre o último clique válido. Uma seleção explícita de afiliados na oferta tem prioridade sobre ambos; `affiliates: []` desliga a indicação automática. O prazo aceito vale também para outra oferta do mesmo produto e ambiente no mesmo navegador.

Nas assinaturas, o limite conta períodos com fatura emitida e valor a cobrar, incluindo a primeira. Fatura zerada por gratuidade ou crédito integral não consome o limite. Nova tentativa ou ajuste do mesmo período não conta novamente. Pagar depois não muda o acordo de uma fatura já emitida.

## Chargefy for Platforms

Uma plataforma usa sua API key e o header `Organization` da organização conectada dona do produto. A organização deve estar ativa na rede; produto, oferta e programa pertencem à mesma organização e ao mesmo modo.


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