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

PROPRIEDADETIPOTAMANHOOBRIGATÓRIODESCRIÇÃO
transactionIdTexto150NãoIdentificador da transação do GATE2all.
referenceIdTexto100SimNúmero de identificação da loja.
amountNúmero16SimValor da transação sem pontuação. Os dois últimos dígitos são os centavos. (Ex: amount: 100 = R$ 1,00)
descriptionTexto300NãoDescrição da transação.
postBackUrlTextoNãoURL onde o GATE2all notificará eventuais status da transação para o lojista notificação
customer.nameTexto100SimNome do portador do cartão.
customer.documentTexto18NãoNúmero do CPF/CNPJ do portador do cartão.
card.typeNúmero1NãoDefault: 1 - Configura as opcões disponíveis. 1 Configura cartão de crédito. 2
card.softDescriptorTexto22NãoTexto a ser exibido na fatura do portador do cartão.SoftDescriptor
card.captureBooleanoSimtrue = 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.installmentsNúmero2SimNúmero de parcelas.
card.interestTypeNúmero1NãoDefault: 3 - Operações disponíveis:
3. Parcelado Loja
4. Parcelado Administrador
card.authenticateNúmero1NãoDefault: 3 - Opções disponíveis:
1. Autorizar só transações autenticadas
2. Autorizar transações autenticadas ou não autenticadas
3. Autorizar sem autenticação
card.providerNúmeroNãoNome do Fornecedor (Adquirente) pela qual a autorização vai ser
processada. Redes Adquirentes
card.providerVersionTexto11NãoVersão da Integração do Fornecedor
card.saveCardBooleanoNãoDefault: false - Configura salvar o cartão (tokenização).
card.recurrentBooleanoNãoDefault: false - Informa se a transação é recorrente.
cardInfo.numberTexto19SimNúmero do cartão.
cardInfo.expirationMonthNúmero2SimMês da validade do cartão. Formato MM
cardInfo.expirationYearNúmero4SimAno da validade do cartão. Formato YYYY
cardInfo.cvvNúmero4SimCódigo de segurança do cartão.
cardInfo.brandTexto20SimBandeira do cartão.
Bandeiras.
cardInfo.holderNameTexto25NãoNome 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

PROPRIEDADETIPOTAMANHODESCRIÇÃO
transactionIdTexto150Identificador da transação do GATE2all.
dtTransactionDataHora19Data e hora da transação.
card.providerTexto10Nome da instituição financeira.
card.providerVersionTexto11Versão da Integração do Fornecedor
card.providerMessageTexto100Mensagem da instituição.
card.providerCodeTexto100Código de resposta da instituição.
card.codAuthorizationTexto100Código de autorização da instituição.
card.authenticationECITexto100Indicador de autenticação da transação. Códigos ECI
card.nsuTexto-Número sequêncial único da adquirente. Disponível para:

Cielo 3.0
Rede Rest
statusNúmero2Status 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

A seguir...