Bradescard
La tienda tiene la posibilidad de configurar el enrutamiento de las transacciones realizadas en Portal Carat mediante varios métodos de pago, uno de estos medios es Bradescard.
Interfaces de Portal Carat compatibles para la integración#
Usaremos las siguientes interfaces para la integración con el enrutamiento Bradescard:
- Pago REST
- Pago HTML
- Cancelación REST
- Cancelación a través del Portal del Comerciante
- Operación genérica para realizar consultas Bradescard
Servicio de Consultas Bradescard#
En las consultas de Bradescard, es posible consultar el resumen y consultar los saldos de una tarjeta específica.
Detalles de la llamada#
El servicio de consulta Bradescard es un servicio proporcionado por la interfaz operativa genérica (Más información). En el caso de la operación de consulta Bradescard, el token de autenticidad es obligatorio para cada consulta realizada, por lo que necesita obtener el token (Más información) y luego realizar la llamada de operación genérica (Más información).
La consulta Bradescard se identifica con el código de operación 172 (usa este valor en el campo operation en la requisa).
Parámetros de Consulta Bradescard#
A continuación se muestran los parámetros que utiliza la operación de consulta Bradescard.
| Parámetro | Descripción | Formato | Obligatorio |
|---|---|---|---|
date | Fecha fiscal. | N | No |
time | Hora fiscal. | N | No |
subfunction | Subfunción de transacción de consulta. Están previstas las siguientes consultas: 01 – Consulta de saldos 02 – Consulta de declaración de resumen | 2 N | Não |
card_entry_mode | Modo de entrada. Os valores possíveis para este campo são: 1 – Cartão magnético 2 – Número do cartão digitado | 1 N | Sim |
card_number | Este campo debe completarse con el número de tarjeta. | N | CONDICIONAL Sí, si el card_entry_mode es igual a "2" |
track1 | Este campo debe ser llenado con la pista 1 de la tarjeta. | < 99 AN | CONDICIONAL Sí, si el card_entry_mode es igual a "1" |
track2 | Este campo debe ser llenado con la pista 2 de la tarjeta. | < 99 N | CONDICIONAL Sim, se card_entry_mode es igual a "1" |
card_expiry_date | Fecha de vencimiento de la tarjeta. | 4 N (MMAA) | CONDICIONAL Sí, si el card_entry_mode es igual a "2" |
card_security_code | Código de seguridad. | < 10 N | CONDICIONAL Sí, si se solicita en la consulta de la tarjeta [(Más información)] (pagamento-rest-cardquery.md). |
card_issue_date | Fecha de emisión de la tarjeta. | 6 N (MMAAAA) | CONDICIONAL Sí, si se solicita en la consulta de la tarjeta (Más información). |
Parámetros de respuesta#
Si tiene éxito, el código de respuesta HTTP será 200. Cualquier otro código debe interpretarse como un error. En la siguiente tabla se encuentra la descripción de los parámetros de respuesta del servicio de consultas Bradescard:
| Parámetro | Descripción |
|---|---|
response_code | Código de respuesta de Portal Carat. |
response_message | Mensaje de respuesta de Portal Carat. |
authorizer_response_code | Código de respuesta del autorizador. |
authorizer_response_message | Mensaje de respuesta del autorizador. |
parameters.date | Fecha. |
parameters.time | Hora. |
parameters.acquirer_id | Id de la red adquirente en el SiTef. |
parameters.host_usn | NSU host. |
parameters.sitef_usn | NSU SiTef. |
parameters.institution_response_code | Código de respuesta del autorizador / adquirente |
parameters.institution_name | Nombre de la Institución. |
parameters.authorization_number | Numero de autorización. |
parameters.affiliation_code | Código de establecimiento en el autorizador / adquirente. |
parameters.confirmation_data | Datos de confirmación. |
parameters.customer_receipt | Vale del comprador. |
parameters.merchant_receipt | Vale de la Tienda. |
parameters.sale_response_data | Datos de respuesta de ventas. |
Códigos de respuesta
Ver referencia en Códigos API - Códigos de respuesta
Parámetros adicionales#
Los campos a continuación deben insertarse dentro de la estructura additional_data de la llamada de creación de transacciones. Más información
| Parámetro | Descripción | Formato | Obligatorio |
|---|---|---|---|
| additional_data | Elemento para el envío de datos adicionales. | ||
skip_cycles_days | Indica el aplazamiento del pago en días para compras a crédito en cuotas. | < 2 N | NO |
skip_cycles_periods | Indica el aplazamiento del pago en periodos o ciclos para compras a crédito en cuotas. | < 2 N | NO |
free_installments_indicator | Indica la existencia de cuota gratuita. | 1 N | NO |
card_holder_biometric_authentication | Información sobre autenticación biométrica. | < 6 AN | NO |
Detalles de los parámetros#
| Parámetro | Explicación |
|---|---|
skip_cycles_days | Número de días en formato 99. Ejemplo: 30 La ausencia indica el no uso de esta función. |
skip_cycles_periods | Número de periodos o ciclos en formato 99. Ejemplo 01 La ausencia indica el no uso de esta función. |
free_installments_indicator | 0-Indica sin cuota gratuita. 1-Indica con cuota gratuita. Se asume ausencia con el valor 0 |
card_holder_biometric_authentication | X;Y donde X - Código de tipo de autenticación, con valores: 1-Cliente desde MM/AA (el formato Y es YYMM) 2-Biometría (sin enviar valores en Y) 3-Cuenta almacenada (sin enviar valores en Y) Y-Información sobre el tipo de autenticación del titular de la tarjeta. Ejemplo: 1;23042 |
Ejemplo#
A continuación se muestra un ejemplo de la llamada del servicio de creación de transacciones utilizando la herramienta cURL.
Solicitud:
Respuesta:
Vale de Bradescard#
El Bradescard Voucher permite a un cliente que aún no tiene una tarjeta Bradescard realizar una compra con esta tarjeta en una tienda asociada de Bradescard.
En este caso, hay dos escenarios:
- La tienda tiene una impresora de tarjetas Bradescard y genera una tarjeta al instante.
- La tienda no tiene impresora de tarjetas Bradescard, por lo que genera una solicitud y recibe un PDF que contiene el información necesaria para completar la transacción.
Interfaces Portal Carat apoyado para la integración#
Usaremos las siguientes interfaces para la integración con el enrutamiento Bradescard Voucher:
- Pago REST
- Cancelación REST
- Cancelación a través del Portal del Comerciante
Pago REST#
El pago a través del Bradescard Voucher seguir el flujo de transacciones de pagos REST, siendo diferenciado enviando requerido de los campos a continuación durante la transacción de pago:
card.number- número de tarjeta ficticia;acquirer.authorization_number- código de autorización del voucher.
No se utilizan otros campos relacionados con los datos de la tarjeta (cvv, fecha de vencimiento, etc.).
Cancelación#
La cancelación de transacciones a través de Bradescard Voucher sigue el flujo existente, sin necesidad de enviar campos nuevos.
Para la cancelación a través del Portal del Comerciante, es necesario completar el número de tarjeta utilizado en la transacción.
Para obtener más detalles, consulte la documentación siguiente:
Consultas sobre saldos y estados de cuenta#
El vale de Bradescard no permite consultas de saldo y estado de cuenta.