Ir al contenido

↑↓ navegar ↵ abrir Ctrl↵ nueva pestaña esc cerrar

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.

GET https://api.rapidchargeback.com/api/v1/merchants
Authorization: Basic base64(client_id:client_secret)

Todos opcionales.

ParamTipoDefaultDescripción
pageint (≥ 1)1Página
per_pageint (1–100)20Ítems por página
merchant_refstring (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
statusenum-active, inactive o unverified
updated_sincefecha 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.

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:

  1. Guarda el mayor updated_at que recibiste.
  2. En la consulta siguiente, envía ese valor menos 2 minutos como updated_since.
  3. Ignora el par (id, updated_at) que ya procesaste.
  4. Lee las páginas hasta total_pages.

El margen de 2 minutos cubre el cambio guardado fuera de orden o durante tu lectura.


Ventana de terminal
curl -G "https://api.rapidchargeback.com/api/v1/merchants" \
--data-urlencode "per_page=100" \
-H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
Ventana de terminal
curl -G "https://api.rapidchargeback.com/api/v1/merchants" \
--data-urlencode "merchant_ref=PB-1001" \
-H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
Ventana de terminal
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="

{
"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
}
}
CampoDescripción
idEl merchant_id que piden las otras APIs
nameNombre del merchant
merchant_refEl 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ó
statusactive, 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_atCuándo se registró
updated_atCuá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.

{
"data": [],
"meta": { "page": 1, "per_page": 20, "total": 0, "total_pages": 0 }
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Number must be less than or equal to 100"
}
}
{
"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.