Carrinhos abandonados da comunidade

GET/api/abandoned-carts

Auth: Requiere token
Quién puede:: owner; admin; moderator; finance
Clave de API:: sales:read
X-CommunityId: X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.

Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

Monetização › Vendas › Abandonados: quem abriu o checkout de um produto pago e não comprou em 60 minutos (`ABANDONED`), e quem pagou até 7 dias depois disso (`RECOVERED`), mais novo primeiro (`abandonedAt`). Cada item: o contato do membro (`member.name`, `member.email`, `member.phone` e `member.phoneCountry` quando o perfil tem), `product` (`id`, `title`, `billingInterval`), `plan` (`id`, `name`) quando o produto é opção de um plano, `amount` e `currency` (o preço quando o checkout foi aberto pela última vez), `paymentMethod` (o do último pedido, `null` se não chegou a escolher), `abandonedAt`, `recoveredAt` e `recoveredAmount` (quanto voltou), `emailSent` e `emailSentAt` (o e-mail de recuperação, ver `abandonedCartEmailEnabled` em `PUT /api/notification-settings`).

Filtros: `productId`, `planId`, `status` (`ABANDONED` ou `RECOVERED`; sem ele, os dois), `from`/`to` (período de `abandonedAt`, ISO 8601) e `search` (nome ou e-mail). Paginação `page`/`limit` (até 100). O carrinho é apagado 90 dias depois do abandono, e quando o membro sai ou é removido da comunidade.

Só owner, admin e finance da comunidade do `X-CommunityId`; moderador e membro recebem 403. Os carrinhos são sempre os dessa comunidade.

Parámetros

Nombre	Dónde	Tipo
`productId`opcional	query	`string (uuid)`
`planId`opcional	query	`string (uuid)`
`status`opcional	query	`ABANDONED \| RECOVERED`
`from`opcional	query	`string (date-time)`
`to`opcional	query	`string (date-time)`
`search`opcional	query	`string`
`page`opcional	query	`integer`
`limit`opcional	query	`integer`

Headers

Nombre	Tipo	Descripción
`X-CommunityId`opcional	`string (uuid)`	ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respuestas

Código	Descripción
`200`	Carrinhos e paginação.
`400`	Requisição inválida — falha de validação.
`401`	Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`).
`403`	Autenticado, mas sem permissão para esta operação.
`500`	Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/abandoned-carts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"