Skip to main content
GET
/
api
/
v1
/
merchants
Listar merchants
curl --request GET \
  --url https://api.venepagos.com.ve/api/v1/merchants
{
  "data": [
    {
      "id": "mrc_abc123",
      "name": "Mi Tienda",
      "rif": "J-12345678-9",
      "description": "Tienda de ejemplo",
      "owner": "usr_xyz789",
      "status": "ACTIVE"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 1
}

​
Autenticación

Este endpoint requiere autenticación mediante Bearer token.

​
Parámetros de consulta

​
page
integer
default:"1"
Número de página para la paginación.
​
limit
integer
default:"50"
Cantidad de resultados por página.
​
search
string
Término de búsqueda para filtrar merchants por nombre o RIF.
​
status
string
Filtra merchants por estado. Valores posibles: ACTIVE, INACTIVE.

​
Respuesta

​
data
array
Lista de objetos merchant.
​
page
integer
Página actual.
​
limit
integer
Cantidad de resultados por página.
​
total
integer
Total de merchants encontrados.
{
  "data": [
    {
      "id": "mrc_abc123",
      "name": "Mi Tienda",
      "rif": "J-12345678-9",
      "description": "Tienda de ejemplo",
      "owner": "usr_xyz789",
      "status": "ACTIVE"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 1
}