Tokenizacion

PUT /{request_id}/card

nota

1️⃣ Para realizar esta operación, siempre debe realizarse en primer lugar la generación de enlace mediante la llamada API POST (root) /.

2️⃣⚠️ En segundo lugar, y antes de abrir / enviar el enlace generado en el paso anterior, deberemos realizar la acción de PUT.

3️⃣ Después del flujo invocado desde el navegador cuando se ha abierto el enlace y se ha atenticado la operación, ebe realizarse una confirmación con éxito de la operación en caso de tener type=capture, se deberá llamar a POST /{request_id}.

El esquema básico de las peticiones relacionadas con la tokenización es el siguiente:

• tokenization (object, required): Importe de la operación en decimales. 140 serán 1,4€.

  • card_to_token (string): Identificador del token que se utilizará para el almacenamiento de la tarjeta.
  • card_from_token (string): Identificador del token que se utilizará para realizar la venta.

• security (object): Opciones adicionales utilizadas junto con el parámetro card_from_token.

  • requested_exemptions (object): Lista de exenciones que se solicitan.
    • reason (string): Razón de la exención.
    • type (string): Tipo de exención.

Tokenización

Importe 0€

Si en la generación del enlace mediante la llamada POST (root) / el valor de amount es igual a 0, utilizaremos el campo definido anteriormente tokenization.card_from_token.

Ejemplo petición

{
  "key": "{{key}}",
  "resource": "{{resource}}",
  "nonce": "123123",
  "mode": "sha256",
  "payload": {
    "tokenization": {
      "card_to_token": "ABC1234"
    }
  }
}

Ejemplo respuesta

{
  "type": "resource.status",
  "code": "0",
  "detail": "Card data successfully updated.",
  "payload": {},
  "request_id": "67d9acbacf69e7770c584c8d",
  "uuid": "67d9acbacf69e7770c584c8d"
}

Importe superior a 0€

Si en la generación del enlace mediante la llamada POST (root) / el valor de amount es superior a 0, utilizaremos el campo definido anteriormente tokenization.card_from_token.

Ejemplo petición

{
  "key": "{{key}}",
  "resource": "{{resource}}",
  "nonce": "123123",
  "mode": "sha256",
  "payload": {
    "tokenization": {
      "card_to_token": "ABC1234"
    }
  }
}

Ejemplo respuesta

{
  "type": "resource.status",
  "code": "0",
  "detail": "Card data successfully updated.",
  "payload": {},
  "request_id": "67d9acbacf69e7770c584c8d",
  "uuid": "67d9acbacf69e7770c584c8d"
}

Venta con token (MIT)

En esta llamada utilizaremos el campo tokenization.card_to_token con el objeto security. Las MIT reason permitadas están recogidas en esta sección de la documentación.

Ejemplo petición

{
  "key": "{{key}}",
  "resource": "{{resource}}",
  "nonce": "12341344",
  "mode": "sha256",
  "payload": {
    "tokenization": {
      "card_from_token": "ABC1234"
    },
    "security": {
      "requested_exemptions": {
        "reason": "c",
        "type": "mit"
      }
    }
  }
}

Ejemplo respuesta

{
  "type": "resource.status",
  "code": "0",
  "detail": "Card data successfully updated.",
  "payload": {},
  "request_id": "67d9acbacf69e7770c584c8d",
  "uuid": "67d9acbacf69e7770c584c8d"
}