Skip to main content
GET
/
admin
/
merchants
Gestión de merchants
curl --request GET \
  --url https://api.example.com/admin/merchants
{
  "data": [
    {
      "id": "merch_abc123",
      "name": "Mi Tienda Online",
      "status": "active",
      "owner": "Juan Pérez",
      "createdAt": "2026-02-01T10:00:00Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}
Requiere autenticación con Bearer token y rol ADMIN.

​
Listar merchants

​
page
integer
Número de página. Por defecto 1.
​
limit
integer
Cantidad de resultados por página. Por defecto 20.
​
search
string
Texto de búsqueda por nombre del merchant.
​
status
string
Filtrar por estado del merchant: active, inactive, pending.

​
Respuesta

​
data
array
Lista paginada de merchants.
​
page
integer
Página actual.
​
limit
integer
Cantidad de resultados por página.
​
total
integer
Total de merchants que coinciden con los filtros.
{
  "data": [
    {
      "id": "merch_abc123",
      "name": "Mi Tienda Online",
      "status": "active",
      "owner": "Juan Pérez",
      "createdAt": "2026-02-01T10:00:00Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

​
Obtener merchant por ID

GET /admin/merchants/{id}
​
id
string
required
Identificador único del merchant.
Retorna el detalle completo de un merchant específico. 
{
  "id": "merch_abc123",
  "name": "Mi Tienda Online",
  "status": "active",
  "owner": {
    "id": "usr_abc123",
    "name": "Juan Pérez",
    "email": "juan@ejemplo.com"
  },
  "rif": "J-12345678-9",
  "environment": "production",
  "createdAt": "2026-02-01T10:00:00Z"
}