Procesadores

Buscar datos requeridos

GET /v1/acquirers/merchants

Este endpoint permite obtener la información requerida para registrar un comercio en un procesador específico.

Datos de consulta

ParámetrosDescripción
merchant_id
  • string
  • Identificador del comercio
acquirer_id
  • string
  • Identificador del procesador
  • [GPS, PRISMA, PRISMA_QR, BANORTE, AMEX]
rate_type
  • string
  • Tipo de tasa a utilizar
  • [AGGREGATOR, NATURAL]
ℹ️

Datos de respuesta

ParámetrosDescripción
acquirer_id
  • string
  • Identificador de la adquirencia
  • [GPS, PRISMA, PRISMA_QR, BANORTE, AMEX]
customer_id
  • string
  • Identificador único del cliente al cual estará vinculado el comercio en el sistema
merchant_id
  • string
  • Identificador único del comercio que se desea registrar
rate_type
  • string
  • Tipo de tasa aplicada a las transacciones del comercio
  • [AGGREGATOR, NATURAL]
payment_type
  • string
  • Tipo de pago
  • [TERMINAL]
data
  • list
  • Es una lista que contiene los distintos campos necesarios para completar el registro del comercio. Cada campo en data representa un input del formulario, y su estructura es flexible para adaptarse a la complejidad y profundidad de los datos requeridos.
  • data.
name
  • string
  • El nombre del campo que se necesita completar. Este nombre ayuda a identificar el propósito de cada campo en el formulario.
  • data.
properties
  • object
  • Contiene las propiedades específicas del campo que definen cómo debe mostrarse y comportarse en el formulario.
  • data.properties.
type
  • (opcional)
  • string
  • Define el tipo de input, como TEXT (campo de texto), AUTOCOMPLETE (sugerencia automática), SELECT (menú desplegable), OBJECT (estructura compleja que contiene otros inputs), entre otros
  • [TEXT, AUTOCOMPLETE, SELECT, OBJECT]
  • data.properties.
title
  • (opcional)
  • string
  • El título o etiqueta que describe el campo en el formulario.
  • data.properties.
description
  • (opcional)
  • string
  • Una breve descripción del campo, que puede usarse como una pista para el usuario.
  • data.properties.
validations
  • (opcional)
  • object
  • Validaciones que se aplican al input
  • data.properties.validations.
required
  • boolean
  • Indica si el campo es obligatorio (true) o no (false)
  • data.properties.
href
  • (opcional)
  • string
  • URL donde se puede obtener información adicional para completar el campo. Por ejemplo, una lista de actividades o tipos de documentos en formato KEY/VALUE.
  • [TEXT, AUTOCOMPLETE, SELECT, OBJECT]
  • data.properties.
hidden
  • (opcional)
  • string
  • Indica si el campo debe estar oculto en el formulario (true) o visible (false).
  • data.properties.
value
  • (opcional)
  • string
  • Valor predefinido del campo. Si no está presente, significa que el input aún no tiene un valor asignado.
  • data.properties.
data
  • (opcional)
  • list
  • Contiene campos adicionales cuando el tipo de input es OBJECT, permitiendo la recursión en la estructura. Esto se utiliza cuando se necesita un conjunto de inputs anidados. Cada input dentro de properties.data sigue la misma estructura recursiva, permitiendo formularios de múltiples niveles de profundidad.
  • data.properties.
options
  • (opcional)
  • string
  • Lista de opciones en formato KEY/VALUE para campos de tipo SELECT o AUTOCOMPLETE
curl --request GET \
  --url 'https://api.menta.global/api/v1/acquirers/merchants?merchantId={merchant_id}&acquirerId={acquirer_id}&rateType={rate_type}' \
  --header 'Authorization: Bearer {access_token}'
{
    "acquirer_id": "string",
    "customer_id": "string",
    "merchant_id": "striing",
    "rate_type": "string",
    "payment_type": "string",
    "data": [
        {
            "name": "string",
            "properties": {
                "type": "string",
                "title": "string",
                "description": "string",
                "validations": {
                    "required": "boolean"
                },
                "href": "string",
                "hidden": "boolean",
                "value": "string",
                "data": "list",
                "options": "list"
            }
        }
    ]
}