Activación e Inactivación del Token de la Tarjeta

Detalles de la llamada#

Recurso: /v1/cards/{card.token}
Método HTTP: PUT
Formato de la solicitud: JSON
Formato de la respuesta: JSON
Parámetros de encabezado:

Parámetro	Descripción	Formato	Obligatorio
`merchant_id`	Código de la tienda en Carat. Los códigos de producción y certificación serán diferentes.	< 15 AN	SÍ
`merchant_key`	Clave de autenticación de la tienda en Carat. Las claves de producción y certificación serán diferentes.	< 80 AN	SÍ
`token`	Token obtenido en el servicio de creación de token Más información.. Si no se envía `Authorization` este campo se vuelve obligatorio	= 66 AN	COND.
`Authorization`	Se debe enviar la firma de autenticación de la tienda en el formato `Bearer {firma}`. Ejemplo: `Bearer JHVGytfdgauygdauiw78264284527852897hagdg`. Si no se envía `token` este campo será obligatorio	< 2000 AN	COND.
`Content-Type`	Debe enviarse con el valor `application/json`.	= 15 AN	SÍ

Flujo#

Ejemplos#

A continuación, se presentan algunos ejemplos de llamada al servicio de activación e inactivación del token de la tarjeta utilizando la herramienta cURL.

Activación del token de la tarjeta con autenticación utilizando token#

Solicitud:

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

curl
    --request PUT "https://{{url}}/e-sitef/api/v1/cards/{card.token}"
    --header "Content-Type: application/json"
    --header "merchant_id: xxxxxxxxxxx"
    --header "merchant_key: xxxxxxxxxxx"
    --header 'token: XXXXX'
    --data-binary
    {
       "card":{
          "status":"ATV"
       }
    }
    --verbose

Activación del token de la tarjeta con autenticación utilizando firma#

curl
    --request PUT "https://{{url}}/e-sitef/api/v1/cards/{card.token}"
    --header "Content-Type: application/json"
    --header "merchant_id: xxxxxxxxxxx"
    --header "merchant_key: xxxxxxxxxxx"
    --header 'Authorization: Bearer XXXXX'
    --data-binary
    {
       "card":{
          "status":"ATV"
       }
    }
    --verbose

Respuesta:

{
   "code":"0",
   "message":"OK. Transacción exitosa.",
   "card":{
      "token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
      "suffix":"5555",
      "bin": "544444",
      "status": "ATV"
   },
   "store":{
      "status":"CON",
      "nsua":"18051600000560A",
      "nita":"xxxxxxxxxxxxxxxxxxx",
      "customer_id":"11122211122",
      "authorizer_id":"2"
   }
}

Códigos de respuesta

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

Inactivación del token de la tarjeta con autenticación utilizando token#