Getnet

La tienda tiene la posibilidad de configurar el enrutamiento de las transacciones realizadas con tarjeta de crédito en Portal Carat mediante varios métodos de pago, uno de los cuales es Getnet.

En esta página se utilizará la nomenclatura "GetnetWS" 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 enruten a través de GetnetWS mientras que las realizadas con MASTERCARD se enruten a través de CIELO.

Interfaces en línea pagas compatibles con la integración#

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

Pago REST
Autorización previa de REST
Cancelación de REST
Pago HTML
Autorización previa HTML

Autorizadores permitidos#

Los siguientes autorizadores son compatibles con el enrutamiento GetnetWS:

VISA
MASTERCARD
ELO
AMERICAN EXPRESS
HIPERCARD

Credenciales requeridas#

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

Campo	Descripción	Formato
`username`	Usuario de acceso.	< 20 N
`password`	Contraseña de acceso.	< 40 AN
`merchantID`	Código EC registrado en GetnetWS.	< 10 AN
`terminal`	Identificación del terminal.	< 7 AN
`subMerchantId`	ID comercial secundario.	< 15 AN

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

Registro de información a través del portal del comerciante#

El propio comerciante puede registrar la información obtenida con GetnetWS en el Portal del comerciante en línea de Pago. En este entorno, será posible cambiar la configuración de autenticación de transacciones y la contraseña. Para ello, el comerciante debe seleccionar el autorizador e ingresar a la pantalla de edición como se muestra en el siguiente ejemplo:

-no-filter

En el Portal del Comerciante, en el entorno de edición del autorizador, es posible cambiar la contraseña registrada en el entorno Portal Carat. En este caso, el cambio solo se realizará para este autorizador. Tenga en cuenta que si las tiendas utilizan la misma cuenta de Getnet, los minoristas deberán cambiar manualmente las contraseñas de todos los demás Autorizadores.

Además, en este entorno, también puede cambiar la contraseña de registro de Getnet. Es importante recordar que al cambiar esta contraseña en el entorno Getnet, todas las tiendas asociadas a esta cuenta Getnet también deberán cambiar la contraseña registrada en el entorno Portal Carat yendo a la pantalla de edición de sus autorizadores, de lo contrario sus transacciones serán negado por Getnet.

La pantalla de ejemplo de cambio de contraseña de Getnet es la siguiente:

-no-filter

La nueva contraseña debe seguir las reglas definidas por Getnet. Estas reglas se encuentran en el documento de integración.

Subcompra#

Nuestro equipo de soporte registra la sub-adquisición de información. Se requieren los siguientes datos:

Parámetro	Formato
ID de subcomercio	< 15 AN
Ciudad de subcomercio	< 13 A
estado de subcomercio	= 2 A
Código postal de subcomercio	= 8 N
CNPJ o CPF de subcomercio	< 15 AN
Dirección subcomercial	< 40 AN
MCC	= 4 N
Soft-Descriptor	< 22 AN [Obtenga más información sobre esta función].(soft-descriptor.md#getnet-ws)

También es posible enviar los campos a continuación en las solicitudes realizadas a Portal Carat:

Parámetro	Campo	Comentarios
ID de subcomercio	`subacquirer_merchant_id`	Enviado en el servicio de cumplimiento de transacciones.
MCC	`mcc`	Enviado en el servicio de cumplimiento de transacciones.
Soft-Descriptor	`soft_descriptor`	Presentado en el servicio de creación de transacciones.

Si los campos anteriores están registrados en la tienda Portal Carat y se envían en la requisición, el valor mostrado en la requisición tiene prioridad.

Recurrencia#

Para que GetnetWS reconozca las recurrencias, existen algunas reglas que explicaremos a continuación.

Los campos utilizados para la recurrencia se muestran en la siguiente tabla.

Campo	Descripción	Formato
`acquirer.recurrency`	Enviado bajo pedido. Flag que define si el pago es recurrente o NO.	< 5 T / F
`purchaser.recurrency_tid`	Enviado bajo pedido. ID de transacción de la primera transacción de la recurrencia. Identificador que diferencia la primera recurrencia de las posteriores.	= 18 N
`purchaser.recurrency_seq_id`	Enviado bajo pedido. Número de porción de recurrencia.	< 3 N
`payment.tid`	Recibido en respuesta. ID de transacción en el adquirente.	= 18 N

Si el comerciante elige realizar las recurrencias por su cuenta , debe seguir los pasos:

Paso 1: Primera recurrencia:
- Enviar acquirer.recurrency con valor true;
- almacenar el payment.tid para usar en recurrencias posteriores.
Paso N: Siguientes recurrencias:
- Enviar acquirer.recurrency con valor true;
- Enviar acquirer.recurrency_tid con el valor devuelto en el payment.tid de Paso 1;
- Enviar acquirer.recurrency_seq_id con el número de parcela correspondiente a la repetición realizada (de 1 a 999 como máximo).

Si el comerciante opta por realizar las recurrencias a través del servicio de programación Portal Carat , los parámetros de recurrencia se enviarán automáticamente y el seguimiento se puede realizar a través del informe de programación con normalidad.

Si el minorista opta por realizar las recurrencias a través del servicio de pago con programación en Portal Carat , los parámetros de recurrencia se enviarán automáticamente y el seguimiento se podrá realizar a través del informe de programación con normalidad. Sin embargo, una peculiaridad es que el ID utilizado para identificar la primera transacción de la recurrencia es el ID del pago inicial y no el ID del primer horario.

Flujos#

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

Pago HTML#

Es posible realizar un pago con autenticación 3DS. Para hacer esto, simplemente envíe el parámetro authorizer_authentication con valor true en el paso de creación de la transacción.

Campos relevantes en la convocatoria descrita en Servicio de creación de Transacciones HTML y en el Servicio de Creación de Transacciones REST:

Parámetro	Descripción	Formato	Obligatorio
`authorizer_authentication`	Define si el comerciante desea un pago con autenticación en la autoridad autorizante. Mandar `true` si positivo.	< 5 AN	SI para crédito con autenticación
iata	Este elemento contiene campos específicos que serán obligatorios, si las transacciones son con IATA.
`first_installment`	Entrada en transacciones IATA en centavos.	< 12 N	Condicional (uso obligatorio solo para transacciones IATA - venta de boletos aéreos)
`departure_tax`	Impuesto de salida en centavos.	< 12 N	Condicional (uso obligatorio solo para transacciones IATA - venta de boletos aéreos)

Preautorización#

No es posible realizar una preautorización con pago a plazos a través del emisor.

Campos relevantes en la convocatoria descrita en Servicio de creación de Transacciones HTML y en el Servicio de Creación de Transacciones REST:

Parámetro	Descripción	Formato	Obligatorio
iata	Este elemento contiene campos específicos que serán obligatorios, si las transacciones son con IATA.
`first_installment`	Entrada en transacciones IATA en centavos.	< 12 N	Condicional (uso obligatorio solo para transacciones IATA - venta de boletos aéreos)
`departure_tax`	Impuesto de salida en centavos.	< 12 N	Condicional (uso obligatorio solo para transacciones IATA - venta de boletos aéreos)

Cambio de autorización previa#

Es posible reenviar la solicitud de ejecución de autorización previa más el campo amount para cambiar su valor.

Parámetro	Descripción	Formato	Obligatorio
`amount`	Nuevo monto de preautorización en centavos.	< 12 N	SÍ

Pago y preautorización de REST#

El campo card.holder es obligatorio.
GetnetWS acepta el envío de datos de autenticación eci, xid y cavv.

Parámetro	Descripción	Formato	Obligatorio
`card`.`holder`	Nombre del titular de la tarjeta impreso en la tarjeta	< 26 AN	SÍ
`external_authentication`.`eci`	Código ECI de la transacción 3D Secure autenticada.	= 2 N	NO
`external_authentication`.`xid`	Identificador de MPI para cada transacción autenticada.	< 40 AN	NO
`external_authentication`.`cavv`	Código de autenticación cifrado por la bandera.	< 40 AN	NO

Cancelación#

La cancelación de una transacción se puede realizar en el Portal del comerciante. Solo se pueden cancelar las transacciones realizadas el día actual de la cancelación. El comerciante puede cancelar transacciones de preautorización con o sin transacciones de captura y pago. En el caso de cancelar una transacción de preautorización con captura, Getnet cancelará la captura, sin embargo, Portal Carat mostrará esta transacción de preautorización con estado cancelado (y captura confirmada).

Home