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
ouxml
;
Objeto JSON request
mínimo:
{
"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.
@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);
}
}