Pagos
Buscar Pagos
Aprende a listar los pagos de una tienda usando el endpoint GET /stores//payments.
GET
List payments
📌 Endpoint
GET /stores/{storeId}/payments
Devuelve los pagos vinculados a la tienda.
🔐 Autenticación
- Ruta privada.
- Requiere header
Authorizationcon tu API key y plan activo.
🧾 Parámetros de ruta
✅ Ejemplo de solicitud
🔎 Query params
🔄 Paginación por cursor
Para listas grandes (más de ~100 elementos), prefiere la paginación por cursor en lugar depage:
- Realiza la primera llamada sin
cursor. - Si
hasMoreestrue, la respuesta trae el camponextCursor. - Envía ese
nextCursoren el parámetrocursorde la siguiente solicitud para buscar la página siguiente.
nextCursor, hasMore y limit:
cursorypageno pueden usarse juntos (400 INVALID_PAGINATION).nextCursor: nullconhasMore: falseindican el fin de la lista (la API responde200con array vacío).
Snippet estándar (cURL)
Usa el ejemplo cURL de la sección Ejemplo de solicitud anterior como snippet oficial.📦 Respuesta de éxito (200)
La primera llamada (sincursor) ya devuelvenextCursoryhasMoreen la paginación, permitiendo iniciar la paginación por cursor sin llamadas extras.
⚠️ Posibles errores
400 INVALID_DATA→ parámetros inválidos400 INVALID_PAGINATION_LIMIT→limitfuera del intervalo permitido (1a100)400 INVALID_PAGINATION_PAGE→pageinválida400 INVALID_PAGINATION_CURSOR→cursorinválido o malformado400 INVALID_PAGINATION→pageycursorusados juntos401 API_KEY_NOT_PROVIDED→ headerAuthorizationno enviado401 INVALID_API_KEY→ API key inválida401 UNAUTHENTICATED→ usuario no autenticado403 USER_DISABLED→ usuario desactivado o eliminado403 NO_ACTIVE_SUBSCRIPTION→ plan inactivo o expirado404 STORE_NOT_FOUND→ tienda no encontrada429 RATE_LIMIT_EXCEEDED→ límite de solicitudes por minuto del plan excedido500 INTERNAL_SERVER_ERROR→ error interno503 SERVICE_UNAVAILABLE→ servicio temporalmente no disponible