Generate Network Token

POST/dpm/tsp/v1/tokenization/token

__Generate Network Token__ This endpoint requests a network token for a card directly from the card brand's Token Service Provider (TSP). A network token replaces the PAN with a brand-issued token you can use in place of the raw card number. **Usage Scenarios:** - Obtaining a network token to use instead of the raw card number in a payment. - Preparing a card for a network-tokenized transaction that also requires a cryptogram. **Notes:** - Call [Generate Cryptogram](#tag/network-token/post/dpm/tsp/v1/tokenization/crypt) with the returned `network_token_id` to obtain the cryptogram required for the payment. - The network token is issued by the card brand, not by Getnet's vault.

Body application/json

customer_idstring

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

emailstring

Buyer's email address.

card_brandstringrequired

Card brand of the PAN to tokenize with the card brand's Token Service Provider (TSP).

card_pan_sourcestringrequired

Source of the card data sent for tokenization.

card_panstringrequired

Card Number (PAN) to tokenize with the card brand's Token Service Provider (TSP).

security_codestringrequired

Security code. CVV or CVC.

expiration_monthstringrequired

Two-digit card expiration month.

expiration_yearstringrequired

Four-digit card expiration year.

Response

Network token generated successfully.

x_trace_idstring<uuid>

Trace identifier for the request. Use it when contacting Getnet support about this request.

network_token_idstring

Identifier of the network token issued by the card brand's Token Service Provider (TSP). Send it to Generate Cryptogram, and use it in the payment request's `card.number` field in place of the raw PAN.

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/token" \ -H "Content-Type: application/json" \ -d '{ "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "card_pan_source": "ON_FILE", "card_pan": "5204731600014784", "security_code": "681", "expiration_month": "12", "expiration_year": "2030" }'

const response = await fetch(`https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/token`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "card_pan_source": "ON_FILE", "card_pan": "5204731600014784", "security_code": "681", "expiration_month": "12", "expiration_year": "2030" }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/token", json={ "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "card_pan_source": "ON_FILE", "card_pan": "5204731600014784", "security_code": "681", "expiration_month": "12", "expiration_year": "2030" }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.pre.globalgetnet.com/dpm/tsp/v1/tokenization/token"); 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, '{ "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "card_pan_source": "ON_FILE", "card_pan": "5204731600014784", "security_code": "681", "expiration_month": "12", "expiration_year": "2030" }'); $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/token", strings.NewReader(`{ "customer_id": "088442880012", "email": "[email protected]", "card_brand": "visa", "card_pan_source": "ON_FILE", "card_pan": "5204731600014784", "security_code": "681", "expiration_month": "12", "expiration_year": "2030" }`)) 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/token")) .header("Content-Type", "application/json") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"customer_id\": \"088442880012\",\n \"email\": \"[email protected]\",\n \"card_brand\": \"visa\",\n \"card_pan_source\": \"ON_FILE\",\n \"card_pan\": \"5204731600014784\",\n \"security_code\": \"681\",\n \"expiration_month\": \"12\",\n \"expiration_year\": \"2030\"\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/token") 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 \"customer_id\": \"088442880012\",\n \"email\": \"[email protected]\",\n \"card_brand\": \"visa\",\n \"card_pan_source\": \"ON_FILE\",\n \"card_pan\": \"5204731600014784\",\n \"security_code\": \"681\",\n \"expiration_month\": \"12\",\n \"expiration_year\": \"2030\"\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." } ] }