Pago Split
El Pago de transacciones múltiples es una función dirigida a los comerciantes que venden un producto / servicio de terceros. Permitiendo, a través de una sola requisición, la separación del valor principal y el producto / servicio, de tal forma que el monto se asigne directamente a los establecimientos involucrados.
El valor total de cualquier venta se divide en N partes y se envía (vía POST/HTML) a N empresas diferentes (N merchantId´s distintos) definidas por la aplicación web y debidamente registradas en Portal Carat.
Ejemplo: Tomando como ejemplo una venta de R$ 100,00, podemos realizar una sola solicitud para enviar el monto de R$ 60,00 al fabricante principal del producto, R$ 20,00 a un fabricante de accesorios y R$ 20,00 al proveedor de servicio.
Interfaces de Portal Carat compatibles para la integración con el pago SPLIT#
La interfaz utilizada es POST HTML con JSON.
Puede utilizar las siguientes interfaces para la integración con el pago de transacciones múltiples:
- Interfaz de pago HTML 2.0 (documento "[Pago HTML] (pagamento-html-fluxo.md)")
- Cancelación de la interfaz WS versión 2 (documento "[Cancelación REST] (cancelamento-rest-fluxo.md)").
Nota : Si la tienda está iniciando la primera integración con Portal Carat, se recomienda realizar la integración a través de [Pago HTML] (pagamento-html-fluxo.md), ya que ofrece una mejor experiencia de usuario y una interfaz más moderna para el integración con el sistema de tienda.
Funciones de Portal Carat NO permitidas para la integración con el pago de transacciones múltiples#
El Portal Carat no permite la integración (en la misma transacción) entre un pago de transacciones múltiples y las siguientes funciones de Portal Carat:
- Transacción de análisis de riesgo manual (donde el pago HTML está pendiente de confirmación adicional por parte de la tienda mientras la tienda realiza el análisis de riesgo por separado del Portal Carat);
- Transacción de recarga de crédito de teléfono celular prepago asociada con el pago;
- Almacenamiento de tarjeta durante el pago.
Configuración de Portal Carat requerida#
El comerciante que quiera realizar pagos de transacciones múltiples debe solicitar al equipo de registro para que se active el permiso para este tipo de pago.
Parámetros utilizados para realizar un pago de transacciones múltiples#
Al realizar pagos de transacciones múltiples, los parámetros POST abajo tienen los siguientes conceptos:
| Nombre del parámetro | Descripción | Tamaño | Obligatorio |
|---|---|---|---|
amount* | Se debe enviar el monto total del pago, es decir, el monto de la transacción principal sumado a las demás. | <= 1024 N | SI |
installments** | Se utilizará para todas las transacciones secundarias. La transacción principal siempre será en efectivo. | <= 1024 N | SI |
(*) Portal Carat validará los valores con el total enviado (amount). Si se produce alguna diferencia, la transacción se anulará.
(\ \ ) En caso de pago a plazos, la transacción principal siempre será en efectivo y las transacciones secundarias se dividirán en cuotas, con el mismo número de cuotas entre ellas.
Las transacciones secundarias son todas las transacciones vinculadas a la transacción principal. Para la requisición, es posible tener un máximo de 16 (dieciséis) transacciones secundarias. Cuanto mayor sea el número de transacciones enviadas, mayor será la demora en la respuesta debido al mayor procesamiento de múltiples transacciones.
Si hay algún problema durante el flujo completo de Pago de transacciones múltiples, Portal Carat deshará todas las transacciones ya aprobadas para ese flujo de pago. Ej .: La aplicación realizó un flujo de pago que contenía 3 merchantId’s, se aprobó la primera transacción de merchantId , pero se denegó la segunda transacción de merchantId . Como ocurrió un error en el flujo de pago en la segunda transacción (status = NEG), Portal Carat deshará la primera (Status = PPN) y negará el flujo por completo, devolviendo * NEG * también para la tercera transacción, incluso si no se ha realizado ningún intento de pago. En los casos en los que Portal Carat deniega una de las transacciones, además del comportamiento descrito anteriormente (negar todas las transacciones), se muestra el mensaje “Split denegado” en el informe de la transacción (Portal de la tienda) en el campo “Mensaje”.
Los parámetros JSON abajo tienen los siguientes conceptos:
ADDITIONAL_DATA (additional_data)#
| Nombre del parámetro | Descripción | Tamaño | Obligatorio |
|---|---|---|---|
| method | Se utiliza para realizar una transacción diferenciada. Si desea realizar una transacción de transacciones múltiples, este campo debe recibir el texto "SPLIT". | <= 1024 A | SI |
| extra_amount | Se utilizará para recibir el importe de la transacción principal | <= 1024 N | SI |
INNER_TRANSACTIONS (inner_transactions)#
| Nombre del parámetro | Descripción | Tamaño | Obligatorio |
|---|---|---|---|
| merchant_id | Código de la tienda de Portal Carat que se utilizará en cada transacción secundaria. | <= 1024 A | SI |
| amount | Se debe enviar el monto total del pago por cada transacción secundaria, siempre respetando el límite del monto total del pago. | <= 1024 N | SI |
| order_id | Almacene el código de pedido que se utilizará para cada transacción secundaria. | <= 1024 A | NO |
| merchant_usn | Almacene el número secuencial que se utilizará en cada transacción secundaria. | <= 1024 A | NO |
IMPORTANTE 1 : Los autorizadores configurados para una tienda secundaria deben ser los mismos que los configurados para la tienda enviada en la transacción principal. Sin embargo, no existe ningún impedimento para que las rutas sean diferentes entre tiendas. Ejemplo: la tienda 1 configurada con la red de adquirentes de Visa y Cielo, la tienda 2 configurada con la red de adquirentes de Visa y Rede es un escenario válido.
IMPORTANTE 2 : Si alguna de las transacciones es denegada, sea cual sea el motivo (falla de comunicación, saldo insuficiente, etc.), el comportamiento predeterminado será deshacer / denegar todas las transacciones involucradas. La funcionalidad fue desarrollada con la premisa de confirmar o negar todas las transacciones.
Advertencia de Staus#
El aviso de status enviado por Portal Carat a la URL de aviso de status de la tienda tiene un campo adicional en caso de transacciones de transacciones múltiples.
| Nombre del parámetro | Descripción | Tamaño |
|---|---|---|
| NITTransacaoSecundaria | Campo compuesto por merchantIds y NIT´s de las transacciones secundarias, en el formato (merchantId1:nit1|merchantId2:nit2) | <= 1296 A |
El campo NITTransacaoSecundaria se envía en el aviso de Status de la transacción principal, indicando los NIT´s de las transacciones secundarias y permitiendo así la consulta de Status de todas ellas.
Ejemplo de campo NITTransacaoSecundaria para 2 transacciones secundarias:
NITTransacaoSecundaria=LOJATESTE:95f386518449f6be6b4d25449989b5cee7736eb93ce96901ea2338a76fd01ad8|LOJATESTE2:95f386518449f6bea6fed3e03f7326fbe7736eb93ce96901dc1d6fba16d8f011
Ejemplos de llamadas#
Ejemplo de llamada con parámetros de transacción de Portal Carat + datos de pago de transacciones múltiples en Formato JSON para [Pago HTML] (pagamento-html-fluxo.md):