Listar links de compra do produto

GET

/api/products/{{product_id}}/purchase-links

Autenticação

Esta rota exige Bearer Token (sua API Key) no header. Envie EXATAMENTE assim:

Substitua o valor após Bearer pela sua API Key real (vk_live_* produção, vk_test_* sandbox). Crie a chave em https://app.dotfy.com.br/dashboard/chaves-api. Sem o header → 401. Com chave inválida/revogada → 401. Com chave sem o escopo necessário → 403 insufficient_scope.

Escopo: products:read.

Lista os links de compra deste produto (isolados por conta), com paginação page/limit. Cada item traz paid (existe cobrança COMPLETED do link), paidAt e chargeId da cobrança que pagou, quando houver. createdVia indica a origem do link: API ou DASHBOARD.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff '/api/products/{{product_id}}/purchase-links?page=1&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

{
  "links": [
    {
      "id": "clplink0001",
      "url": "https://app.dotfy.com.br/checkout/curso-marketing-digital?pl=a1b2c3d4e5f60718293a4b5c6d7e8f901234567890abcdef",
      "customer": {
        "name": "Maria Silva",
        "email": "maria@exemplo.com",
        "phone": "5511999998888",
        "taxId": "12345678901"
      },
      "isActive": true,
      "createdVia": "API",
      "paid": true,
      "paidAt": "2026-07-02T12:34:56.000Z",
      "chargeId": "clch001",
      "createdAt": "2026-07-02T12:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}

Modificado em 2026-07-02 06:57:27

Página anterior

Criar link de compra (por comprador)

Próxima página

Detalhe/status do link de compra

Listar links de compra do produto

Autenticação#

Requisição

Respostas

Autenticação