Criar link de afiliado

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"}'

{
  "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"
}

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.

string

obrigatório

ID do programa.

string

obrigatório

ID da parceria ativa da afiliada que aceitou o programa.

string

obrigatório

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.

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"}'

{
  "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.

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"}'

{
  "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"
}

Fundamentos da API

MCP

Objetos de sistema

Webhooks e eventos

SDKs

Criar link de afiliado

Chargefy for Platforms

​Chargefy for Platforms

Chargefy for Platforms