API Reference

Afiliacion

Integre los Subcomercios a la plataforma

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

VARIABLEFORMATORESTRICCIONESDESCRIPCION
tipoCarácterAdmite un solo dígitoTipo de Persona
1 = Persona Física
2 = Persona Moral
emailAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Correo Electrónico del Representante Legal
nombreAlfanuméricoAdmite letras. No mayor a 20 caracteres.Nombre del Representante Legal
paternoAlfanuméricoAdmite letras. No mayor a 20 caracteres.Apellido paterno del Representante Legal
maternoAlfanuméricoAdmite letras. No mayor a 20 caracteres.Apellido materno del Representante Legal
calleAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Calle del Representante Legal
numExtNuméricoAdmite números sin espacios.Numero exterior del Representante Legal
cpNuméricoAdmite números sin espacios.Código Postal del Representante Legal
coloniaAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Colonia del Representante Legal
municipioAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Municipio del Representante Legal
estadoAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Estado del Representante Legal
paisAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.país del Representante Legal
telefonoNuméricoAdmite números sin espacios.Teléfono de la empresa
celularNuméricoAdmite números sin espacios.Celular de contacto del Representante Legal
rfcAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Registro Federal de Contribuyente registrado ante el SAT
nombreComercialAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Nombre del comercio
razonSocialAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Razón Social
fiscalCalleAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Calle (Fiscal)
fiscalNumExteriorNuméricoAdmite números sin espacios.
No mayor a 04 caracteres.
Numero Exterior (Fiscal)
fiscalCpNuméricoAdmite números sin espacios.Código Postal (Fiscal)
fiscalColoniaAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Colonia (Fiscal)
fiscalMunicipioAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Municipio (Fiscal)
fiscalEstadoAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Estado (Fiscal)
fiscalPaisAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Pais (Fiscal)
giroNuméricoAdmite números sin espacios.
No mayor a 04 caracteres.
Actividad principal
El Catalogo de Giros se compartirá durante el proceso de integración
productoNuméricoAdmite un solo dígitoEsquema de producto manejado por el comercio
[Consulte categoría de producto] (https://bloomin.readme.io/reference/lista-de-productos
)
aliadoNuméricoAdmite números sin espacios.Esquema de Afiliación del Comercio
1 = Afiliación Propia
2 = Afiliación Genérica
bancoNuméricoAdmite números sin espacios.Banco de la Cuenta donde se liquidará el monto de sus operaciones
cuentaNuméricoAdmite números sin espacios.Numero de Cuenta donde se liquidará el monto de sus operaciones
clabeNuméricoAdmite solo 18 dígitosLa Clave Bancaria Estandarizada
tasaDebitoNuméricoAdmite números, un punto y dos decimales sin espacios.Tasa de Débito, sujeto a confirmación de OEL
tasaCreditoNuméricoAdmite números, un punto y dos decimales sin espacios.Tasa de Crédito, sujeto a confirmación de OEL
tasaAmexNuméricoAdmite números, un punto y dos decimales sin espacios.Tasa de American Express, sujeto a confirmación de OEL
tasaInternacionalNuméricoAdmite números, un punto y dos decimales sin espacios.Tasa Internacional, sujeto a confirmación de OEL
tasaValerasNuméricoAdmite números, un punto y dos decimales sin espacios.Tasa de Valeras, sujeto a confirmación de OEL

Variables de Retorno

VARIABLEFORMATORESTRICCIONESDESCRIPCION
codigoRespuestaCarácterNúmeros sin espacios.Se regresa los siguientes valores:
0 = Aprobada,
1 = Rechazada
codigoAprobacionNuméricoAlfanumérico de longitud variableCódigo de Aprobación Bancaria, típicamente con 6 Dígitos
referenciaAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Valor de verificacion para la operacion=
rfcAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Registro Federal de Contribuyente registrado ante el SAT
razonSocialAlfanuméricoAdmite letras y/o números. No mayor a 20 caracteres.Razón Social
testGatewayURLAlfanuméricoAdmite letras y/o números.URL del ambiente de pruebas de OpenLinea
testOpKey1AlfanuméricoAdmite letras y/o númerosValores de las Cabeceras SOAP utilizadas para acceder a a los servicios de OpenLinea
testOpKey2AlfanuméricoAdmite letras y/o númerosValores de las Cabeceras SOAP utilizadas para acceder a a los servicios de OpenLinea
testComercioIdNuméricoAdmite números sin espaciosIdentificador del Comercio en OPENLINEA. Es un valor asignado.
testContraseñaAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 12 caracteres.Clave de Acceso a la Terminal Virtual, configurado para su aplicación.
testPortalURLAlfanuméricoAdmite letras y/o números.URL de llamado al servidor de pruebas de OpenLinea
testPortalUsuarioAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 20 caracteres.Usuario para entrar en la plataforma de desarrollo
testPortalContrasenaAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 12 caracteres.Contraseña para entrar en la plataforma de Desarrollo
liveGatewayURLAlfanuméricoAdmite letras y/o números.URL del ambiente de producción de OpenLinea
liveOpKey1AlfanuméricoAdmite letras y/o números.Valores de las Cabeceras SOAP utilizadas para acceder a a los servicios de OpenLinea
liveOpKey2AlfanuméricoAdmite letras y/o números.Valores de las Cabeceras SOAP utilizadas para acceder a a los servicios de OpenLinea
liveComercioIdNuméricoAdmite números sin espacios.Identificador del Comercio en OPENLINEA. Es un valor asignado.
liveContraseñaAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 12 caracteres.Clave de Acceso a la Terminal Virtual, configurado para su aplicación.
livePortalURLAlfanuméricoAdmite letras y/o números.URL del ambiente de producción de OpenLinea
livePortalUsuarioAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 20 caracteres.Usuario para entrar en la plataforma de Producción
livePortalContrasenaAlfanuméricoAdmite letras y/o números sin espacios. No mayor a 12 caracteres.Contraseña para entrar en la plataforma de Producción
fechaAfiliacionAlfanuméricoRepresentación de fecha con formato MM/DD/AAFecha procesamiento de la Afiliación
ccErrorCodeNuméricoNumérico de longitud variable. No mayor a 4 caracteres.Código devuelto por la Institución Financiera
ccReturnMsgAlfanuméricoAlfanumérico de longitud variableTexto específico retornado por el procesador de pagos