{"info":{"name":"Servicio Crédito Móvil SBN — API · v1.5.0","description":"Colección generada automáticamente desde /openapi.json.\n\n1. Elija el entorno «SBN Sandbox» (o cree uno para producción).\n2. Ponga su token en la variable `token`.\n3. Empiece por «Identidad, scopes y límites» para confirmar que el token funciona.\n\nEl token viaja como Bearer heredado a nivel de colección: no hay que ponerlo en cada request.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{token}}","type":"string"}]},"variable":[{"key":"base_url","value":"https://sandbox-api-recargas.sbn.mx","type":"string"},{"key":"token","value":"sb_test_reemplace_por_su_token","type":"string"}],"item":[{"name":"Estado","item":[{"name":"Estado del servicio y sus dependencias","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/status","host":["{{base_url}}"],"path":["v1","status"]},"description":"Público, sin token. Úselo como sonda de disponibilidad antes de operar.","auth":{"type":"noauth"}}}]},{"name":"Webhooks","item":[{"name":"Catálogo de eventos de webhook","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/webhooks/events","host":["{{base_url}}"],"path":["v1","webhooks","events"]},"description":"Eventos que puede recibir. Configuración y verificación de firma: guía 09 de la documentación de integración.","auth":{"type":"noauth"}}}]},{"name":"Empresa","item":[{"name":"Identidad, scopes y límites de la empresa autenticada","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/me","host":["{{base_url}}"],"path":["v1","me"]},"description":"Primer llamado recomendado: confirma que el token funciona y con qué permisos."}}]},{"name":"Saldo","item":[{"name":"Saldo disponible y retenido","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/balance","host":["{{base_url}}"],"path":["v1","balance"]},"description":"Requiere scope `balance:read`. `held_balance` incluye operaciones pendientes de conciliar."}}]},{"name":"Catálogo","item":[{"name":"Compañías disponibles","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/catalog/carriers","host":["{{base_url}}"],"path":["v1","catalog","carriers"]},"description":"Requiere scope `catalog:read`."}},{"name":"Productos disponibles","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/catalog/products?","host":["{{base_url}}"],"path":["v1","catalog","products"],"query":[{"key":"carrier","value":"TELCEL","description":"Filtra por compañía.","disabled":true}]},"description":"Productos disponibles"}}]},{"name":"Servicios","item":[{"name":"Emisores de pago de servicios","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/catalog/billers","host":["{{base_url}}"],"path":["v1","catalog","billers"]},"description":"Cada emisor trae su tipo (monto libre o catálogo), los campos que debe capturar el usuario, sus productos de precio fijo y las reglas que hay que mostrarle."}},{"name":"Pago de servicio o gift card (idempotente)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/services/payments","host":["{{base_url}}"],"path":["v1","services","payments"]},"description":"La referencia se valida contra los campos del emisor. Mismas reglas de idempotencia y conciliación que `/v1/recharges`.","body":{"mode":"raw","raw":"{\n  \"reference\": \"001234567890123456789012345678\",\n  \"external_reference\": \"PAGO-000001\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Ticket de venta: JSON, ESC/POS térmico o PDF","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/transactions/:id/ticket?","host":["{{base_url}}"],"path":["v1","transactions",":id","ticket"],"query":[{"key":"format","value":"json","disabled":true},{"key":"paper","value":"","description":"Ancho en mm, sólo para `escpos`.","disabled":true}]},"description":"Siempre disponible (reimpresión), independiente del ticket automático.\n\n`json` → datos para armar su propio ticket · `escpos` → texto listo para impresora térmica (`text/plain`) · `pdf` → URL firmada."}}]},{"name":"Catálogo POS","item":[{"name":"Pantalla 1 — tipos de operación","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/pos/catalog/types","host":["{{base_url}}"],"path":["v1","pos","catalog","types"]},"description":"Recargas, servicios, gift cards y paquetes, con ícono y conteo."}},{"name":"Pantalla 2 — marcas de un tipo","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/pos/catalog/brands?type=","host":["{{base_url}}"],"path":["v1","pos","catalog","brands"],"query":[{"key":"type","value":"","disabled":false},{"key":"q","value":"","description":"Búsqueda por nombre de marca.","disabled":true}]},"description":"Pantalla 2 — marcas de un tipo"}},{"name":"Pantalla 3 — montos de una marca, con precio real","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/pos/catalog/amounts?type=&carrier=TELCEL","host":["{{base_url}}"],"path":["v1","pos","catalog","amounts"],"query":[{"key":"type","value":"","disabled":false},{"key":"carrier","value":"TELCEL","disabled":false}]},"description":"Incluye `cost_to_client` ya con su comisión aplicada. Si `free_amount` es true, cotice con `/v1/pos/catalog/quote`."}},{"name":"Pantalla 4 — cotización SIN cobrar","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/pos/catalog/quote?product_code=TEL100&amount=100","host":["{{base_url}}"],"path":["v1","pos","catalog","quote"],"query":[{"key":"product_code","value":"TEL100","disabled":false},{"key":"amount","value":"100","disabled":false}]},"description":"Devuelve el desglose completo y si su saldo alcanza. No mueve saldo ni crea transacción: es seguro llamarlo las veces que haga falta."}}]},{"name":"Recargas","item":[{"name":"Crear recarga (idempotente)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/recharges","host":["{{base_url}}"],"path":["v1","recharges"]},"description":"Requiere scope `recharge:create`.\n\n**Reintentos:** use SIEMPRE el mismo `external_reference`. Cambiarlo para \"reintentar\" provoca un segundo cobro.\n\n**`pending_reconciliation`:** el saldo queda retenido y la conciliación resuelve en ~2 min. NO revenda; consulte el estado o espere el webhook `transaction.pending_resolved`.","body":{"mode":"raw","raw":"{\n  \"external_reference\": \"SBNPOS-S1-004512\",\n  \"phone\": \"5512345678\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Historial de transacciones","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/transactions?","host":["{{base_url}}"],"path":["v1","transactions"],"query":[{"key":"status","value":"","disabled":true},{"key":"from","value":"2026-07-01","disabled":true},{"key":"to","value":"2026-07-31","disabled":true},{"key":"service_type","value":"","disabled":true},{"key":"carrier","value":"TELCEL","disabled":true},{"key":"external_reference","value":"","description":"Coincidencia exacta con SU referencia.","disabled":true},{"key":"cursor","value":"","description":"Paginación estable (recomendada). Use `cursor.next` de la respuesta anterior. Con `page` las filas se desplazan si entran ventas mientras pagina.","disabled":true},{"key":"page","value":"1","description":"Alternativa a `cursor`.","disabled":true},{"key":"limit","value":"20","disabled":true}]},"description":"Requiere scope `transaction:read`. Paginado."}},{"name":"Buscar por SU referencia (external_reference)","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/transactions/by-reference/:externalReference","host":["{{base_url}}"],"path":["v1","transactions","by-reference",":externalReference"]},"description":"Resuelve el caso crítico del mostrador: **«se me cayó la red, ¿se cobró?»**.\n\nAntes de reintentar tras un error de red, consulte aquí con la misma referencia que envió. Si existe, la operación se creó: NO la repita."}},{"name":"Detalle de una transacción","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/transactions/:id","host":["{{base_url}}"],"path":["v1","transactions",":id"]},"description":"Fuente de verdad del estado. Ante cualquier duda tras un timeout, consulte aquí — nunca reintente a ciegas."}},{"name":"Comprobante PDF","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/transactions/:id/receipt","host":["{{base_url}}"],"path":["v1","transactions",":id","receipt"]},"description":"Si aún no se ha generado, responde 202 y lo encola: reintente en unos segundos."}}]},{"name":"Reportes","item":[{"name":"Export CSV para conciliación contable","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/reports/transactions/csv","host":["{{base_url}}"],"path":["v1","reports","transactions","csv"]},"description":"Acepta los mismos filtros que `/v1/transactions`. Trabajo asíncrono: responde 202 y el archivo aparece en `GET /v1/reports`. Incluye BOM UTF-8 para que Excel respete los acentos.","body":{"mode":"raw","raw":"{\n  \"from\": \"2026-07-01\",\n  \"to\": \"2026-07-31\",\n  \"status\": \"\",\n  \"service_type\": \"\",\n  \"carrier\": \"TELCEL\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Generar reporte PDF por rango de fechas","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/reports/transactions","host":["{{base_url}}"],"path":["v1","reports","transactions"]},"description":"Trabajo asíncrono: responde 202 y el reporte aparece en `GET /v1/reports`.","body":{"mode":"raw","raw":"{\n  \"from\": \"2026-07-01\",\n  \"to\": \"2026-07-31\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Reportes y exports generados","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/reports","host":["{{base_url}}"],"path":["v1","reports"]},"description":"Reportes y exports generados"}},{"name":"URL firmada de descarga de un reporte","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/v1/reports/:uuid/download","host":["{{base_url}}"],"path":["v1","reports",":uuid","download"]},"description":"URL firmada de descarga de un reporte"}}]}]}