Quick start

Este guia mostra o processo de efetivação de um recarga, utilizando a interface HTML do e-SiTef.

O que você precisará

• Cadastro ativo no ambiente de homologação do e-SiTef (obtido com nossa equipe de suporte)
• Uma ferramenta capaz de realizar chamadas HTTP, como Postman, REST Client ou cURL
• Uma aplicação capaz de receber chamadas POST HTTPS

Criando a transação de recarga

Tipo de requisição: POST

URL: https://esitef-homologacao.softwareexpress.com.br/e-sitef/init/json.se

Headers:

• Content-Type: application/x-www-form-urlencoded

Parâmetros do POST:

• Key/chave: request;
• Value/valor: objeto JSON;
• [tipo_de_retorno]: json ou xml;

Objeto JSON request mínimo:

JSON

cURL

{
    "recharge_included":"true",
    "merchant_id":"xxxxxxxxxx"
}

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/init/json.se"
--header "Content-Type: application/x-www-form-urlencoded"
-d 'request=%7B%22merchant_id%22%3A%22xxxxxxxxxx%22%2C%22recharge_included%22%3A%22true%22%7D'
--verbose

Resposta:

{
  "responseCode" : 0,
  "description" : "OK. Transaction successful.",
  "url" : "https://esitef-homologacao.softwareexpress.com.br/e-sitef/do.se?input['nit']=12345678asdfghjk12345678asdfghjk12345678asdfghjk12345678asdfghjk",
  "nsuesitef" : "123451234512345",
  "nit" : "12345678asdfghjk12345678asdfghjk12345678asdfghjk12345678asdfghjk"
}

Saiba mais sobre esse serviço.

Redirecionando o usuário

A loja deve então redirecionar o usuário para a URL retornada pelo e-SiTef na etapa de criação da transação.

Recebendo um aviso de status

Assim que o status da transação mudar, o e-SiTef notificará a loja com um POST em sua URL de status cadastrada.

Java + Spring Framework

@RestController
public class MyStatusController {

    @PostMapping(value = "/mystatus",
        consumes = "application/x-www-form-urlencoded; charset=utf-8")
    public ResponseEntity<String> myStatus(@RequestParam Map<String, String> request) {
        Log.info("status = " + request.get("status"));
        // ...
        return new ResponseEntity<>("OK", HttpStatus.OK);
    }

}

Saiba mais sobre esse serviço.