Links de pagamento

Um payment_link (link de pagamento) é uma URL pública hospedada pela Chargefy para vender produtos e serviços sem integrar um formulário de pagamento no seu site. O objeto reúne a oferta, desconto automático, repasse de taxa e URLs de retorno. A experiência do checkout vem da configuração atual da organização. Ele é criado a partir de um conjunto de itens de preço (line_items) e continua no ar enquanto is_active for true. Qualquer pessoa com acesso à URL do link pode preencher os dados de pagamento e concluir a compra, o que gera uma checkout_session pra cada tentativa de finalização. Payment links não representam faturas existentes. Para cobrar ou exibir uma invoice já criada, use invoice.hosted_invoice_url, que pertence a uma única invoice e continua apontando pra ela depois do pagamento ou cancelamento.

Objeto payment_link

Este é o formato completo retornado em create, get, update, itens de list e em data.object dos webhooks payment.link.*.

{
  "id": "plink_wCUdffpmaJn84rdg",
  "object": "payment_link",
  "allow_discount_codes": false,
  "cancel_url": "https://meusite.com/cancelado",
  "created_at": "2026-05-19T18:00:00Z",
  "discount": null,
  "has_surcharge": false,
  "is_active": true,
  "label": "Curso de Programação",
  "line_items": [
    {
      "id": "pli_HEPGLaXVXM3Cmpun",
      "adjustable_quantity": {
        "enabled": false,
        "maximum": null,
        "minimum": null
      },
      "amount_discount": 0,
      "amount_subtotal": 9990,
      "amount_tax": 0,
      "amount_total": 9990,
      "currency": "brl",
      "description": "Mensalidade do Curso",
      "metadata": {},
      "position": 0,
      "price": "price_LqEqLm4dadr3zX5b",
      "price_data": null,
      "product": "prod_YpUzKVs1HsYHzu2w",
      "quantity": 1,
      "recurring_interval": "month",
      "recurring_interval_count": 1,
      "unit_amount": 9990
    }
  ],
  "livemode": true,
  "metadata": {},
  "payment_method_collection": "always",
  "subscription_data": {},
  "success_url": "https://meusite.com/sucesso",
  "updated_at": "2026-05-19T18:00:00Z",
  "url": "https://pay.chargefy.io/link/9a1bc3d2e4f5..."
}

string

Identificador único do link de pagamento. Usa o prefixo plink_*.

string

Sempre "payment_link".

boolean

Se o checkout das sessões geradas por este link mostra o campo de código de desconto (e aceita ?prefilled_promo_code=… na URL). Padrão: false.

string | null

A URL para onde o cliente será redirecionado se desistir da compra.

string

Data de criação em formato ISO 8601.

string | null

ID do desconto (dsct_*) fixado no link de pagamento, se houver.

boolean

Se true, o comprador cobre a taxa da organização: o total é acrescido do repasse para que a organização receba líquido o valor da venda. Veja Repassar a tarifa de venda ao comprador. Padrão: false.

boolean

Define se o link de pagamento está ativo e aceitando novas transações.

string | null

Rótulo amigável/título exibido no topo da página de checkout.

array

Lista de itens de preço que compõem o valor cobrado neste link.

Show Campos de line_items[]

string

Identificador único do item do link.

object

Configuração de quantidade ajustável no checkout.

Show Campos de adjustable_quantity

boolean

Se o comprador pode alterar a quantidade no checkout.

integer | null

Maior quantidade permitida, ou null quando não há limite máximo.

integer | null

Menor quantidade permitida, ou null quando não há limite mínimo.

integer

Descontos calculados para o item.

integer

Subtotal do item (unit_amount * quantity).

integer

Impostos calculados para o item.

integer

Total líquido do item em centavos.

string

Moeda, como brl.

string | null

Descrição do item exibida no checkout.

object

Metadados associados a este item.

integer

Ordem/posição do item no checkout.

string | null

ID do preço (price_*) associado.

object | null

Dados inline de preço caso não seja usado um preço salvo.

string | null

ID do produto (prod_*) associado.

integer

Quantidade do item fixada no link.

string | null

Intervalo de recorrência se for assinatura. Vem null em itens de compra única.

Valor	Descrição
`day`	Cobrança diária.
`week`	Cobrança semanal.
`month`	Cobrança mensal.
`year`	Cobrança anual.

integer | null

Multiplicador do intervalo de recorrência.

integer

Valor unitário do item em centavos.

boolean

true se gerado em produção; false se em testes.

object

Metadados customizados vinculados ao link. Retorna {} quando vazio.

string

Quando o checkout deve coletar um método de pagamento em links recorrentes. Pode ser "always" ou "if_required".

object

Configurações aplicadas à assinatura criada por um link recorrente. Sem configuração adicional, retorna o objeto vazio {}.

string | null

A URL para onde o cliente será redirecionado após o pagamento ser concluído com sucesso.

string | null

Data da última atualização em formato ISO 8601.

string

A URL pública compartilhável do checkout hospedado da Chargefy.

Operações

Eventos

Mudanças nesse objeto disparam os seguintes eventos:

O payload carrega o objeto payment_link completo em data.object.

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Links de pagamento

Objeto payment_link

Operações

Eventos

​Objeto payment_link

​Operações

​Eventos

Objeto payment_link

Operações

Eventos