Tokenização Direta

Para realizar uma tokenização direta é necessário enviar um POST para o seguinte recurso:

REQUISIÇÃO

🚧

POST

/v1/tokenization

PROPRIEDADE	TIPO	TAMANHO	DESCRIÇÃO
referenceId	Texto	100	Sim
postBackUrl	Texto	—	URL onde o GATE2all notificará os dados da tokenização.
cardInfo.number	Texto	20	Número do cartão truncado.
cardInfo.expirationMonth	Número	2	Mês da validade do cartão. Formato MM
cardInfo.expirationYear	Número	4	Ano da validade do cartão. Formato YYYY
cardInfo.brand	Texto	20	Bandeira do cartão. [Bandeiras]
cardInfo.holderName	Texto	25	Nome do Portador impresso no cartão, só aceita caracteres

JSON

{
    "referenceId": "19893211234",
    "postBackUrl": "http://url-notificacao",
    "cardInfo": {
      "number": "4024007148992927",
      "expirationMonth": "04",
      "expirationYear": "2026",
      "brand": "VISA",
      "holderName": "Comprador"
    }
}

JAVA

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Scanner;

URL obj = new URL("https://api.gate2all.com.br/v1/tokenization");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();

con.setRequestMethod("POST");
con.setRequestProperty("content-type", "application/json");
con.setRequestProperty("authenticationApi", "demo");
con.setRequestProperty("authenticationKey", "demo");

String body = "{"
    + "\"referenceId\": \"123456789\","
    + "\"postBackUrl\": \"http://url-notificacao\","
    + "    \"cardInfo\": {"
    + "        \"number\": \"4556326359707410\","
    + "        \"expirationMonth\": \"04\","
    + "        \"expirationYear\": \"2026\","
    + "        \"brand\": \"VISA\","
    + "        \"holderName\": \"Comprador\""
    + "      }"
    + "}";

con.setDoOutput(true);
DataOutputStream dos = new DataOutputStream(con.getOutputStream());
dos.writeBytes(body);
dos.flush();
dos.close();

Scanner scanner = new Scanner(new BufferedReader(new InputStreamReader(con.getInputStream())));
String response = scanner.nextLine();
scanner.close();

System.out.println(response);

RESPOSTA

PROPRIEDADE	TIPO	TAMANHO	DESCRIÇÃO
tokenizationId	Texto	36	Identificador da tokenização do GATE2all.
provider	Texto	100	Nome da Rede Adquirente.
saveCard	Booleano	Sim	Configura salvar o cartão (tokenização).
cardInfo.token	Texto	100	Token do cartão.

Tokenização gerada

JSON

{
  "tokenizationId": "f414a0b8-f5de-4245-aae5-733f10c1963d",
  "referenceId": "19893211234",
  "postBackUrl": "http://url-notificacao",
  "provider": "CIELO",
  "saveCard": true,
  "cardInfo": {
    "number": "402400******2927",
    "expirationMonth": "04",
    "expirationYear": "2026",
    "brand": "VISA",
    "token": "be4cbeb1-abb2-4913-8165-f86962143fa021",
    "holderName": "Comprador"
  }
}

JAVA

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Scanner;

URL obj = new URL("https://api.gate2all.com.br/v1/tokenization");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();

con.setRequestMethod("POST");
con.setRequestProperty("content-type", "application/json");
con.setRequestProperty("authenticationApi", "demo");
con.setRequestProperty("authenticationKey", "demo");

String body = "{"
    + "\"referenceId\": \"123456789\","
    + "\"postBackUrl\": \"http://url-notificacao\","
    + "    \"cardInfo\": {"
    + "        \"number\": \"4556326359707410\","
    + "        \"expirationMonth\": \"04\","
    + "        \"expirationYear\": \"2026\","
    + "        \"brand\": \"VISA\","
    + "        \"holderName\": \"Comprador\""
    + "      }"
    + "}";

con.setDoOutput(true);
DataOutputStream dos = new DataOutputStream(con.getOutputStream());
dos.writeBytes(body);
dos.flush();
dos.close();

Scanner scanner = new Scanner(new BufferedReader(new InputStreamReader(con.getInputStream())));
String response = scanner.nextLine();
scanner.close();

System.out.println(response);

Para realizar uma consulta de token é necessário enviar um GET para o seguinte recurso:

REQUISIÇÃO

👍

GET

/v1/tokenization/{{token}}

PROPRIEDADE	TIPO	TAMANHO	OBRIGATÓRIO	DESCRIÇÃO
token	Texto	150	Sim	Token NTK retornado na tokenização do cartão.

Consulta Token

JAVA

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Scanner;

URL obj = new URL("https://api.gate2all.com.br/v1/tokenization/be4cbeb1-abb2-4913-8165-f86962143fa021");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
con.setRequestProperty("content-type", "application/json");
con.setRequestProperty("user-agent", "NomeDaAutomacao/1.0");
con.setRequestProperty("authenticationApi", "demo");
con.setRequestProperty("authenticationKey", "demo");

Scanner scanner = new Scanner(new BufferedReader(new InputStreamReader(con.getInputStream())));
String response = scanner.nextLine();
scanner.close();

System.out.println(response);

RESPOSTA

PROPRIEDADE	TIPO	TAMANHO	DESCRIÇÃO
tokenizationId	Texto	36	Identificador da tokenização do GATE2all.
referenceId	Texto	100	Número de identificação da loja.
postBackUrl	Texto	—	URL onde o GATE2all notificará eventuais status da trancação para o lojista.
provider	Texto	100	Nome da Rede Adquirente.
saveCard	Booleano	Default true
cardInfo.number	Texto	20	Número do cartão truncado.
cardInfo.expirationMonth	Número	2	Mês da validade do cartão. Formato MM
cardInfo.expirationYear	Número	4	Ano da validade do cartão. Formato YYYY
cardInfo.brand	Texto	20	Bandeira do cartão.Bandeiras.
cardInfo.token	Texto	100	Token do cartão.
cardInfo.holderName	Texto	25	Nome do Portador impresso no cartão, só aceita caracteres

Retorno Consulta Token

JSON

{
  "tokenizationId": "7c6785d9-4922-4b0d-986e-9bb5e624c613",
  "referenceId": "1496173577825",
  "postBackUrl": "",
  "saveCard": true,
  "provider": "CIELO",
  "cardInfo": {
    "number": "402400******2927",
    "expirationMonth": "04",
    "expirationYear": "2026",
    "brand": "VISA",
    "token": "be4cbeb1-abb2-4913-8165-f86962143fa021",
    "holderName": "Comprador"
  }
}