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 mesmotransactionId
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: 3. Parcelado Loja 4. Parcelado Administrador |
card.authenticate | Número | 1 | Não | Default: 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.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
Updated about 1 year ago
A seguir...