Corvex API

Listar carrinhos abandonados

curl --request GET \
  --url https://apiv3.usecorvex.com.br/api/v1/abandoned-carts \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Store-Id: <x-store-id>'

const options = {
  method: 'GET',
  headers: {'X-Store-Id': '<x-store-id>', Authorization: 'Bearer <token>'}
};

fetch('https://apiv3.usecorvex.com.br/api/v1/abandoned-carts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apiv3.usecorvex.com.br/api/v1/abandoned-carts"

headers = {
    "X-Store-Id": "<x-store-id>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "abandonedCarts": [
      {
        "checkoutId": "77777777-7777-4777-8777-777777777777",
        "storeId": "11111111-1111-4111-8111-111111111111",
        "currentStep": "address",
        "total": 99.9,
        "subtotal": 99.9,
        "checkoutUrl": "https://loja.example.com/checkout/abc",
        "customer": {
          "name": "Ana Silva",
          "email": "ana@example.com",
          "phone": "11999999999",
          "documentNumber": "12345678901"
        },
        "itemsCount": 1,
        "items": [
          {
            "name": "Camiseta Preta",
            "quantity": 1,
            "price": 99.9
          }
        ],
        "firstSeenAt": "2026-09-23T18:00:00.000Z",
        "lastSeenAt": "2026-09-24T14:00:00.000Z",
        "traffic": {
          "utmSource": "google",
          "utmCampaign": "black-friday"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
}

{
  "success": false,
  "error": {
    "message": "X-Store-Id deve ser um UUID válido",
    "code": "VALIDATION_ERROR"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 400
  }
}

{
  "success": false,
  "error": {
    "message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
    "code": "AUTH_API_KEY_REQUIRED"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 401
  }
}

{
  "success": false,
  "error": {
    "message": "Sua API Key não tem o escopo necessário para esta operação.",
    "code": "AUTH_SCOPE_DENIED"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 403
  }
}

{
  "success": false,
  "message": "Muitas requisições. Tente novamente em instantes.",
  "error": "RATE_LIMITED",
  "retryAfter": 12
}

GET

api

abandoned-carts

Listar carrinhos abandonados

curl --request GET \
  --url https://apiv3.usecorvex.com.br/api/v1/abandoned-carts \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Store-Id: <x-store-id>'

const options = {
  method: 'GET',
  headers: {'X-Store-Id': '<x-store-id>', Authorization: 'Bearer <token>'}
};

fetch('https://apiv3.usecorvex.com.br/api/v1/abandoned-carts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apiv3.usecorvex.com.br/api/v1/abandoned-carts"

headers = {
    "X-Store-Id": "<x-store-id>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "abandonedCarts": [
      {
        "checkoutId": "77777777-7777-4777-8777-777777777777",
        "storeId": "11111111-1111-4111-8111-111111111111",
        "currentStep": "address",
        "total": 99.9,
        "subtotal": 99.9,
        "checkoutUrl": "https://loja.example.com/checkout/abc",
        "customer": {
          "name": "Ana Silva",
          "email": "ana@example.com",
          "phone": "11999999999",
          "documentNumber": "12345678901"
        },
        "itemsCount": 1,
        "items": [
          {
            "name": "Camiseta Preta",
            "quantity": 1,
            "price": 99.9
          }
        ],
        "firstSeenAt": "2026-09-23T18:00:00.000Z",
        "lastSeenAt": "2026-09-24T14:00:00.000Z",
        "traffic": {
          "utmSource": "google",
          "utmCampaign": "black-friday"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
}

{
  "success": false,
  "error": {
    "message": "X-Store-Id deve ser um UUID válido",
    "code": "VALIDATION_ERROR"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 400
  }
}

{
  "success": false,
  "error": {
    "message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
    "code": "AUTH_API_KEY_REQUIRED"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 401
  }
}

{
  "success": false,
  "error": {
    "message": "Sua API Key não tem o escopo necessário para esta operação.",
    "code": "AUTH_SCOPE_DENIED"
  },
  "meta": {
    "timestamp": "2026-09-24T14:00:00.000Z",
    "status": 403
  }
}

{
  "success": false,
  "message": "Muitas requisições. Tente novamente em instantes.",
  "error": "RATE_LIMITED",
  "retryAfter": 12
}

Authorizations

Authorization

string

header

required

API Key no formato cvx_live_..., criada no painel Corvex. Não use JWT de sessão nem x-api-key.

Headers

X-Store-Id

string<uuid>

required

UUID da loja. A chave precisa ter esta loja autorizada.

Query Parameters

page

integer

default:1

limit

integer

default:20

Required range: x <= 100

currentStep

enum<string>

Available options:

personal_info,

address,

payment_method,

payment_confirmation

string

Response

Lista de carrinhos.

Visão geral

Fundamentos

Checkout externo

Catálogo

Pedidos e entrega

Clientes

Marketing

Webhooks

Automações

Listar carrinhos abandonados

Authorizations

Headers

Query Parameters

Response