Integración de la tokenización de red (PSP)

La tokenización de red es una obligación reglamentaria impuesta por la red de la tarjeta: Mastercard, Visa. Estos servicios Web están reservados a los PSP (Prestador de servicio de pago). La tokenización de red corresponde a la creación de un token de red por la red de la tarjeta (Mastercard, Visa).

Lista

Descripción Servicio Web
Crear un token de red ante la red PCI/NetworkToken/Create
Recuperar cierta información sobre un token de red PCI/NetworkToken/Checkout
Cancelar un token de red PCI/NetworkToken/Delete
Recuperar toda la información sobre un token de red PCI/NetworkToken/Refresh

Requisitos previos

A día de hoy, este servicio solo está disponible:

La tokenización de red no funciona con la red CB.

Creación del token de red

Recomendaciones

Pruebe el servicio Web PCI/NetworkToken/Create desde nuestro playground: PCI/NetworkToken/Create.

Solicitud

Ejemplo de solicitud
Campos obligatorios:
/rest/V4.0/api/kb/authentication.html https://api.payzen.eu/api-payment/V4/PCI/NetworkToken/Create 
    {
      "customer": {
        "email": "sample@example.com"
      },
      "paymentForm": {
        "network": "VISA",
        "pan": "4970100000000055",
        "expiryMonth": 11,
        "expiryYear": 24,
        "securityCode": "123"
      }
    }

Encuentre la totalidad y la descripción de los campos en nuestro playground : PCI/NetworkToken/Create.

Respuesta

Ejemplo de respuesta 

      {
        "webService": "PCI/NetworkToken/Create",
        "version": "V4",
        "applicationVersion": "6.10.0",
        "status": "SUCCESS",
        "answer": {
            "networkTokenRequestorId": 11214880129,
            "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=",
            "networkTokenData": {
                "lastFour": "0064",
                "expiryMonth": "11",
                "expiryYear": "2024",
                "_type": "V4/NetworkToken/NetworkTokenData"
            },
            "_type": "V4/NetworkTokenCreateResponse"
        },
        (...)
        "_type": "V4/WebService/Response"
    }

En este ejemplo, la referencia del token de red, campo networkTokenReference corresponde a : NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=.

Encuentre la totalidad y la descripción de los campos en nuestro playground : NetworkTokenCreate.

Pago con un token de red

Pago por token
Este modo facilita el pago para el comprador. No necesita volver a introducir el número de la tarjeta bancaria para pagar.

Solicitud

Ejemplo de solicitud

Utilice el servicio Web PCI/NetworkToken/Checkout para obtener el networkTokenCryptogram.

Transmita este dato obligatorio durante la petición de autorización.

Campos obligatorios:

  • Red : "VISA".
  • Referencia del token de red : "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=".
  • Monto: 1200.
  • Moneda : "EUR".
  • Referencia del pedido : "OrderId 123".
/rest/V4.0/api/kb/authentication.html https://api.payzen.eu/api-payment/V4/PCI/NetworkToken/Checkout 
    {
      "network": "VISA",
      "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=",
      "amount": 1200,
      "currency": "EUR",
      "orderId": "OrderId 123"
  }

Respuesta

Ejemplo de respuesta 
      {
        "webService": "PCI/NetworkToken/Checkout",
        "version": "V4",
        "applicationVersion": "6.10.0",
        "status": "SUCCESS",
        "answer": {
            "networkTokenRequestorId": 70784110579,
            "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ==",
            "networkToken": "4990001500000031",
            "networkTokenCryptogram": "e881de864f0c4c7e8aee19316a==",
            "networkTokenData": {
                "lastFour": "0031",
                "expiryMonth": "11",
                "expiryYear": "2023",
                "_type": "V4/NetworkToken/NetworkTokenData"
            },
            "cardData": {
                "lastFour": "0055",
                "expiryMonth": "11",
                "expiryYear": "2023",
                "_type": "V4/NetworkToken/NetworkTokenData"
            },
            "_type": "V4/NetworkTokenGetResponse"
        },
        (...)
        "_type": "V4/WebService/Response"
    }

Durante la petición de autorización, transmita los siguientes datos:

  • campo networkTokenRequestorId. Ej : "70784110579".
  • campo networkToken. Ej : "4990001500000031".
  • campo networkTokenCryptogram. Ej : "e881de864f0c4c7e8aee19316a=="

con los datos sobre la expiración del token de red :

  • campo networkTokenData.expiryMonth. Ej : "11".
  • campo networkTokenData.expiryYear. Ej : "2023".

Encuentre la totalidad y la descripción de los campos en nuestro playground : answer/NetworkTokenCheckout.


Pago 0 clic
Este modo permite pagar sin visualización del formulario de pago y sin autenticación (llamada de servidor a servidor).

Sin autenticación, las transacciones no están protegidas contra los riesgos de fraude y más específicamente en caso de disputa del titular de la tarjeta.

Durante la primera cuota, utilice el servicio Web PCI/NetworkToken/Checkout para obtener el campo networkToken.

Guárdelo para transmitirlo durante las próximas cuotas.

Durante la petición de autorización, transmita los siguientes datos:

con los datos sobre la expiración del token de red :

A diferencia del pago por token (interacción con el comprador), el campo networkTokenCryptogram no es obligatorio.

Gestión del token de red

Actualizar un token de red

Solicitud

Ejemplo de solicitud
Utilice el servicio Web PCI/NetworkToken/Refresh para actualizar los datos del token de red.

Campos obligatorios:

  • Red : "VISA".
  • Referencia del token de red : "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ="
/rest/V4.0/api/kb/authentication.html https://api.payzen.eu/api-payment/V4/PCI/NetworkToken/Refresh 
    {
      "network": "VISA",
      "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ="
  }

Respuesta

Ejemplo de respuesta 
    {
      "webService": "PCI/NetworkToken/Refresh",
      "version": "V4",
      "applicationVersion": "6.10.0",
      "status": "SUCCESS",
      "answer": {
          "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ=",
          "networkTokenStatus": "ACTIVE",
          "networkTokenData": null,
          "cardData": {
              "lastFour": "0055",
              "expiryMonth": "11",
              "expiryYear": "2023",
              "_type": "V4/NetworkToken/NetworkTokenData"
          },
          "_type": "V4/NetworkTokenRefreshResponse"
      },
      "ticket": "350aa99f60f14daf868182a84e0ed6ed",
      "serverDate": "2023-11-29T15:46:52+00:00",
      (...)
      "_type": "V4/WebService/Response"
  }

Encuentre la totalidad y la descripción de los campos en nuestro playground : NetworkTokenRefresh.

Análisis de la respuesta NetworkTokenRefresh

Valor de los campos Descripción Acción
El campo networkTokenStatus tiene por valor SUSPENDED. Tarjeta suspendida Contacte al titular de la tarjeta para que reactive o cambie su medio de pago.
El campo networkTokenStatus tiene por valor DELETED. Cuenta cerrada Contacte al titular de la tarjeta para que introduzca un nuevo medio de pago.
Los campos cardData.lastFour, cardData.expiryMonth y cardData.expiryYear cambian de valor. Renovación tarjeta Actualice la información de la tarjeta y del token de red, mediante el servicio Web PCI/NetworkToken/Checkout antes de las próximas cuotas.

Procedimiento para actualizar los datos del token de red

  1. Contacte a la pasarela de pago para solicitar la activación de la notificación ITN (= Instant Token Notification).
  2. Al recibir esta notificación, utilice el servicio Web PCI/NetworkToken/Refresh para verificar si los datos de la tarjeta han cambiado. Por ejemplo, analice el campo cardData.lastFour( 4 últimos dígitos del número de tarjeta).
  3. En caso de cambio, utilice el servicio Web PCI/NetworkToken/Checkout para actualizar los datos de la tarjeta y del token de red antes de las próximas cuotas.
Cancelar un token de red
Utilice el servicio Web PCI/NetworkToken/Delete.

Solicitud

Ejemplo de solicitud

Campos obligatorios:

  • Red : "VISA".
  • Referencia del token de red : "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ="
/rest/V4.0/api/kb/authentication.html https://api.payzen.eu/api-payment/V4/PCI/NetworkToken/Delete 
    {
      "network": "VISA",
      "networkTokenReference": "NDk3MDEwMDAjMDA1NSMxMTIwMjQjNDk5MDAwMTUwMDAwMDA2NCMxMTIwMjQ="
  }

Respuesta

Ejemplo de respuesta 
      {
        "webService": "PCI/NetworkToken/Delete",
        "version": "V4",
        "applicationVersion": "6.10.0",
        "status": "SUCCESS",
        "answer": {
            "status": "SUCCESS",
            "_type": "V4/NetworkTokenDeleteResponse"
        },
        "ticket": "9a6ca56e47d44eddb3a40efb00013f47",
        (...)
        "_type": "V4/WebService/Response"
    }