Skip to main content
Gera um checkout com validade de 7 dias cujos dados do comprador são pré-preenchidos e bloqueados com as informações do cliente. Ideal para enviar via email ou WhatsApp para que o cliente conclua o pagamento sem precisar preencher seus dados novamente. O client_secret retornado é o token de acesso à sessão de checkout. A checkout_url já inclui esse token e pode ser compartilhada diretamente com o cliente.

​
Autenticação

Requer Organization Access Token (OAT) via header Authorization: Bearer. Escopos necessários: web:write ou customers:write. O cliente em :id pode pertencer a uma sub-organização: com OAT da organização pai, o acesso é permitido se o pai for pai direto da org do cliente. Veja Marketplace: OAT da organização pai e sub-organizações.

​
Parâmetros de Caminho

​
id
string
required
ID único interno do cliente no Chargefy para o qual o link será gerado.

​
Corpo da Requisição

​
product_id
string
required
ID do produto a ser cobrado no checkout.
​
custom_amount
number
Valor customizado em centavos (ex: 4990 para R$ 49,90). Quando informado, substitui o preço padrão do produto. Obrigatório quando cross_sell é fornecido, pois representa o total do bundle.
​
no_fees_installments
boolean
Quando true, as parcelas são oferecidas sem juros ao comprador. Opcional: se omitido ou null, o padrão é false. Se enviado, deve ser booleano (400 caso contrário).
​
due_date
string
Data da primeira cobrança no formato YYYY-MM-DD (apenas produtos recorrentes). Opcional: se omitido, vazio ou null, a API usa o dia atual em UTC como primeira cobrança e grava em recurrence_due_date nos metadados do checkout. Se informado, deve estar entre hoje e no máximo 2 meses à frente (calendário UTC).
​
subscription_title
string
Título personalizado para a assinatura que será criada a partir deste checkout. Substitui o nome padrão do produto.
​
cross_sell
object[]
Linhas de add-on do bundle. Cada objeto: product_id (UUID), name_snapshot (string), quantity opcional (padrão 1), product_price_id opcional, amount_cents opcional (total da linha em centavos; se omitido, usa preço de catálogo × quantidade).Total do checkout: se custom_amount não for enviado, o valor cobrado é preço do produto principal (preço padrão × assentos) + soma das linhas (cada linha: amount_cents ou unitário do catálogo × quantity). Se custom_amount for enviado, continua sendo o total declarado do bundle em centavos; a soma das linhas não pode ultrapassar esse total.
​
metadata
object
Metadados personalizados do integrador em formato chave-valor. Valores permitidos: string, number, boolean ou null. Máximo de 50 chaves. São mesclados com os metadados internos do servidor (os metadados internos têm precedência em caso de conflito de chaves).
​
success_url
string
URL de redirecionamento após o pagamento bem-sucedido. Deve começar com http:// ou https://. Também aceito como successUrl.
​
cancel_url
string
URL de redirecionamento quando o comprador abandona ou cancela o checkout. Deve começar com http:// ou https://. Também aceito como cancelUrl.
​
allow_discount_codes
boolean
Quando false, desabilita o campo de cupom de desconto na tela de checkout. Padrão: true. Também aceito como allowDiscountCodes.
​
recurrence_billing
string
Estratégia de cobrança recorrente (apenas para produtos recorrentes). Valores: zoop (padrão — cobrança automática via plano no gateway) ou manual (Chargefy gerencia as renovações). Também aceito como recurrenceBilling. Se omitido, assume zoop.

​
Resposta

​
client_secret
string
Token de acesso à sessão de checkout. Pode ser utilizado para construir a URL manualmente ou passado para o SDK de checkout.
​
checkout_url
string
URL completa e pronta para compartilhar com o cliente. O link expira em 7 dias a partir da criação.

​
Exemplo

Mínimo (integração): apenas product_id. Para assinatura, due_date e no_fees_installments não são obrigatórios — a primeira cobrança recorrente assume o dia UTC atual e parcelas com taxa seguem o padrão do checkout (no_fees_installments: false). 
curl -X POST "https://api.chargefy.io/api/v1/customers/cus_def456/checkout-link" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "prod_abc123"}'

​
Resposta de Exemplo

{
  "client_secret": "cs_live_eyJzdWIiOiJjdXNfZGVmNDU2IiwicHJvZCI6InByb2RfYWJjMTIzIn0",
  "checkout_url": "https://app.chargefy.com.br/checkout/cs_live_eyJzdWIiOiJjdXNfZGVmNDU2IiwicHJvZCI6InByb2RfYWJjMTIzIn0"
}