API Reference

Afiliacion

Agregar subcomercios

Los aliados pueden generar subcomercios bajo su nombre y estos subafiliados pueden operar de manera independiente, dependiendo de la manera en la que fueron anexados a el afiliado principal.

Un subcomercio o subafiliado es aquel receptor de pagos tanto en tarjeta presente como no presente celebra un contrato con el facilitador de tecnología o agregador para recibir pagos con tarjeta mediante las soluciones de pagos electrónicos que esta requiera.

El proceso de afiliación consiste en asignarle un número de identificación único a cada subcomercio o afiliado, para que procese transacciones de manera independiente de toda la red de comercios e informarlo en cada una de las transacciones.

Los aliados pueden integrar multiples subcomercios bajo su nombre, los cuales pueden operar de manera distinta e independiente entre sí.

Variables de Envío

VARIABLE

FORMATO

RESTRICCIONES

DESCRIPCION

tipo

Carácter

Admite un solo dígito

Tipo de Persona
1 = Persona Física
2 = Persona Moral

email

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Correo Electrónico del Representante Legal

nombre

Alfanumérico

Admite letras. No mayor a 20 caracteres.

Nombre del Representante Legal

paterno

Alfanumérico

Admite letras. No mayor a 20 caracteres.

Apellido paterno del Representante Legal

materno

Alfanumérico

Admite letras. No mayor a 20 caracteres.

Apellido materno del Representante Legal

calle

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Calle del Representante Legal

numExt

Numérico

Admite números sin espacios.

Numero exterior del Representante Legal

cp

Numérico

Admite números sin espacios.

Código Postal del Representante Legal

colonia

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Colonia del Representante Legal

municipio

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Municipio del Representante Legal

estado

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Estado del Representante Legal

pais

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

país del Representante Legal

telefono

Numérico

Admite números sin espacios.

Teléfono de la empresa

celular

Numérico

Admite números sin espacios.

Celular de contacto del Representante Legal

rfc

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Registro Federal de Contribuyente registrado ante el SAT

nombreComercial

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Nombre del comercio

razonSocial

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Razón Social

fiscalCalle

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Calle (Fiscal)

fiscalNumExterior

Numérico

Admite números sin espacios.
No mayor a 04 caracteres.

Numero Exterior (Fiscal)

fiscalCp

Numérico

Admite números sin espacios.

Código Postal (Fiscal)

fiscalColonia

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Colonia (Fiscal)

fiscalMunicipio

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Municipio (Fiscal)

fiscalEstado

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Estado (Fiscal)

fiscalPais

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Pais (Fiscal)

giro

Numérico

Admite números sin espacios.
No mayor a 04 caracteres.

Actividad principal
El Catalogo de Giros se compartirá durante el proceso de integración

producto

Numérico

Admite un solo dígito

Esquema de producto manejado por el comercio
[Consulte categoría de producto] (https://bloomin.readme.io/reference/lista-de-productos
)

aliado

Numérico

Admite números sin espacios.

Esquema de Afiliación del Comercio
1 = Afiliación Propia
2 = Afiliación Genérica

banco

Numérico

Admite números sin espacios.

Banco de la Cuenta donde se liquidará el monto de sus operaciones

cuenta

Numérico

Admite números sin espacios.

Numero de Cuenta donde se liquidará el monto de sus operaciones

clabe

Numérico

Admite solo 18 dígitos

La Clave Bancaria Estandarizada

tasaDebito

Numérico

Admite números, un punto y dos decimales sin espacios.

Tasa de Débito, sujeto a confirmación de OEL

tasaCredito

Numérico

Admite números, un punto y dos decimales sin espacios.

Tasa de Crédito, sujeto a confirmación de OEL

tasaAmex

Numérico

Admite números, un punto y dos decimales sin espacios.

Tasa de American Express, sujeto a confirmación de OEL

tasaInternacional

Numérico

Admite números, un punto y dos decimales sin espacios.

Tasa Internacional, sujeto a confirmación de OEL

tasaValeras

Numérico

Admite números, un punto y dos decimales sin espacios.

Tasa de Valeras, sujeto a confirmación de OEL

Variables de Retorno

VARIABLE

FORMATO

RESTRICCIONES

DESCRIPCION

codigoRespuesta

Carácter

Números sin espacios.

Se regresa los siguientes valores:
0 = Aprobada,
1 = Rechazada

codigoAprobacion

Numérico

Alfanumérico de longitud variable

Código de Aprobación Bancaria, típicamente con 6 Dígitos

referencia

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Valor de verificacion para la operacion=

rfc

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Registro Federal de Contribuyente registrado ante el SAT

razonSocial

Alfanumérico

Admite letras y/o números. No mayor a 20 caracteres.

Razón Social

testGatewayURL

Alfanumérico

Admite letras y/o números.

URL del ambiente de pruebas de OpenLinea

testOpKey1

Alfanumérico

Admite letras y/o números

Valores de las Cabeceras SOAP utilizadas para acceder a a los servicios de OpenLinea

testOpKey2

Alfanumérico

Admite letras y/o números

Valores de las Cabeceras SOAP utilizadas para acceder a a los servicios de OpenLinea

testComercioId

Numérico

Admite números sin espacios

Identificador del Comercio en OPENLINEA. Es un valor asignado.

testContraseña

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 12 caracteres.

Clave de Acceso a la Terminal Virtual, configurado para su aplicación.

testPortalURL

Alfanumérico

Admite letras y/o números.

URL de llamado al servidor de pruebas de OpenLinea

testPortalUsuario

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 20 caracteres.

Usuario para entrar en la plataforma de desarrollo

testPortalContrasena

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 12 caracteres.

Contraseña para entrar en la plataforma de Desarrollo

liveGatewayURL

Alfanumérico

Admite letras y/o números.

URL del ambiente de producción de OpenLinea

liveOpKey1

Alfanumérico

Admite letras y/o números.

Valores de las Cabeceras SOAP utilizadas para acceder a a los servicios de OpenLinea

liveOpKey2

Alfanumérico

Admite letras y/o números.

Valores de las Cabeceras SOAP utilizadas para acceder a a los servicios de OpenLinea

liveComercioId

Numérico

Admite números sin espacios.

Identificador del Comercio en OPENLINEA. Es un valor asignado.

liveContraseña

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 12 caracteres.

Clave de Acceso a la Terminal Virtual, configurado para su aplicación.

livePortalURL

Alfanumérico

Admite letras y/o números.

URL del ambiente de producción de OpenLinea

livePortalUsuario

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 20 caracteres.

Usuario para entrar en la plataforma de Producción

livePortalContrasena

Alfanumérico

Admite letras y/o números sin espacios. No mayor a 12 caracteres.

Contraseña para entrar en la plataforma de Producción

fechaAfiliacion

Alfanumérico

Representación de fecha con formato MM/DD/AA

Fecha procesamiento de la Afiliación

ccErrorCode

Numérico

Numérico de longitud variable. No mayor a 4 caracteres.

Código devuelto por la Institución Financiera

ccReturnMsg

Alfanumérico

Alfanumérico de longitud variable

Texto específico retornado por el procesador de pagos