Pagamentos
Consultar Status do Pagamento
Consulta o status atual de um pagamento pelo UUID público usando o endpoint GET /stores//payments/status/.
GET
Get payment status
📌 Endpoint
GET /stores/{storeId}/payments/status/{uuid}
Retorna o status atual de um pagamento específico da loja a partir do uuid público. Ideal para polling no checkout após gerar um PIX ou boleto.
🔐 Autenticação
- Rota pública (não exige
Authorization). - A loja vinculada ao
storeIdprecisa estar com plano ativo.
🧾 Parâmetros de rota
✅ Exemplo de requisição
📦 Resposta de sucesso (200)
payment.status: PENDING, APPROVED, REJECTED, CANCELLED, REFUNDED, CHARGED_BACK, EXPIRED.
⚠️ Possíveis erros
400 INVALID_DATA→storeIdinválido ouuuidnão é um UUID válido401 UNAUTHENTICATED→ loja sem proprietário associado ou conexão indisponível403 NO_ACTIVE_SUBSCRIPTION→ loja sem plano ativo ou plano expirado404 STORE_NOT_FOUND→ loja não encontrada404 PAYMENT_NOT_FOUND→ pagamento não encontrado nesta loja429 RATE_LIMIT_EXCEEDED→ limite de requisições por minuto do plano excedido503 SERVICE_UNAVAILABLE→ serviço temporariamente indisponível