Saltar al contenido principal
GET
Get payment status

📌 Endpoint

GET /stores/{storeId}/payments/status/{uuid} Devuelve el estado actual de un pago de la tienda a partir de su uuid público. Ideal para hacer polling en el checkout después de generar un PIX o boleto.

🔐 Autenticación

  • Ruta pública (no requiere Authorization).
  • La tienda asociada a storeId debe tener un plan activo.

🧾 Parámetros de ruta


✅ Ejemplo de solicitud


📦 Respuesta exitosa (200)

Valores posibles para payment.status: PENDING, APPROVED, REJECTED, CANCELLED, REFUNDED, CHARGED_BACK, EXPIRED.

⚠️ Posibles errores

  • 400 INVALID_DATA → storeId inválido o uuid no es un UUID válido
  • 401 UNAUTHENTICATED → tienda sin propietario asociado o conexión no disponible
  • 403 NO_ACTIVE_SUBSCRIPTION → tienda sin plan activo o plan expirado
  • 404 STORE_NOT_FOUND → tienda no encontrada
  • 404 PAYMENT_NOT_FOUND → pago no encontrado en esta tienda
  • 429 RATE_LIMIT_EXCEEDED → límite de solicitudes por minuto del plan excedido
  • 503 SERVICE_UNAVAILABLE → servicio temporalmente no disponible

Parámetros de ruta

storeId
string
requerido
Required string length: 1 - 50
uuid
string<uuid>
requerido

Respuesta

Payment status retrieved successfully.

code
string
requerido
Ejemplo:

"PAYMENT_STATUS"

payment
object
requerido