Quick start

Este guia mostra o processo de efetivação de um recarga, utilizando a interface HTML do Pagamento Online.

O que você precisará

Cadastro ativo no ambiente de homologação do Pagamento Online (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://{{url}}/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:

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

Para usar este exemplo, não esquecer de definir a variável {{url}} com o valor<br/> <URLPOSTMAN/>

curl
--request POST "https://{{url}}/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://{{url}}/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 Pagamento Online na etapa de criação da transação.

Recebendo um aviso de status

Assim que o status da transação mudar, o Pagamento Online 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&lt;String, String&gt; request) {
        Log.info("status = " + request.get("status"));
        // ...
        return new ResponseEntity<>("OK", HttpStatus.OK);
    }

}

Saiba mais sobre esse serviço.