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
referenceIdou criando uma Intenção de Venda e informando o mesmotransactionIdna 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 | 
 | 
| card.installments | Número | 2 | Sim | Número de parcelas. | 
| card.interestType | Número | 1 | Não | 
 
 | 
| card.authenticate | Número | 1 | Não | 
 
 | 
| card.provider | Número | — | Não | Nome do Fornecedor (Adquirente) pela qual a autorização  vai ser | 
| card.providerVersion | Texto | 11 | Não | Versão da Integração do Fornecedor | 
| card.saveCard | Booleano | — | Não | 
 | 
| card.recurrent | Booleano | — | Não | 
 | 
| 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. | 
| 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: 
 | |
| 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
FalhaUpdated 9 months ago
