Skip to main content
Skip table of contents

Crear Token de Tarjeta

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

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

Copy

JSON

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

CODE
{
   "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"
         }
      }
   }
}

Copy

JSON

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

CODE
{
    "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"
        }
    ]
}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.