Quick start

Esta guía muestra el proceso de realizar un pago, utilizando la interfaz HTML de Portal Carat.

Que necesitarás#

  • Registro activo en el entorno de aprobación de pagos en línea (obtenido de nuestro equipo de soporte)
  • Una herramienta capaz de realizar llamadas HTTP, como Postman, REST Client o cURL
  • Una aplicación capaz de recibir llamadas POST HTTPS

Creando la transacción de pago#

Tipo de solicitud : POST

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

Headers:

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

Parámetros POST:

Parámetros do POST:

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

Objeto JSON request mínimo:

{
"merchant_id": "xxxxxxxxxx",
"amount": "1800"
}
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%22amount%22%3A%221800%22%7D'
--verbose

Respuesta:

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

[Obtenga más información sobre este servicio.] (pagamento-html-begin.md)

Redirigir al usuario#

Luego, la tienda debe redirigir al usuario a la URL devuelta por PayPal en el paso de creación de la transacción.

Recibir un aviso de estado#

Tan pronto como cambie el estado de la transacción, Portal Carat notificará a la tienda con un POST en su URL de estado registrado.

@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);
}
}

A continuación se muestra un ejemplo de una solicitud que debe realizar Portal Carat en el dominio registrado por la tienda:

curl -X POST \
https://dominiocadastrado.com.br \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'cache-control: no-cache' \
-d 'rede=xxxx&tipoFinanciamento=4&binCartao=xxxxxx&nsuesitef=191107123456780&tid=authorizerTransactionId12345678901234567&parcelas=2&nsu=merchantNsu&autorizadora=1&nit=nitWith64charsLike1234567890123456789012345678901234567890123457&pedido=orderId1234&tipoPagamento=C&finalCartao=2345&status=NEG'

[Obtenga más información sobre este servicio].(pagamento-html-avisostatus.md)