Tokenize a Transaction
To create a permanent token from a transactional token, you can utilize the following method in your application or interface. This method takes in a transactional token as input and generates a permanent token, which is securely stored in the Firstoken vault.
POST /V1/requests/:transactionID/tokenize
curl -X POST https://api.firstoken.co/transactions/requests/{{transaction_id}}/tokenize'
-H 'x-api-key: YOUR_API_KEY'
-H "Content-Type: application/json"tags: [string]
Required: true
The tags value is a string array of tags that wants to be associated with the transaction ID. For example invoice id, member id, etc.
scheme: integer
Required: true
Scheme value represents what format do you want to use for the tokenization process in the request.
status_code: int
The status code represents the result of the operation that was performed. For successful transactions a code 200 is always returned for the others another code is returned.
status: string
The status is a string result that only has two possible values. "Success" or "Fail".
desc: string
The desc value represents a short description about the status code.
data: {object}
The value of the data represents a set of JSON objects of tokenized credit cards. Each object has the following attributes:
tokens: [{object}]
card: string
The truncated value of the credit card number.
token: string
The permanent token value.
tags: [string]
The tags associated to the credit card.
scheme: int
The scheme used to tokenize the card.
status: int
Value 1 if it was possible to tokenize the credit card. Value 0 if it was not possible to tokenize the credit card.
created_by: string
The username that tokenized the card.
createdAt: ISODate
The ISODate of the tokenization.
Last updated
Was this helpful?