Protocolo de la API

Protocolo y formato de mensaje

La API del Issuer Gateway es una API de estilo RPC. Cada método se asigna a un endpoint HTTP. Las solicitudes y respuestas usan cargas JSON.

A 200 OK El estado HTTP significa que la solicitud tuvo éxito.

Archivos Swagger

La API de Tokenization Service (Issuer Gateway API) está disponible como una definición Swagger (OpenAPI). Úsela para generar código cliente y validar solicitudes.

Descargar las definiciones OpenAPI:

• Entrante (backend del emisor → Tokenization Service)

• Saliente (Tokenization Service → backend del emisor)

Descripción general de la API

La API tiene endpoints entrantes y salientes:

• Saliente: Tokenization Service llama al backend del emisor.

• Entrante: el backend del emisor llama a Tokenization Service.

Saliente

SOLICITUD DE THALES AL EMISOR	DESCRIPCIÓN
NotifyVirtualCardChange	Esta solicitud es utilizada por Tokenization Service para notificar al backend del emisor sobre cualquier cambio en el estado de un token.
RequestCardDigitalization	Esta solicitud es utilizada por Tokenization Service para solicitar el consentimiento del backend del emisor para digitalizar la tarjeta de financiación.
CheckCardEligibility	Esta solicitud es utilizada por Tokenization Service para verificar si una tarjeta de financiación es elegible para la tokenización.
SendOTP	Esta solicitud es utilizada por Tokenization Service para enviar el OTP generado por la red de pago para la autenticación de elevación de privilegios (step-up). El backend del emisor debe enviar el OTP al usuario final mediante el método seleccionado.

Entrante

SOLICITUD DEL EMISOR A THALES	DESCRIPCIÓN
UpdateCard	Esta solicitud es utilizada por el backend del emisor para actualizar la información de la tarjeta, como: - PAN de la tarjeta de financiación y fecha de vencimiento (para renovación de la tarjeta) - Perfil de la tarjeta
UpdateCardState	Esta solicitud es utilizada por el backend del emisor para solicitar una actualización del estado de una tarjeta o token.
GetCardInfo	Esta solicitud es utilizada por el backend del emisor para recuperar la información del token emitido para una determinada tarjeta de financiación.
SendMessage	Solo Apple Pay. Esta solicitud es utilizada por el backend del emisor para enviar un mensaje de texto al usuario final en la aplicación Wallet.

Consideraciones de desarrollo

La API del Issuer Gateway mantiene estado para la mayoría de las operaciones. Su backend del emisor debe gestionar el estado de la sesión para manejar correctamente las solicitudes de Tokenization Service.

Inscripción

• Use varias llamadas a la API.

• Almacene la información requerida devuelta en cada paso.

• Use el x-correlation-id encabezado para correlacionar todas las solicitudes de la misma sesión.

LCM (gestión del ciclo de vida)

• Confíe en Tokenization Service para gestionar los escenarios de finalización y no finalización.

• Use el x-correlation-id encabezado para correlacionar todas las solicitudes de la misma sesión.