Introdução

Esta é a API v1, versão atual e estável da 4Selet Pay. A v2 está em desenvolvimento e aparecerá como “Em breve” no seletor de versão.

O que é a 4Selet Pay API?

A API da 4Selet Pay permite que você integre processamento de pagamentos diretamente na sua aplicação. Com ela você pode:

Criar e gerenciar cobranças via Cartão de Crédito, PIX e PayPal
Configurar assinaturas recorrentes com controle de ciclos, descontos e faturas
Consultar e reprocessar pedidos e seus desafios de confirmação (3DS, OTP)
Quitar faturas em atraso de assinaturas existentes

Todos os endpoints da v1 estão sob o prefixo:

https://sua-api.com/api/v1

A API usa Bearer Token JWT via Laravel Passport. Obtenha seu token com POST /v1/login e inclua-o em todas as requisições autenticadas:

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...

Consulte a seção Autenticação para detalhes sobre como obter e renovar tokens.

Todas as respostas seguem o padrão:

{
  "success": true,
  "data": { ... },
  "message": null
}

Em caso de erro:

{
  "success": false,
  "data": null,
  "message": "Descrição do erro"
}

Recurso	Descrição
Autenticação	Login, criação de usuário e gerenciamento de tokens
Cobranças	Pagamentos únicos via Cartão de Crédito, PIX ou PayPal
Pedidos	Consulta de pedidos e fluxo de confirmação (3DS / OTP)
Assinaturas	Cobranças recorrentes com ciclos, faturas e troca de cartão
Faturas	Quitação de faturas de assinaturas em atraso

Status	Significado
`200`	Sucesso
`401`	Não autenticado — token ausente ou inválido
`403`	Acesso negado — permissão insuficiente
`404`	Recurso não encontrado
`422`	Dados inválidos — verifique os campos obrigatórios
`429`	Rate limit atingido
`500`	Erro interno do servidor