SafraPay

La tienda tiene la posibilidad de configurar el enrutamiento de las transacciones realizadas con tarjeta de crédito en Portal Carat a través de varios métodos de pago, uno de estos medios es SafraPay.

En esta página, se utilizará la nomenclatura "SafraPay" para hacer referencia al enrutamiento en Portal Carat.

Así, la tienda puede configurar Portal Carat para que las transacciones realizadas con tarjetas VISA, por ejemplo, se encaminen a través de SafraPay mientras que las realizadas con MASTERCARD se encaminen a través de CIELO.

Interfaces Portal Carat apoyado para la integración#

Puede utilizar las siguientes interfaces para la integración con el enrutamiento de SafraPay:

Pago REST
Preautorización REST
Pago HTML
Autorización previa HTML
Cancelación de REST
Cancelación vía Portal

Autorizadores permitidos#

Los siguientes autorizadores son compatibles con el enrutamiento de SafraPay:

VISA
MASTERCARD
ELO
AMERICAN EXPRESS
HIPERCARD

Credenciales requeridas#

La tienda debe obtener las credenciales que se enumeran a continuación de SafraPay y pasarlas a Software Express o registrarse como se explica más adelante en este documento.

Campo	Descripción	Formato
`merchantID`	Código EC registrado en SafraPay.	< 15 AN
`terminalId`	Identificación del Terminal.	< 8 AN

Importante para Pago HTML : En caso de que un autorizador de la tienda no haya registrado estas credenciales, ese autorizador no se mostrará en la pantalla de selección de tarjeta de crédito durante la operación de pago.

Registro de información por el Portal del Comerciante Portal Carat#

El dueño de la tienda puede registrar la información obtenida con SafraPay en el Portal del Comerciante do Portal Carat. Para ello, el comerciante debe seleccionar el autorizador e ingresar a la pantalla de edición como se muestra en el siguiente ejemplo:

Portal SafraPay -no-filter

Descubra más detalles sobre el Portal del Comerciante.

Flujos#

En esta sección se presentarán las particularidades del flujo transaccional de SafraPay.

Pago REST / HTML#

A continuación se enumeran los campos que se diferencian y son relevantes para SafraPay:

REST Begin / HTML Init#

Campos relevantes en la convocatoria descrita en Servicio de creación de transacciones HTML y en servicio de creación de transacciones REST:

Parámetro	Descripción	Formato	Obligatorio
`soft_descriptor`	Texto adicional que aparecerá con el nombre del establecimiento en el extracto de la tarjeta de crédito del comprador. Sepa mas	< 30 AN	NO
additional_data	Elemento para enviar datos adicionales.
`postpone_confirmation`	Campo que permite a la tienda mantener la transacción como Pendiente de Confirmación, y luego confirmarla o cancelarla.	< 5 A	NO
`transaction_initiated_by`	Indica si la transacción fue iniciada por el comerciante o el comprador. Relevante cuando se usa junto con, por ejemplo, transacciones recurrentes que son iniciadas por el comerciante (merchant). Valores permitidos: `customer` – Transacción iniciada por el Comprador. `merchant` – Transacción iniciada por el comerciante.	< 8 AN	NO
`total_order_amount`	Importe final de compra.	< 8 AN	NO
`tax_amount`	Importe de la cuota.	< 8 AN	NO
additional_data.payer	Elemento de envío de datos referentes al comprador.
`id`	Identificación del comprador.	< 200 AN	NO
`name`	Nombre del comprador. Nota: la concatenación del nombre con el apellido NO puede exceder los 255 caracteres.	< 200 AN	NO
`surname`	Apellido del comprador. Nota: la concatenación del nombre con el apellido NO puede exceder los 255 caracteres.	< 200 AN	NO
`identification_number`	Número de identificación del comprador.	< 200 AN	NO
`identification_type`	Tipo de identificación proporcionada por el comprador (RG, CPF, etc.).	< 200 AN	NO
`email`	Correo electrónico del comprador.	< 255 AN	NO
additional_data. payer.phones[]	Solo se transferirá 1 teléfono a Safrapay.
`ddi`	IDD en el teléfono.	< 255 AN	NO
`ddd`	Código de área del teléfono.	< 15 AN	NO
`number`	Numero de teléfono.	< 50 AN	NO
additional_data. shipment.receiver_address	Elemento de envío de datos referentes a la dirección de entrega.
`street_name`	Dirección de entrega.	< 255 AN	NO
`street_number`	Número de dirección de entrega.	< 15 AN	NO
`complement`	Complemento de dirección de entrega.	< 50 AN	NO
`county`	Barrio de la dirección de entrega.	< 150 AN	NO
`zip_code`	Código postal de la dirección de entrega. Ex.: 21241-140.	< 9 AN	NO
`city`	Ciudad de dirección de entrega.	< 50 AN	NO
`state`	Estado de la dirección de entrega.	= 2 AN	NO
`country`	Pallí desde la dirección de entrega siguiendo el AN 3166-1. Ex.: BRA	= 3 AN	NO
additional_data. billing_data.address	Elemento de envío de datos referentes a la dirección de facturación.
`street_name`	Dirección de cora	< 255 AN	NO
`street_number`	Número de dirección de cora.	< 15 AN	NO
`complement`	Dirección Complemento de cora.	< 50 AN	NO
`county`	Barrio de la dirección de cora.	< 150 AN	NO
`zip_code`	código postal de la dirección de cora. Ex.: 21241-140.	< 9 AN	NO
`city`	Ciudad de dirección de cora.	< 50 AN	NO
`state`	Estado de la dirección de cora.	= 2 AN	NO
`country`	país de dirección de cora segun a AN 3166-1. Ex.: BRA	= 3 AN	NO
additional_data.items[]	Elemento de envío de datos referentes a los productos del comprador.
`title`	Nombre del producto.	< 255 AN	NO
`quantity`	Cantidad de producto a comprar.	< 15 N	NO
`id`	Código de comerciante de identificador de producto.	< 255 AN	NO
`unit_price`	Precio unitario del producto en centavos.	< 15 N	NO
`discount_amount`	Valor en centavos de descuento del producto	< 12 AN	NO

Actualmente, SafraPay NO permite cuotas con interés de la empresa de tarjetas, es decir, el campo installments_type NO puede recibir el valor "3" y el valor "6".

Efectividad de pago#

Campos relevantes en la convocatoria descrita en Servicio de pago:

Parámetro	Descripción	Formato	Obligatorio
external_authentication	Este elemento recibe campos de autenticación MPI.
`eci`	Eletronic Commerce Indicator – indica el nivel de seguridad de la transacción con autenticación del titular de la tarjeta	< 3 N	NO
`xid`	Identificador de la operación de autenticación del titular de la tarjeta, realizada en un servicio externo al Portal Carat	< 40 N	NO
`cavv`	Cardholder Authentication Verification Value - Ccódigo que indica el resultado de la autenticación del titular de la tarjeta.	< 40 N	NO
`cavv_key_indicator`	Indicador de 2 dígitos utilizado por la bandera ELO.	< 2 N	NO
`unpredictable_number`	Indicador numérico utilizado por la bandera ELO.	-	NO
`auth_tracking_number`	Indicador numérico utilizado por la bandera ELO.	-	NO

Ingrese los campos de respuesta de Servicio de pago, el campo issuer se completará con el código de marca de la tarjeta que se reconoció en el pago. A continuación se muestra la lista de códigos y bandera:

Código	Bandera
`1`	VISA (crédito)
`20002`	VISA (débito)
`2`	MASTERCARD
`20001`	MASTERCARD (débito)
`4`	AMEX
`12`	HIPERCARD (crédito)
`20037`	HIPERCARD (débito)
`31`	ELO (crédito)
`20032`	ELO (débito)

La confirmación del pago#

Es posible confirmar un valor menor que el valor de las autorizaciones creadas vía HTML e vía vía REST utilizando el campo additional_data.postpone_confirmation igual a true.

Para ello, envíe la confirmación REST el valor de amount deseado:

Parámetro	Descripción	Formato	Obligatorio
`confirm`	Este campo debe enviarse con el valor `true` si desea confirmar la transacción, o `false`, en caso de que desee deshacer el pago.	< 5 T/F	SI
`amount`	Valor en centavos del valor que se confirmará. Si se envía NO, se confirmará el monto total de la transacción.	< 12 N	NO

Reaparición#

SafraPay acepta parámetros de señalización de recurrencia de transacciones. Para ello, envíe el campo en la llamada de pago REST. acquirer.recurrency con valor true.

Para obtener más información, consulte la página sobre Servicio de eficiencia de pago REST.

Preautorización#

Por lo general, el plazo de una autorización previa se procesa en el Servicio de captura de autorización previa, pero SafraPay es una de las excepciones. Llenar los campos installments y installment_type se procesará en el cumplimiento de la preautorización o al inicio de una transacción de preautorización. Para obtener más detalles sobre cómo completar este campo, consulte:

Actualmente, SafraPay NO permite cuotas con interés de la empresa de tarjetas, es decir, el campo installments_type NO puedo usar el valor 3 y el valor 6 (IATA).

Cancelación#

La cancelación de una transacción se puede hacer en Portal del Comerciante o via Web Service REST. Las transacciones realizadas el día actual de cancelación (T + 0) o en otros días (T + N) pueden cancelarse. El comerciante puede cancelar las transacciones de pago que se han confirmado, así como las que aún no se han confirmado.

También es posible cancelar importes inferiores al pago original, tanto en transacciones confirmadas como NO confirmadas. En el caso de transacciones NO confirmadas, solo es posible una cancelación parcial.

El procesamiento de las transacciones de cancelación de SafraPay se lleva a cabo en la ventana entre las 0 a. M. Y las 6 a. M. Aconsejamos que NO se realicen cancelaciones durante este período.

IATA#

El enrutamiento de SafraPay admite pagos con IATA (International Air Transport Association). Por tanto, los campos departure_tax y first_installment se procesará en el servicio de creación de transacciones de pago REST.

Home