Cancelamento parcial

Para realizar um cancelamento “estorno” parcial, deve-se observar as seguintes condições:

• Disponível apenas para as adquirentes Rede Rest e Cielo 3.0.
• Mesmo dia da transação - Resposta imediata (Cancelada/Negada).
• Próximos dias - Solicita o cancelamento no formato D+1.

Prazos para cancelamento parcial

REDE ADQUIRENTE	PRAZO PARA CANCELAMENTO
Rede Rest (Crédito)	Total/Parcial - 90 dias
Rede Rest (Débito)	Total/Parcial - 7 dias
Cielo 3.0 (Crédito)	Total/Parcial - 365 dias
Cielo 3.0 (Débito)	Total/Parcial - 365 dias

🚧

IMPORTANTE:

• No caso do cancelamento parcial, a transação ainda se mantém confirmada até estornar o valor total da transação.
• O postback só será enviado caso a transação for totalmente cancelada.

Requisição

📘

PUT

/v1/transactions/{{transactionId}}/void?amount=100

PROPRIEDADE	TIPO	TAMANHO	OBRIGATÓRIO	DESCRIÇÃO
transactionId	Texto	150	Sim	Identificador da transação do GATE2all.
amount	Número	16	Sim	Valor da transação a ser cancelado sem pontuação. Os dois últimos dígitos são os centavos. (Ex: amount: 100 = R$ 1,00)

JSON

{
  "transactionId": "62f5a0b2-c632-4e4e-bc51-3b6681a54a3c",
  "referenceId": "1488917347840",
  "amount": "200",
  "status": 9,
  "dtTransaction": "2020-12-07T17:09:07",
  "payment": {
    "card": {
      "type": 1,
      "interestType": 3,
      "installments": 1,
      "capture": false,
      "authenticate": 3,
      "provider": "CIELO",
      "providerVersion": "3.0",
      "authenticationECI": 7,
      "codAuthorization": "123456",
      "providerReference": "100699306900094D905A",
      "providerCode": "00",
      "providerMessage": "Transacao cancelada com sucesso",
      "saveCard": false,
      "cardInfo": {
        "number": "421847******1234",
        "brand": "VISA",
        "holderName": "HOLDER NAME"
      }
    }
  },
  "customer": {
  "name": "HOLDER NAME",
  "document": "23650403811"
  }
}

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/transactions/957221f5-d08b-4445-9896-52152f31b846/void?amount=100");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
con.setRequestProperty("content-type", "application/json");
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

Transação cancelada