Skip to main content
Lista links de checkout. Com OAT da organização pai (marketplace), você pode listar links da própria org e de todas as sub-organizações diretas vinculadas em organization_relationships, sem usar o token do filho. Veja exemplos completos em Marketplace: OAT da organização pai e sub-organizações.

​
Autenticação

Requer Organization Access Token (OAT) ou sessão de usuário com escopos adequados (checkout_links:read ou checkout_links:write, etc.).

​
Parâmetros de Query

​
organization_id
string
OAT de sub-organização / org única: filtra por uma organização (comportamento clássico).OAT da organização pai: opcional. Se omitido, a resposta inclui links cuja organization_id é a org do token ou qualquer filho direto. Se informado, deve ser o UUID da própria org do token ou de uma sub-organização da qual o token é pai direto; caso contrário retorna 403.
​
page
integer
default:"1"
Número da página
​
limit
integer
default:"100"
Itens por página (máx: 100)
​
sort_by
string
default:"created_at"
Campo de ordenação: created_at ou modified_at
​
sort_order
string
default:"desc"
asc ou desc
​
product_id
string
Filtra links associados a este produto (após o join interno)
​
is_archived
boolean
Quando true, lista links arquivados

​
Resposta

​
items
array
Lista de objetos de checkout link
​
pagination
object

​
Exemplo

curl -X GET "https://api.chargefy.io/api/v1/checkout-links/?page=1&limit=10" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"

​
Resposta de Exemplo

{
  "items": [
    {
      "id": "clink_abc123",
      "label": "Link Plano Pro",
      "url": "https://pay.chargefy.io/clink_abc123",
      "product_ids": ["prod_123"],
      "discount_id": null,
      "success_url": "https://meusite.com/obrigado",
      "cancel_url": null,
      "metadata": {},
      "created_at": "2026-03-10T14:00:00Z",
      "updated_at": "2026-03-10T14:00:00Z"
    }
  ],
  "pagination": {
    "total_count": 5,
    "max_page": 1
  }
}