Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.usealpa.com/llms.txt

Use this file to discover all available pages before exploring further.

Antecipações permitem receber antes do prazo o saldo de transações de cartão parceladas que ainda estão em período de retenção. Disponível para contas com KYC aprovado.

​
Como funciona

Por padrão, transações de cartão são liberadas automaticamente:
  • À vista: 30 dias após a confirmação
  • Parceladas: uma parcela a cada 30 dias
Com uma antecipação, o merchant recebe o valor líquido das parcelas futuras imediatamente, descontada uma taxa de antecipação configurada pela plataforma.

​
Regras importantes

Somente uma antecipação pode estar pendente ou aprovada por vez. Tentativas de criar uma nova antecipação enquanto há uma em andamento retornam 409 Conflict.

​
Status da antecipação

StatusDescrição
PENDINGSolicitação criada — aguardando análise
APPROVEDAprovada — processamento em andamento
COMPLETEDConcluída — valor creditado na carteira
REJECTEDRejeitada pela plataforma
CANCELLEDCancelada pelo merchant antes da aprovação

​
Endpoints disponíveis

Todos os endpoints requerem autenticação via Bearer Token (JWT).
MétodoEndpointDescrição
GET/api/advances/Listar antecipações
GET/api/advances/:idObter detalhes de uma antecipação
POST/api/advances/Solicitar nova antecipação

Solicitar antecipação

Como criar uma solicitação de antecipação.

Listar antecipações

Consulte o histórico de solicitações.