Skip to main content
GET
/
api
/
v1
/
merchants
/
{id}
/
store
Configuración de tienda
curl --request GET \
  --url https://api.venepagos.com.ve/api/v1/merchants/{id}/store \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "theme": {}
}
'
{
  "merchantId": "mrc_abc123",
  "name": "Mi Tienda",
  "slug": "mi-tienda",
  "description": "Tienda de ejemplo",
  "logo": "https://cdn.venepagos.com.ve/logos/mrc_abc123.png",
  "banner": "https://cdn.venepagos.com.ve/banners/mrc_abc123.png",
  "theme": {
    "primaryColor": "#1a73e8",
    "secondaryColor": "#ffffff"
  }
}

​
Autenticación

Este endpoint requiere autenticación mediante Bearer token.

​
Parámetros de ruta

​
id
string
required
Identificador único del merchant.

​
Respuesta

​
merchantId
string
ID del merchant asociado a la tienda.
​
name
string
Nombre de la tienda.
​
slug
string
Slug único de la tienda para la URL pública.
​
description
string
Descripción de la tienda.
URL del logo de la tienda.
​
banner
string
URL del banner de la tienda.
​
theme
object
Configuración del tema visual de la tienda.
{
  "merchantId": "mrc_abc123",
  "name": "Mi Tienda",
  "slug": "mi-tienda",
  "description": "Tienda de ejemplo",
  "logo": "https://cdn.venepagos.com.ve/logos/mrc_abc123.png",
  "banner": "https://cdn.venepagos.com.ve/banners/mrc_abc123.png",
  "theme": {
    "primaryColor": "#1a73e8",
    "secondaryColor": "#ffffff"
  }
}

​
Actualizar configuración de tienda

PUT /merchants/{id}/store
Actualiza la configuración de la tienda del merchant.

​
Parámetros de ruta

​
id
string
required
Identificador único del merchant.

​
Cuerpo de la solicitud

​
name
string
Nombre de la tienda.
​
slug
string
Slug único para la URL pública de la tienda.
​
description
string
Descripción de la tienda.
​
theme
object
Configuración del tema visual. Incluye primaryColor y secondaryColor en formato hexadecimal.

​
Respuesta

Retorna el objeto de configuración de tienda actualizado (mismo formato que GET). 
{
  "merchantId": "mrc_abc123",
  "name": "Mi Tienda Actualizada",
  "slug": "mi-tienda-actualizada",
  "description": "Nueva descripción",
  "logo": "https://cdn.venepagos.com.ve/logos/mrc_abc123.png",
  "banner": "https://cdn.venepagos.com.ve/banners/mrc_abc123.png",
  "theme": {
    "primaryColor": "#ff5722",
    "secondaryColor": "#f5f5f5"
  }
}
POST /merchants/{id}/store/logo
Sube o actualiza el logo de la tienda. El archivo debe enviarse como multipart/form-data.

​
Parámetros de ruta

​
id
string
required
Identificador único del merchant.

​
Cuerpo de la solicitud

​
file
file
required
Archivo de imagen del logo. Formatos aceptados: PNG, JPG, WEBP. Tamaño máximo: 2 MB.

​
Respuesta

​
logo
string
URL del nuevo logo subido.
{
  "logo": "https://cdn.venepagos.com.ve/logos/mrc_abc123.png"
}

​
Subir banner

POST /merchants/{id}/store/banner
Sube o actualiza el banner de la tienda. El archivo debe enviarse como multipart/form-data.

​
Parámetros de ruta

​
id
string
required
Identificador único del merchant.

​
Cuerpo de la solicitud

​
file
file
required
Archivo de imagen del banner. Formatos aceptados: PNG, JPG, WEBP. Tamaño máximo: 5 MB.

​
Respuesta

​
banner
string
URL del nuevo banner subido.
{
  "banner": "https://cdn.venepagos.com.ve/banners/mrc_abc123.png"
}

​
Listar enlaces de la tienda

GET /merchants/{id}/store/links
Obtiene los enlaces de pago asociados a la tienda del merchant.

​
Parámetros de ruta

​
id
string
required
Identificador único del merchant.

​
Respuesta

​
data
array
Lista de enlaces de la tienda.
{
  "data": [
    {
      "id": "lnk_001",
      "url": "https://pay.venepagos.com.ve/mi-tienda/producto-1",
      "label": "Producto 1",
      "active": true
    },
    {
      "id": "lnk_002",
      "url": "https://pay.venepagos.com.ve/mi-tienda/donacion",
      "label": "Donación",
      "active": true
    }
  ]
}