Autorização

Para criar uma autorização é necessário enviar um POST para o seguinte recurso:

🚧
Para se recuperar eventuais problemas com TIME OUT nas requisições, recomendamos a consulta pelo número do pedido referenceId ou criando uma Intenção de Venda e informando o mesmo transactionId na requisição com os dados do cartão. Desta maneira é possível realizar uma consulta para verificar o status da transação.

REQUISIÇÃO

🚧
POST
/v1/transactions

PROPRIEDADE	TIPO	TAMANHO	OBRIGATÓRIO	DESCRIÇÃO
transactionId	Texto	150	Não	Identificador da transação do GATE2all.
referenceId	Texto	100	Sim	Número de identificação da loja.
amount	Número	16	Sim	Valor da transação sem pontuação. Os dois últimos dígitos são os centavos. (Ex: amount: 100 = R$ 1,00)
description	Texto	300	Não	Descrição da transação.
postBackUrl	Texto	—	Não	URL onde o GATE2all notificará eventuais status da transação para o lojista notificação
customer.name	Texto	100	Sim	Nome do portador do cartão.
customer.document	Texto	18	Não	Número do CPF/CNPJ do portador do cartão.
card.type	Número	1	Não	Default: 1 - Configura as opcões disponíveis. 1 Configura cartão de crédito. 2
card.softDescriptor	Texto	22	Não	Texto a ser exibido na fatura do portador do cartão.SoftDescriptor
card.capture	Booleano	—	Sim	true = Autoriza e confirma a transação .false *= Autorização, mas não confirma a transação, necessitando realizar a confirmação (Captura) noutra requisição.
card.installments	Número	2	Sim	Número de parcelas.
card.interestType	Número	1	Não	Default: 3* - Operações disponíveis: Parcelado Loja Parcelado Administrador
card.authenticate	Número	1	Não	Default: 3* - Opções disponíveis: Autorizar só transações autenticadas Autorizar transações autenticadas ou não autenticadas Autorizar sem autenticação
card.provider	Número	—	Não	Nome do Fornecedor (Adquirente) pela qual a autorização vai ser processada. Redes Adquirentes
card.providerVersion	Texto	11	Não	Versão da Integração do Fornecedor
card.saveCard	Booleano	—	Não	Default: false* - Configura salvar o cartão (tokenização).
card.recurrent	Booleano	—	Não	Default: false* - Informa se a transação é recorrente.
cardInfo.number	Texto	19	Sim	Número do cartão.
cardInfo.expirationMonth	Número	2	Sim	Mês da validade do cartão. Formato MM
cardInfo.expirationYear	Número	4	Sim	Ano da validade do cartão. Formato YYYY
cardInfo.cvv	Número	4	Sim	Código de segurança do cartão.
cardInfo.brand	Texto	20	Sim	Bandeira do cartão. Bandeiras.
cardInfo.holderName	Texto	25	Não	Nome do Portador impresso no cartão, só aceita caracteres

{
   "referenceId": "19893211234",
   "amount": "1000",
   "description": "Mouse sem fio",
   "customer": {
      "name": "Comprador Teste",
      "document": "12345678909"
   },
   "payment": {
       "card": {
          "type": 1,
          "capture": false,
          "installments": 1,
          "interestType": 3,
          "authenticate": 3,
          "softDescriptor": "Pagamento GATE2all",
          "saveCard": false,
          "recurrent": false,
          "provider": "Cielo",
          "providerVersion": "3.0",
          "cardInfo": {
              "number": "4539708473330561",
              "expirationMonth": "04",
              "expirationYear": "2026",
              "cvv": "234",
              "brand": "VISA",
              "holderName": "HOLDER NAME"
            }
        }
   }
}

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/transactions");
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\": \"123456\","
        + "\"amount\": \"1000\","
        + "\"description\": \"Venda Teste\","
        + "\"postBackUrl\": \"http://url-notificacao\","
        + "\"customer\": {"
        + "    \"name\": \"COMPRADOR TESTE\","
        + "     \"document\": \"23650403811\""
        + "},"
        + " \"payment\": {"
        + "    \"card\": {"
        + "        \"type\": 1,"
        + "        \"capture\": false,"
        + "        \"installments\": 1,"
        + "        \"interestType\": 3,"
        + "        \"authenticate\": 3,"
        + "        \"saveCard\": false,"
        + "        \"recurrent\": false,"
        + "        \"softDescriptor\": \"Gate2All\","
        + "        \"cardInfo\": {"
        + "           \"number\": \"4539708473330561\","
        + "           \"expirationMonth\": \"04\","
        + "           \"expirationYear\": \"2026\","
        + "           \"cvv\": \"234\","
        + "           \"brand\": \"VISA\","
        + "           \"holderName\": \"COMPRADOR TESTE\""
        + "        }"
        + "      }"
        + "   }"
        + "}";

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
transactionId	Texto	150	Identificador da transação do GATE2all.
dtTransaction	DataHora	19	Data e hora da transação.
card.provider	Texto	10	Nome da instituição financeira.
card.providerVersion	Texto	11	Versão da Integração do Fornecedor
card.providerMessage	Texto	100	Mensagem da instituição.
card.providerCode	Texto	100	Código de resposta da instituição.
card.codAuthorization	Texto	100	Código de autorização da instituição.
card.authenticationECI	Texto	100	Indicador de autenticação da transação. Códigos ECI
card.nsu	Texto		Número sequêncial único da adquirente. Disponível para: Cielo 3.0 Rede Rest
status	Número	2	Status da transação retornado pelo GATE2all catálogo.

RESPOSTA

{
  "transactionId": "92d50ba4-5d93-4ee5-90e8-9884b250310a",
  "referenceId": "1463697571584",
  "description": "TV LG 42",
  "amount": "1000",
  "status": 5,
  "dtTransaction": "2020-12-05T12:04:20",
  "payment": {
    "card": {
      "type": 1,
      "softDescriptor": "Gate2All",
      "interestType": 3,
      "installments": 1,
      "capture": false,
      "authenticate": 3,
      "saveCard": false,
      "recurrent": false,
      "provider": "CIELO",
      "providerVersion": "3.0",
      "authenticationECI": 7,
      "codAuthorization": "123456",
      "providerReference": "1006993069000834928A",
      "providerCode": "00",
      "providerMessage": "Transacao autorizada com sucesso",
      "nsu": "1234",
      "cardInfo": {
        "number": "453970******0561",
        "expirationMonth": "04",
        "expirationYear": "2026",
        "cvv": "***",
        "brand": "VISA",
        "holderName": "HOLDER NAME"
      }
    }
  },
  "customer": {
    "name": "HOLDER NAME",
    "document": "12345678909"
  }
}

Transação autorizada e não capturada

Falha

🚧

🚧POST

🚧
POST