Crear Token

Este servicio tiene como función capturar los datos de la tarjeta y devolver un Token en su lugar.

Ambiente	EndPoint	Método
Desarrollo	https://api.dev.alignet.io/tokens	POST
Producción	https://api.alignet.io/tokens	POST

Headers

Cabecera	Valor	Requerido
Content-Type	application/json	SI
ALG-API-VERSION	Versión del API a utilizar. Valores disponibles: 1618440906	SI
Authorization	Bearer <Access_Token>	SI

JSON

"Content-Type":"application/json",
"ALG-API-VERSION":"1618440906",
"Authorization":"Bearer GciOiJSUzI1NsInR5cCI6IkpXVCIsImt.........",

Request

Parámetro	Tipo	Long.	Descripción	Req.
action	Cadena	-	La intención del comercio. En este caso es "tokenize"	SI
card.pan	Cadena (N)	20	Número de la tarjeta del Tarjetahabiente	SI
card.expiry_date	Cadena (N)	4	Fecha de expiración de la tarjeta del Tarjetahabiente. Formato MMYY	SI
card.security_code	Cadena (N)	4	Código de Seguridad de la tarjeta del Tarjetahabiente	SI
card_holder.first_name	Cadena (AN)	50	Nombre del Tarjetahabiente	SI
card_holder.last_name	Cadena (AN)	50	Apellido del Tarjetahabiente	SI
card_holder.email_address	Cadena (AN)	60	Correo electrónico del Tarjetahabiente	SI
card_holder.identity_document_country	Cadena (AN)	2	País del documento de identidad del Tarjetahabiente en formato ISO	SI
card_holder.identity_document_type	Cadena (AN)	25	Nombre del tipo de documento de identidad del Tarjetahabiente. DNI, CE, PASSPORT	SI
card_holder.identity_document_identifier	Cadena (AN)	25	Número de identificación del documento de identidad del Tarjetahabiente	SI
transaction.meta.internal_operation_number	Cadena (N)	9	Número de operación interno del comercio	SI
transaction.meta.additional_fields.user_id	Cadena (AN)	30	Identificador del usuario interno al comercio	SI

JSON

{
   "action":"tokenize",
   "card":[
      {
         "pan":"4444444444444444",
         "expiry_date":"1219",
         "security_code":"123"
      }
   ],
   "card_holder":[
      {  
         "first_name":"Foo",
         "last_name":"Bar",
         "email_address":"foo.bar@email.com",
         "identity_document_country":"PER",
         "identity_document_type":"DNI",
         "identity_document_identifier":"12345678"
      }
   ],
   "transaction":{
      "meta":{
         "internal_operation_number":"000000001",
         "additional_fields":{
            "user_id":"foo-bar32"
         }
      }
   }
}

Response

Parámetro	Descripción
action	Proceso realizado, en este caso es "tokenize"
success	Resultado de la operación: True: se procesó exitosamente. False: no se procesó exitosamente.
token.id	Token
token.card.brand	Marca de la tarjeta. Valores posibles: Ripley Visa Mastercard American Express Diners
token.card.bin	Bin asociado a la tarjeta
token.card.last_pan	Últimos 4 números de la tarjeta
token.card.issuer	Emisor de la tarjeta. Valor sujeto a disponibilidad.
token.creation_date	Fecha de creación del Token
transaction.meta.commerce_id	Id del Comercio
transaction.meta.internal_operation_number	Número de operación interno del comercio
transaction.meta.status.code	Código asociado al estado de la operación
transaction.meta.status.message_ilgn.locale	Configuración regional que define el idioma y país.
transaction.meta.status.message_ilgn.value	Mensaje resultante del proceso.
transaction.meta.additional_fields.user_id	Identificador del usuario interno al comercio

JSON

{
    "action": "tokenize",
    "success": true,
    "transaction": {
        "meta": {
            "commerceId": "9011",
            "internal_operation_number": "000000001",
            "status": {
                "code": "00",
                "message_ilgn": [
                    {
                        "locale": "es_PE",
                        "value": "Token creado"
                    }
                ]
            },
            "additional_fields": { "user_id": "foo-bar32" }
        }
    },
    "token": [
        {
            "id": "c35a-1d3b-3w9x-0051",
            "card": {
                "bin": "485951",
                "last_pan": "0051",
                "brand": "Visa",
                "issuer": "BCP"
            },
            "creation_date": "1568399357390"
        }
    ]
}