Servicio de creación de la transacción

Detalles de la llamada#

  • Recurso: /v1/store
  • Método HTTP: POST
  • Formato de la solicitud: JSON
  • Formato da la respuesta: JSON
  • Headers:
    • Content-Type: application/json
    • merchant_id: {su código de tienda}
    • merchant_key: {su clave de tienda}

El consumo de este servicio es obligatorio en el flujo de almacenamiento de JavaScript.

Parámetros de solicitud#

Deben enviarse los siguientes parámetros de solicitud:

ParámetroDescripciónFormatoRequerido
merchant_usnNúmero secuencial único para cada pedido, creado por la tienda. < 12 NSI
customer_idIdentificación de comprador para almacenamiento de tarjetas. Esta identificación debe ser única para cada usuario de la tienda. Pero cuidado, esta garantía de unicidad es responsabilidad exclusiva de la tienda, Portal Carat no realizará ninguna validación. < 20 ANSI

Parámetros de respuesta#

En la siguiente tabla se encuentra la descripción de los parámetros de respuesta:

ParámetroDescripciónFormato
codeCódigo de respuesta de Portal Carat. Cualquier código que no sea "0" (cero) significa falla. [Más información.] (códigos-de-api.md#códigos-de-respuesta) < 4 N
messageMensaje de respuesta de Portal Carat. < 500 AN
store
statusEstado de la transacción de almacenamiento de Pagos Online. [Más información.] (codigos-da-api.md#status-de-armazenamento)= 3 AN
nsuaNúmero secuencial único de la transacción de almacenamiento de Portal Carat.= 15 AN
nitaNúmero de identificación cifrado de la transacción de almacenamiento devuelta a la tienda por Portal Carat. < 65 AN
merchant_usnNúmero secuencial único enviado por la tienda. < 12 N
customer_idIdentificación de comprador para almacenamiento de tarjetas. < 20 AN
store_tokenToken asociado con la tienda JavaScript.= 66 AN

Ejemplo#

Solicitud:

Para usar este ejemplo, no olvide definir la variable {{url}} con el valor
esitef-homologacao.softwareexpress.com.br

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/store"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
"merchant_usn":"16013439434",
"customer_id":"11122211122"
}
--verbose

Respuesta:

{
"code":"0",
"message":"OK. Transaction successful.",
"store":{
"status":"CON",
"nsua":"12345600000560A",
"merchant_usn":"16013439434",
"customer_id":"11122211122",
"nita":"Z123adsfrh342r72498r34920ur23r328r2038r023rh0h203rh032r082380rf43",
"store_token": "123456789012345678901234567890123456789012345678901234567890123456"
}
}

Códigos de respuesta

Ver referencia en Códigos API - Códigos de respuesta