Servicio de ejecución del pago con dos tarjetas.
Después de consumir el servicio de creación de transacciones y obtener un NIT, puede continuar con el siguiente paso en el flujo: la llamada al servicio de cumplimiento de pagos.
Esto se puede hacer ingresando solo un método de pago (ver el documento "[Servicio de pago] (pagamento-rest-dopayment.md)") o 2 (dos) métodos de pago .
En este capítulo, trataremos los pagos que se realizan con 2 (dos) métodos de pago, a los que llamamos Pago con múltiples métodos de pago .
Para utilizar esta función, comuníquese con nuestro soporte y solicite la activación en su tienda.
Flujo#
El flujo de un pago con múltiples métodos de pago tiene diferencias importantes en comparación con un pago tradicional.
La primera diferencia es que tenemos dos transacciones para la misma llamada y cada una de ellas sirve para pagar una de las formas de pago informadas. La primera transacción se crea en la llamada de creación de transacciones en Portal Carat y la segunda transacción se crea indirectamente en la llamada de método de pago múltiple.
La segunda diferencia es que, debido a esto, algunos datos de la primera transacción se modifican durante el proceso de pago . Inicialmente, la primera transacción tiene el monto total de la compra, cuotas y tipo de financiamiento. Cuando se realiza la convocatoria de pago con pagos múltiples, se cambia su valor para que sea el mismo que el de la primera forma de pago y lo mismo ocurre con las cuotas y el tipo de financiación, si estos se informan en la requisición. La segunda transacción tendrá el monto, cuotas y tipo de financiamiento informado por el segundo método de pago. Pero, en caso de que la segunda transacción no informe los datos de la cuota y el tipo de financiación, heredará esta configuración de la primera transacción original . La suma de los montos de la primera y segunda transacciones debe ser igual al monto ingresado en la creación de la primera transacción en Portal Carat .
La tercera diferencia es que la respuesta de pago múltiple se compone de las respuestas de cada una de las transacciones . Por lo tanto, habrá situaciones en las que la respuesta de una transacción afectará la respuesta de la otra.
A continuación, cubriremos los escenarios previstos en Portal Carat con más detalle.
Flujo de pago con confirmación automática#
El flujo de pago con confirmación automática para pagos con múltiples métodos de pago tiene una peculiaridad que es dividir el pago en 3 (tres) pasos : actualización / inicialización de transacciones; pagos; confirmaciones.
En caso de falla en alguna de las transacciones, Portal Carat no pasa al siguiente paso y realiza los tratamientos que se explicarán a continuación en los casos de falla.
Caso de éxito#
! [] (activos / pago-resto-pago múltiple-autoconfirm-éxito.png)
No pagar la primera transacción#
Cuando el primer pago falla, la segunda transacción se cancelará y el Autorizador no la activará. Se genera una incidencia para el equipo de soporte de Portal Carat y el comerciante, si lo desea, puede ponerse en contacto.
Respuesta ejemplo#
Cuando el segundo pago falla, la primera transacción se deshará. Se genera una incidencia para el equipo de soporte de Portal Carat y el comerciante, si lo desea, puede ponerse en contacto.
Respuesta ejemplo#
No confirmar la primera transacción#
Cuando falla la primera confirmación, la segunda transacción se deshará. Se genera una incidencia para el equipo de soporte de Portal Carat y el comerciante, si lo desea, puede ponerse en contacto.
Respuesta ejemplo#
No confirmar la segunda transacción#
Cuando la segunda confirmación falla, la primera transacción ya está confirmada y la cancelación, si se desea, debe realizarse manualmente , ya sea mediante la cancelación REST o el Portal del comerciante. Se genera una incidencia para el equipo de soporte de Portal Carat y el comerciante, si lo desea, puede ponerse en contacto.
! [] (assets / pago-resto-domultiplepayment-autoconfirm-t2-confirm-fail.png)
Respuesta ejemplo#
Flujo de pago con confirmación tardía#
El flujo de pago con confirmación tardía en pagos con múltiples métodos de pago tiene una peculiaridad que es dividir el pago en 2 (dos) fases : actualización / inicialización de transacciones; pagos.
En caso de falla en alguna de las transacciones, Portal Carat no pasa al siguiente paso y realiza los tratamientos que se explicarán a continuación en los casos de falla.
Caso de éxito#
! [] (activos / pago-descanso-en-pago-múltiple-posponer-confirmación-éxito.png)
No pagar la primera transacción#
Cuando el primer pago falla, la segunda transacción se cancelará y el Autorizador no la activará.
Respuesta ejemplo#
Si falla el pago en la segunda transacción#
Cuando el segundo pago falla, la primera transacción se deshará.
Respuesta ejemplo#
Detalles de la llamada#
- Recurso:
/ v1 / payments / multiple / {nit} - Método HTTP:
POST - Formato de solicitud:
JSON - Formato de respuesta:
JSON - Parámetros de encabezado:
| Parámetro | Descripción | Formato | Obligatorio |
|---|---|---|---|
merchant_id | Código de tienda en el Portal Carat. Los códigos de producción y certificación serán diferentes. | < 15 AN | SI |
merchant_key | Clave de autenticación para la tienda de pagos online. Las claves de producción y certificación serán diferentes. | < 80 AN | SI |
Content-Type | Debe enviarse con el valor application / json. | = 15 AN | SI |
Ejemplos#
A continuación, se muestran algunos ejemplos de llamadas al servicio de pago mediante la herramienta cURL.
Pago#
Solicitud:
Respuesta:
Pago con tarjeta almacenada#
Solicitud:
Respuesta:
Códigos de respuesta
Ver referencia en Códigos API - Códigos de respuesta
Parámetros de solicitud#
En la siguiente tabla, hay una descripción de los parámetros de solicitud para el servicio de procesamiento de pagos con múltiples métodos de pago:
| Parámetro | Descripción | Formato | Obrigatorio |
|---|---|---|---|
| multiple_payment_methods[] | Consiste en una array para pagos con múltiples métodos de pago donde cada artículo representa un método de pago. Se deben informar exactamente 2 (dos) ítems, los cuales están compuestos por los campos que se describen a continuación. | ||
authorizer_id | Código de autorizador en el Portal Carat. [Más información.] (Autorizadoras.md) Si este campo no se envió en el paso de creación de la transacción, se vuelve obligatorio al momento de consumir el servicio de pago. | < 3 N | SI |
installments | Número de plazos. Si no se informa, se utilizará el monto pasado en la inicialización del Portal Carat. | < 2 N | NO |
installment_type | Tipo de financiación. Si no se informa, se utilizará el monto pasado en la inicialización del Portal Carat. | < 2 N | NO |
amount | Monto de compra especificado por la tienda para este método de pago (en centavos). | < 12 N | SI |
number | Número de tarjeta del comprador (PAN). | < 19 N | SI |
expiry_date | Fecha de vencimiento de la tarjeta en formato "MMAY". Su obligación depende del comprador elegido. En la mayoría de los casos, este campo es obligatorio. | = 4 N | COND. |
token | HASH de una tarjeta almacenada en Portal Carat. No está permitido enviar un número de tarjeta abierta (campo número) y una tarjeta almacenada (campo token) en la misma solicitud. | = 88 AN | NO |
security_code | Código de seguridad. Este campo puede no ser obligatorio si la empresa tiene un acuerdo en el contrato firmado con las redes adquirentes, solo para el pago de ciertos segmentos. Sin embargo, es posible configurar el campo obligatorio en la configuración de la tienda, consulte el soporte de Carat para obtener más información. Importante: un pago agendado implica el almacenamiento de la tarjeta comprador de datos en el entorno de Portal Carat. Sin embargo, por razones de seguridad, el código de seguridad no se puede almacenar. Por tanto, los pagos programados siempre se ejecutarán sin enviar el código de seguridad. | < 5 N | COND. |
Parámetros de respuesta#
Si tiene éxito, el código de respuesta HTTP será "201". Cualquier otro código debe interpretarse como un error. En la siguiente tabla se muestra la descripción de los parámetros de respuesta del servicio de realización de pagos:
| Parámetro | Descripción | Formato |
|---|---|---|
code | Código de respuesta de Portal Carat para el funcionamiento de múltiples métodos de pago. Cualquier código que no sea "0" significa error. [Más información.] (codigos-da-api.md#codigos-de-resposta) | < 4 N |
message | Pago Mensaje de respuesta en línea para el funcionamiento de múltiples métodos de pago. | < 500 AN |
| payments[] | Consiste en una matriz de pagos con múltiples métodos de pago en la que cada artículo representa la respuesta correspondiente a uno de los métodos de pago. Los elementos se componen de los campos que se describen a continuación. | |
code | Código de respuesta de Portal Carat para la operación de pago de una de las formas de pago. Cualquier código que no sea "0" significa error. [Más información.] (codigos-da-api.md#codigos-de-resposta) | < 4 N |
message | Mensaje de respuesta de Portal Carat para la operación de pago de una de las formas de pago. | < 500 AN |
authorizer_code | Código de respuesta del autorizador. | < 10 AN |
authorizer_message | Mensaje de respuesta del autorizador. | < 500 AN |
status | Estado de la transacción de pago en Portal Carat. [Más información.] (codigos-da-api.md#status-de-transacões-do-e-sitef) | = 3 AN |
nit | Identificador de la transacción de pago en Portal Carat. | = 64 AN |
order_id | Código de pedido enviado por la tienda al crear la transacción. | < 20 AN |
merchant_usn | Número secuencial único enviado por la tienda al crear la transacción. | < 12 N |
amount | Monto de compra especificado por la tienda para este método de pago (en centavos). | < 12 N |
sitef_usn | Número secuencial único de la transacción de pago de SiTef. | = 6 N |
sitef_usn | Número secuencial único de la transacción de pago en Pagamento Online. | = 15 N |
customer_receipt | Cupón (a través del cliente). | < 4000 AN |
customer_receipt | Cupón (vía establecimiento). | < 4000 AN |
authorizer_id | Código de autorización utilizado en la transacción. | < 4 N |
adquisr_id | Código del adquirente utilizado en la transacción. | < 4 N |
adquirr_name | Nombre del adquirente utilizado en la transacción. | < 100 AN |
authorizer_date | Fecha de vigencia del pago devuelta por el autorizador en formato DD / MM / AAAA'T'HH: mm. Ejemplo: 07/13 / 2017T16: 03 | = 16 D |
authorization_number | Numero de autorización. | < 6 AN |
host_usn | Autorizador NSU. | < 15 AN |
tid | ID de transacción en el adquirente. Este campo solo se devuelve en transacciones con adquirentes que no son SiTef. | < 40 AN |
eci | Indicador de comercio electrónico (indicador del nivel de seguridad de las transacciones de pago a través de e-Commerce). | < 3 AN |
payment_date | Fecha de vigencia del pago en Portal Carat en el formato DD / MM / AAAA'T'HH: mm. Ejemplo: 07/13 / 2017T16: 03 | = 16 D |
issuer | Marca el código devuelto por el autorizador. | < 5 AN |
authorizer_merchant_id | Código de afiliación del comerciante con la agencia autorizadora. | < 100 AN |
xid | Campo XID devuelto en autenticaciones 3DS o ciertos adquirentes. | < 40 AN |
authentication_url | URL de autenticación devuelta en los flujos de pago con autenticación. | < 56 AN |
balance | Saldo disponible después del pago con tarjetas de regalo. | < 12 N |
| análisis.de.pagos | ||
code | Código de respuesta de la operación de análisis de fraude. | < 4 N |
message | Mensaje de respuesta a la operación de análisis de fraude. | < 200 AN |
status Numero de autorización. | < 6 AN | |
host_usn | Autorizador NSU. | < 15 AN |
tid | ID de transacción en el adquirente. Este campo solo se devuelve en transacciones con adquirentes que no son SiTef. | < 40 AN |
eci | Indicador de comercio electrónico (indicador del nivel de seguridad de las transacciones de pago a través de e-Commerce). | < 3 AN |
payment_date | Fecha de vigencia del pago en Portal Carat en el formato DD / MM / AAAA'T'HH: mm. Ejemplo: 07/13 / 2017T16: 03 | = 16 D |
issuer | código de la marca de la tarjeta devuelto por el autorizador. | < 5 AN |
authorizer_merchant_id | Código de afiliación del comerciante con la agencia autorizadora. | < 100 AN |
xid | Campo XID devuelto en autenticaciones 3DS o ciertos adquirentes. | < 40 AN |
authentication_url | URL de autenticación devuelta en los flujos de pago con autenticación. | < 56 AN |
balance | Saldo disponible después del pago con tarjetas de regalo. | < 12 N |
| análisis.de.pagos | ||
code | Código de respuesta de la operación de análisis de fraude. | < 4 N |
message | Mensaje de respuesta a la operación de análisis de fraude. | < 200 AN |