Bin

En este ítem, se presentarán las características específicas para el enrutamiento de contenedores a través de SiTef.

Pago REST#

Efectividad de pago#

A continuación se enumeran los parámetros con datos específicos para la transacción a través de Bin que la aplicación de la tienda web puede enviar en el Servicio de pago REST:

Parámetro	Descripción	Formato	Obligatorio
external_authentication
`ucaf_sli`	Contiene UCAF (Universal Cardholder Authentication Field), que corresponde al último dígito del SLI (Security Level Indicator) de Mastercard Secure Code (para bandera MasterCard).	= 1 N	NO
`version`	Versión del 3DS (`1` ou `2`).	= 1 N	NO
`reference_id`	Identificador del Directory Server para transacciones 3DS 2.0.	< 36 AN	NO
`tavv`	Criptograma de transacción tokenizada DSRP-UCAF.	< 40 AN	NO
`cavv`	Valor de verificación de autenticación del titular de la tarjeta: código que indica el resultado de la autenticación del titular de la tarjeta.	< 40 N	NO

Parámetros de tarjeta en archivo#

Definiciones#

Se aceptan los siguientes valores para los parámetros usage y reason, dentro de acquirer.card_on_file:

`usage`	Definición
`first`	Indicar la primera ocurrencia
`subsequent`	Indicar ocorrencias posteriores de una recurrencia
`authorized`	Para utilizar junto con el parámetro `reason=card` para indicar que el titular de la tarjeta ha autorizado el almacenamiento de la misma

`reason`	Definición
`cardholder`	Compras posteriores provocadas por el titular de la tarjeta
`unscheduled`	Compras posteriores sin programar
`recurring`	Compras recurrentes programadas
`installment`	Cuota por recurrencia
`card`	Debe utilizarse junto con el parámetro `usage=authorized` para indicar que el titular de efectivo ha autorizado el almacenamiento de la tarjeta

MIT y CIT#

Hay dos tipos de transacciones con tarjeta registrada: CIT (Transacción iniciada por el titular de la tarjeta) y MIT (Transacción iniciada por el comerciante)

Sigla	Definición
CIT	Es cualquier transacción en la que el titular de la tarjeta participa activamente en la transacción, ya sea en una terminal en la tienda o através de una experiencia de pago online.
MIT	Es una transacción posterior con las credenciales ya almacenadas, para la cual el titular de la tarjeta ha dado su consentimiento previo al comerciante para almacenar las credenciales de pago para uso futuro, sin su participación activa. Tal sería el caso de la facturación automática de los servicios de suscripción, por citar un ejemplo.

Combinaciones válidas#

`usage`	`reason`	Definición	¿MIT/CIT?
`authorized`	`card`	Indica que el titular de la tarjeta ha autorizado el almacenamiento de la tarjeta	CIT
`first`	`unscheduled`	Indica un pago único	MIT
`first`	`recurring`	Indica la primera la primera ocurrencia de una recurrencia	MIT
`subsequent`	`recurring`	Indica ocurrencias posteriores de una recurrencia	MIT
`subsequent`	`cardholder`	Indica un pago realizado por el usuario con la tarjeta ya almacenada	CIT
`subsequent`	`unscheduled`	Indica una ocurrencia posterior no programada iniciada por el comerciante	MIT
`subsequent`	`installment`	Indica cuota por periodicidad	MIT

Token de marca de tarjeta#

Algunas marcas de tarjetas poseen una solución de tokenización que ofrece el almacenamiento de tarjetas en cajas fuertes en la propia marca, de forma encriptada. Esta tokenización de marca tiene como objetivo mejorar la seguridad y la calidad de la información de la tarjeta transmitida, lo que conduce a posibles aumentos en la conversión de la aprobación por parte de los bancos emisores.

Parámetro	Descripción	Formato	Requerido
`card`
`number`	Token generado por la tarjeta (DPAN).	≤ 19 N	Sí
`cryptogram`	Criptograma generado por la tarjeta.	= 28 A	Sí para pagos con token de marca de tarjeta
`wallet_type`	Campo que especifica si la transacción se procesa con PAN o DPAN. Si hay una transacción tokenizada, debes enviar el valor “network_token”.	AN	Sí para pagos con token de marca de tarjeta

Solicitud Pago:

curl
--request POST "https://{{url}}/e-sitef/api/v2/payments/"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
   "merchant_usn":"1709151775",
   "order_id":"0001709151774770",
   "installments":"1",
   "installment_type":"4",
   "authorizer_id":"2",
   "amount":"100",
   "soft_descriptor": "Empresa Aluguel de carros XYZ",
    "card":{
      "number":"555555555555555",
      "expiry_date":"1227",
      "security_code":"157",
      "cryptogram": "ALRzlt6NKQtPAAZAkOuIAAADFA==",
      "wallet_type": "network_token"
   }
}
--verbose

Parámetros de respuesta

Parámetro	Descripción	Formato
`card`
`par`	EMVCo introdujo PAR (Payment Account Reference) para proporcionar un enfoque alineado con la industria diseñado para ayudar a vincular todas las transacciones asociadas con una cuenta específica, basada en tokens, sin utilizar PAN como mecanismo de vinculación.	< 32
`suffix`	Últimos cuatro dígitos del PAN, devueltos por Visa y Mastercard en transacciones realizadas con DPAN (Token de marca de tarjeta).	= 4

Respuesta Pago:

{
    "code": "0",
    "message": "OK. Transaction successful.",
    "payment": {
        "authorizer_code": "000",
        "authorizer_message": "TRANSACAO APROVADA",
        "status": "CON",
        "nit": "1854a5dac2033afc012c4ed807183bf77f6179a75c79ec81c770a0bde8aef583",
        "order_id": "0001709151774770",
        "customer_receipt": "====CUPOM COMPRADOR====",
        "merchant_receipt": "====CUPOM ESTABELECIMENTO====",
        "authorizer_id": "2",
        "acquirer_id": "229",
        "acquirer_name": "Bin (Via Servicos TEF)",
        "authorizer_date": "28/02/2024T17:22",
        "authorization_number": "226596",
        "merchant_usn": "1709151775",
        "esitef_usn": "240228062687260",
        "sitef_usn": "816339",
        "host_usn": "43734572890",
        "amount": "100",
        "payment_type": "C",
        "terminal_id": "ES000001",
        "card_par": "hI3C1LmpTY46qNx4YlsyOvbRQBg3o",
        "payment_date": "28/02/2024T17:22",
        "recurrency_tid": "055950827503911"
    },
    "card": {
        "par": "hI3C1LmpTY46qNx4YlsyOvbRQBg3o",
        "suffix": "0042"
    }
}

Solicitud Autorización Previa:

curl
--request POST "https://{{url}}/e-sitef/api/v2/preauthorizations/"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
   "merchant_usn":"1709151775",
   "order_id":"0001709151774770",
   "installments":"1",
   "installment_type":"4",
   "authorizer_id":"2",
   "amount":"100",
   "soft_descriptor": "Empresa Aluguel de carros XYZ",
    "card":{
      "number":"555555555555555",
      "expiry_date":"1227",
      "security_code":"157",
      "cryptogram": "ALRzlt6NKQtPAAZAkOuIAAADFA==",
      "wallet_type": "network_token"
   }
}
--verbose

Respuesta Autorización Previa:

{
    "code": "0",
    "message": "OK. Transaction successful.",
    "card": {
        "par": "A80pcFJxz0FgEK6qDggFpM5KUl2Jf",
        "suffix": "0042"
    },
    "pre_authorization": {
        "authorizer_code": "000",
        "authorizer_message": "TRANSACAO APROVADA",
        "status": "CON",
        "nit": "74e3fa7509d683c73240e4868ec7b75b14170547567b809f6f2698f234ab8f4f",
        "order_id": "0001709151682784",
        "customer_receipt": "====CUPOM COMPRADOR====",
        "merchant_receipt": "====CUPOM ESTABELECIMENTO====",
        "authorizer_id": "2",
        "acquirer_id": "2651",
        "acquirer_name": "Bin (Via Servicos TEF)",
        "authorizer_date": "28/02/2024T17:21",
        "authorization_number": "242440",
        "merchant_usn": "1709151683",
        "esitef_usn": "240228062687254",
        "sitef_usn": "304331",
        "host_usn": "43734572891",
        "amount": "100",
        "payment_type": "C",
        "terminal_id": "ES000001",
        "card_par": "A80pcFJxz0FgEK6qDggFpM5KUl2Jf",
        "recurrency_tid": "969452034274685"
    }
}