Consult Token

The function of this service is to receive a token as a get parameter in the URL to return the associated non-sensitive data.

Environment	EndPoint	Method
Development	https://api.dev.alignet.io/tokens	GET
Production	https://api.alignet.io/tokens	GET

The token is received as a parameter in the URL:

Example: https://api.dev.alignet.io/tokens/1c9b-c1f8-4f16-4444

Request Headers

Header	Value	Required
ALG-API-VERSION	API version to be used. Available values: 1618440906	Yes
Authorization	Bearer <Access_Token>	Yes
ALG-INTERNAL_OPERATION_NUMBER	Number to identify the request	No

JSON

"ALG-API-VERSION":"1618440906",
"Authorization":"Bearer JhbGciOiJSUzI1NsInR5cCI6IkpXVCIsImt………",
"ALG-INTERNAL_OPERATION_NUMBER":"0000001425",

Response

Parameter	Description
action	Process performed, in this case it is "detokenize".
success	Result of the operation: True: processed successfully. False: not processed successfully.
card.brand	Card brand.
card.bin	Bin associated to the card.
card.last_pan	Last 4 card numbers.
card.issuer	Card issuer. Value subject to availability.
card.product	Card product type (Credit, Debit, Platinum, etc). Value subject to availability.
card_holder.first_name	Cardholder Name.
card_holder.last_name	Cardholder's Last Name.
card_holder.email_address	Cardholder's e-mail address.
card_holder.identity_document_country	Cardholder's ID Country.
card_holder.identity_document_type	Cardholder's ID Type.
card_holder.identity_document_identifier	Cardholder's ID Number.
transaction.meta.commerce_id	Merchant ID.
transaction.meta.internal_operation_number	Internal merchant operation number
transaction.meta.status.code	Code associated with the operation status
transaction.meta.status.message_ilgn.locale	Regional settings defining language and country.
transaction.meta.status.message_ilgn.value	Message resulting from the process.
transaction.meta.additional_fields.user_id	Internal user identifier to the trade
token.life_cycle.state	State
token.life_cycle.timestamp	Date and Time (of current status)

JSON

{
    "action": "detokenize",
    "success": "true",
    "token": {
        "life_cycle": {
            "state": "active",
            "timestamp": "1568400325167"
        }
    },
    "card": {
        "brand": "Visa",
        "bin": "485951",
        "last_pan": "0051",
        "issuer": null,
        "product": "credit"
    },
    "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": {
            "commerce_id": "9011",
            "internal_operation_number": "001",
            "status": {
                "code": "00",
                "message_ilgn": [
                    {
                        "locale": "es_PE",
                        "value": "Token encontrado"
                    }
                ]
            }
        }
    }
}

Continue to Delete Token ➡️