Listar merchants
Lista los merchants (tiendas, marcas o vendedores) de tu empresa. De aquí sale el merchant_id que piden crear transacción, enviar evento desde el servidor y solicitar enrollment.
Para registrar y editar merchants por la API, ve Crear o actualizar merchant, Lote de merchants y la Guía de sincronización.
Endpoint
Sección titulada «Endpoint»https://api.rapidchargeback.com/api/v1/merchantsAutenticación
Sección titulada «Autenticación»Authorization: Basic base64(client_id:client_secret)Query params
Sección titulada «Query params»Todos opcionales.
| Param | Tipo | Default | Descripción |
|---|---|---|---|
page | int (≥ 1) | 1 | Página |
per_page | int (1–100) | 20 | Ítems por página |
merchant_ref | string (hasta 100) | - | El ID del vendedor en tu sistema, el mismo merchant_ref aceptado en crear transacción. Devuelve 0 o 1 ítem. La comparación no distingue mayúsculas ni acentos |
status | enum | - | active, inactive o unverified |
updated_since | fecha y hora ISO 8601 con zona horaria | - | Solo los merchants modificados a partir de ese instante (ej.: 2026-11-06T12:00:00Z o 2026-11-06T09:00:00-03:00). Sin zona horaria, la API lo rechaza con 422 |
Sin updated_since, la lista viene en orden de registro (el más antiguo primero). Para recorrer todos, avanza page hasta que llegue a total_pages: un merchant registrado a mitad de camino entra al final, sin hacerte saltar ni repetir ítems.
Sincronizar lo que cambió
Sección titulada «Sincronizar lo que cambió»Con updated_since, la lista trae solo lo que cambió a partir de ese instante, del más antiguo al más nuevo (updated_at, después id). Para seguir los cambios sin perder ninguno:
- Guarda el mayor
updated_atque recibiste. - En la consulta siguiente, envía ese valor menos 2 minutos como
updated_since. - Ignora el par (
id,updated_at) que ya procesaste. - Lee las páginas hasta
total_pages.
El margen de 2 minutos cubre el cambio guardado fuera de orden o durante tu lectura.
Ejemplos
Sección titulada «Ejemplos»Todos los merchants
Sección titulada «Todos los merchants»curl -G "https://api.rapidchargeback.com/api/v1/merchants" \ --data-urlencode "per_page=100" \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Por el ID del vendedor en tu sistema
Sección titulada «Por el ID del vendedor en tu sistema»curl -G "https://api.rapidchargeback.com/api/v1/merchants" \ --data-urlencode "merchant_ref=PB-1001" \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Lo que cambió desde la última lectura
Sección titulada «Lo que cambió desde la última lectura»curl -G "https://api.rapidchargeback.com/api/v1/merchants" \ --data-urlencode "updated_since=2026-11-06T11:58:00Z" \ --data-urlencode "per_page=100" \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Respuesta
Sección titulada «Respuesta»{ "data": [ { "id": "00000000-0000-0000-0000-000000000001", "name": "Loja Exemplo", "merchant_ref": "PB-1001", "status": "active", "created_at": "2026-03-10T12:00:00.000Z", "updated_at": "2026-11-06T12:00:00.000Z" } ], "meta": { "page": 1, "per_page": 20, "total": 1, "total_pages": 1 }}| Campo | Descripción |
|---|---|
id | El merchant_id que piden las otras APIs |
name | Nombre del merchant |
merchant_ref | El ID del vendedor en tu sistema, guardado por la API de merchants o por un merchant_ref nuevo en crear transacción. null cuando nunca se informó |
status | active, inactive o unverified: la situación del registro. unverified es el merchant creado automáticamente por un merchant_ref nuevo en crear transacción, hasta que Rapid revise el registro o tú lo confirmes con status: "active" en Crear o actualizar merchant o Editar merchant. La situación no cambia nada en el funcionamiento: las transacciones y los eventos del merchant se aceptan igual |
created_at | Cuándo se registró |
updated_at | Cuándo cambió el registro por última vez |
La lista trae solo esos campos. El registro completo (contacto, dirección, términos) está en Consultar merchant.
Sin resultados
Sección titulada «Sin resultados»{ "data": [], "meta": { "page": 1, "per_page": 20, "total": 0, "total_pages": 0 }}Parámetro inválido (ej: per_page=500)
Sección titulada «Parámetro inválido (ej: per_page=500)»{ "error": { "code": "VALIDATION_ERROR", "message": "Number must be less than or equal to 100" }}updated_since sin zona horaria
Sección titulada «updated_since sin zona horaria»{ "error": { "code": "VALIDATION_ERROR", "message": "updated_since must be an ISO 8601 date and time with a time zone (e.g. 2026-11-06T12:00:00Z)", "params": { "field": "updated_since" } }}- Solo los merchants de tu empresa. La empresa viene de la credencial; no hay parámetro para elegir otra.
- Parámetro desconocido todavía se ignora en esta ruta, pero va a pasar a rechazarse con
422, como en las rutas nuevas: envía solo los parámetros de la tabla (ver Novedades de la API). - Empresa bloqueada recibe
403 COMPANY_BLOCKED, como en las otras APIs. - Auth, rate limit, códigos de error: ver Autenticación y Códigos de respuesta.