Los aliados pueden generar cargos a sus subafiliados bajo distintos conceptos, ya sea cobros por uso de su plataforma, de software registrado, cobros por comisiones, etc. Estos cobros serán procesados de manera interna y para poder efectuar el Cargo, el Sub Afiliado debe disponer de Saldo a favor en su cuenta con Operaciones en Línea.
Para efectuar una operación con CARGO AL SUBCOMERCIO AFILIADO, deberá enviar las siguientes variables mediante un mensaje SOAP al webservice previamente indicado, invocando el método cargoSubAfiliado el cual le permitirá procesar su solicitud.
Variables de Envío
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Admite números sin espacios. | Identificador del Comercio en OPENLINEA. Es un valor asignado. |
| contraseñ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. |
| subAfiliado | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 15 caracteres. | Identificador único del SubAfiliado |
| concepto | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. | Concepto del Cargo |
| descripcion | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 80 caracteres. | Descripción del Cargo |
| monto | Numérico | Admite números un punto y dos decimales sin espacios, no se permite comas o signos de pesos. | MONTO TOTAL O PARCIAL DE LA VENTA que será el monto a DEVOLVER, este monto será proporcionado por su aplicación en base a la Venta previamente realizada. |
| transaccionId | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. | Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio. |
| referencia1 | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. | Referencia libre de uso para su aplicación |
| referencia2 | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. | Referencia libre de uso para su aplicación |
| referencia3 | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. | Referencia libre de uso para su aplicación |
Para calcular el Saldo Disponible se tomará en cuenta las Ventas procesadas por el Comercio con Tarjeta de Débito/Crédito hasta el último corte de Operaciones en Línea y posterior al aplicarse las Comisiones correspondientes, así como Contracargos, Cancelaciones y/o Devoluciones.
El monto total de la Transacción será abonado a la Cuenta del Comercio en caso que esta sea Aprobada.
Variables de Retorno
La petición regresara una respuesta en formato SOAP conteniendo la siguiente información:
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Admite números sin espacios. | Identificador del Comercio en OPENLINEA. Es un valor asignado. |
| subAfiliado | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 15 caracteres. | Identificador único del SubAfiliado |
| transaccionID | Alfanumérico | Letras y/o números sin espacios. No mayor a 20 caracteres. | Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio. |
| fechaTransaccion | Alfanumérico | Representación de fecha con formato MM/DD/AA | Fecha procesamiento de la Operación |
| horaTransaccion | Alfanumérico | Representación de hora con formato HH:MM:SS | Hora de procesamiento de la Operación. |
| concepto | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 15 caracteres. | Concepto del Cargo |
| monto | Numérico | Admite números, un punto y dos decimales sin espacios, no se permite comas o signos de pesos. | Monto a procesar total de la orden o pedido calculado por su aplicación en base a la selección de los servicios y/o productos del cliente. |
| codigoRespuesta | Numérico | Admite números sin espacios. | Se regresa los siguientes valores: 0 = Aprobada , 1= Rechazada |
| codigoAprobacion | Alfanumérico | Alfanumérico de longitud variable. | Código de Aprobación Bancaria, típicamente con 6 Dígitos |
| procReturnMsg | Alfanumérico | Alfanumérico de 1 a 10 caracteres. | Código retornado por el procesador de la tarjeta. |
| ccErrCode | 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 |