Payments
Get Payment Status
Check the current status of a payment by its public UUID using GET /stores//payments/status/.
GET
Get payment status
📌 Endpoint
GET /stores/{storeId}/payments/status/{uuid}
Returns the current status of a store payment by its public uuid. Ideal for checkout polling after generating a PIX or boleto charge.
🔐 Authentication
- Public route (no
Authorizationheader required). - The store linked to
storeIdmust have an active plan.
🧾 Path parameters
✅ Request example
📦 Success response (200)
payment.status values: PENDING, APPROVED, REJECTED, CANCELLED, REFUNDED, CHARGED_BACK, EXPIRED.
⚠️ Possible errors
400 INVALID_DATA→ invalidstoreIdoruuidis not a valid UUID401 UNAUTHENTICATED→ store without an associated owner or unavailable database connection403 NO_ACTIVE_SUBSCRIPTION→ store has no active plan or plan expired404 STORE_NOT_FOUND→ store not found404 PAYMENT_NOT_FOUND→ payment not found in this store429 RATE_LIMIT_EXCEEDED→ plan per-minute rate limit exceeded503 SERVICE_UNAVAILABLE→ service temporarily unavailable