Generate Cryptogram

POST/dpm/tsp/v1/tokenization/crypt

__Generate Cryptogram__ This endpoint requests a cryptogram from the card brand's Token Service Provider (TSP) for a previously generated network token. Send the cryptogram in the `tokenization` object of the payment request. **Usage Scenarios:** - Obtaining the cryptogram required to authorize a payment made with a network token. **Notes:** - The `network_token_id` sent here must come from [Generate Network Token](#tag/network-token/post/dpm/tsp/v1/tokenization/token). - The token and cryptogram must come from the same TSP; Getnet cannot process a token and cryptogram issued by different providers.

Body application/json

network_token_idstringrequired

Value of the `network_token_id` returned by Generate Network Token.

transaction_typestringrequired

Indicates whether the transaction was initiated by the customer or by the merchant.

cryptogram_typestringrequired

Brand-specific cryptogram type requested from the TSP.

amountintegerrequired

Transaction amount, in cents, that the cryptogram is generated for.

customer_idstring

Buyer identifier. Application-defined information that consumes the Digital Platform API.

emailstring

Buyer's email address.

card_brandstringrequired

Card brand of the network token the cryptogram is generated for.

currency_codestringrequired

ISO 4217 numeric currency code for the transaction the cryptogram is generated for.

Response

Cryptogram generated successfully.

cryptogramstring

Cryptogram value generated by the TSP for the given network token and transaction. Send it in the payment request's `tokenization.cryptogram` field.

token_pan_cardstring

Network token PAN issued by the card brand's Token Service Provider (TSP). Use it in the payment request's `card.number` field in place of the raw PAN.

token_expiration_monthstring

Two-digit expiration month of the network token.

token_expiration_yearstring

Four-digit expiration year of the network token.

token_statusstring

Status of the network token.

Invalid request.

messagestring

Detailed error message.

namestring

Name of the module or service that returned the error.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Network tokenization error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Short description of the error.

description_detailstring

Specific reason the network token or cryptogram request failed, naming the invalid field or the token service provider's denial reason.

Invalid Authentication.

messagestring

Detailed error message.

namestring

Name of the module or service that returned the error.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Network tokenization error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Short description of the error.

description_detailstring

Specific reason the network token or cryptogram request failed, naming the invalid field or the token service provider's denial reason.

Unprocessable Entity

messagestring

Detailed error message.

namestring

Name of the module or service that returned the error.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Network tokenization error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Short description of the error.

description_detailstring

Specific reason the network token or cryptogram request failed, naming the invalid field or the token service provider's denial reason.

Internal server or service error.

messagestring

Detailed error message.

namestring

Name of the module or service that returned the error.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Network tokenization error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Short description of the error.

description_detailstring

Specific reason the network token or cryptogram request failed, naming the invalid field or the token service provider's denial reason.

curl -X POST "https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/crypt" \ -H "Content-Type: application/json" \ -d '{ "network_token_id": "e2f8d96768a84a02b82f7ba1d079b05c", "transaction_type": "CIT", "cryptogram_type": "VISA_TAVV", "amount": 9000, "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "currency_code": "968" }'

const response = await fetch(`https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/crypt`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ "network_token_id": "e2f8d96768a84a02b82f7ba1d079b05c", "transaction_type": "CIT", "cryptogram_type": "VISA_TAVV", "amount": 9000, "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "currency_code": "968" }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/crypt", json={ "network_token_id": "e2f8d96768a84a02b82f7ba1d079b05c", "transaction_type": "CIT", "cryptogram_type": "VISA_TAVV", "amount": 9000, "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "currency_code": "968" }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/crypt"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "network_token_id": "e2f8d96768a84a02b82f7ba1d079b05c", "transaction_type": "CIT", "cryptogram_type": "VISA_TAVV", "amount": 9000, "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "currency_code": "968" }'); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" "strings" ) func main() { req, _ := http.NewRequest("POST", "https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/crypt", strings.NewReader(`{ "network_token_id": "e2f8d96768a84a02b82f7ba1d079b05c", "transaction_type": "CIT", "cryptogram_type": "VISA_TAVV", "amount": 9000, "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "currency_code": "968" }`)) req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/crypt")) .header("Content-Type", "application/json") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"network_token_id\": \"e2f8d96768a84a02b82f7ba1d079b05c\",\n \"transaction_type\": \"CIT\",\n \"cryptogram_type\": \"VISA_TAVV\",\n \"amount\": 9000,\n \"customer_id\": \"088442880012\",\n \"email\": \"[email protected]\",\n \"card_brand\": \"visa\",\n \"currency_code\": \"968\"\n}")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/crypt") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request.body = "{\n \"network_token_id\": \"e2f8d96768a84a02b82f7ba1d079b05c\",\n \"transaction_type\": \"CIT\",\n \"cryptogram_type\": \"VISA_TAVV\",\n \"amount\": 9000,\n \"customer_id\": \"088442880012\",\n \"email\": \"[email protected]\",\n \"card_brand\": \"visa\",\n \"currency_code\": \"968\"\n}" response = http.request(request) puts response.body

{ "message": "Unprocessable Entity", "name": "GatewayParametersServiceError", "status_code": 422, "details": [ { "status": "DENIED", "error_code": "TOKENIZATION-422", "description": "Unprocessable Entity", "description_detail": "The card is not enrolled for network tokenization with this card brand's token service provider." } ] }