Skip to main content

Documentación

Aprovisionamiento de monederos digitales

Puedes añadir una tarjeta emitida a un monedero digital mediante un proceso denominado aprovisionamiento. Una tarjeta se aprovisiona cuando el número de cuenta principal (PAN) de la tarjeta emitida se tokeniza y se almacena como un token digital. Luego, el token digital se agrega a la billetera digital para almacenar la información de la tarjeta. Se pueden asignar varios tokens digitales a la misma tarjeta.

Puedes aprovisionar tarjetas emitidas por Rapyd y añadirlas a un monedero digital como Apple Pay y Google Pay.

Hay dos tipos principales de aprovisionamiento: aprovisionamiento manual y aprovisionamiento en la aplicación.

Aprovisionamiento manual

Aprovisionamiento manual se refiere al proceso en el que los detalles de la tarjeta del cliente se agregan manualmente a una billetera digital móvil local almacenada en un dispositivo móvil. Esta acción normalmente la realiza el cliente.

Aprovisionamiento en la aplicación

Aprovisionamiento en la aplicación se refiere al proceso en el que los detalles de la tarjeta del cliente se añaden al monedero digital mediante una aplicación creada por el emisor. El aprovisionamiento manual y en la aplicación es similar, pero requiere diferentes niveles de verificación para transmitir y almacenar la información de identificación personal (

Puedes usar la API Rapyd para aprovisionar las tarjetas emitidas a un monedero digital.

Administración de tokens

Puedes gestionar los tokens de tus tarjetas mediante la API Rapyd. Puedes crear fichas, inhabilitarlas y cambiar el estado de las fichas. El siguiente diagrama de flujo describe el ciclo de vida de los tokens y demuestra la relación entre los distintos estados de los tokens

wallet-provisioning-flow-1.png

Los estados de los tokens se resumen en la siguiente tabla:

Descripción de los estados de los tokens

Estado del token

Descripción

Creado

La creación del token está en curso.

Activo

El token está activo y se puede usar para realizar pagos.

Pendiente

El token está pendiente de activación. Es relevante para los tokens que requieren una verificación de color naranja.

Suspendido

El token se suspende temporalmente y se puede volver a activar.

Desactivado

El token se ha desactivado o eliminado.

Verificación de la solicitud de token

Cuando se solicita un token de tarjeta, es posible que el emisor exija ciertos niveles de verificación. En la siguiente tabla se describen los distintos niveles de verificación y sus requisitos

Descripción de los niveles de verificación

Nivel de verificación

Tipo de aprovisionamiento

Descripción

Verificación ecológica

En la aplicación

No se requiere ninguna verificación adicional para la solicitud del token

Verificación amarilla

Manual/integrado en la aplicación

Ingresa tu contraseña de un solo uso (OTP) para completar la verificación

Verificación naranja

Manual/integrado en la aplicación

Ingresa tu contraseña de un solo uso y habla por teléfono con tu emisor. Ponte en contacto con tu emisor para obtener una verificación adicional

Caso de uso

Como comerciante asociado con Rapyd, te gustaría proporcionar las tarjetas emitidas a tu aplicación local. Te integras con Google Pay o Apple Pay para ampliar la funcionalidad de tu aplicación móvil. Usas la API Rapyd para habilitar el aprovisionamiento de tarjetas. Los clientes pueden añadir sus tarjetas a sus monederos de Google Pay o Apple Pay mediante tu aplicación, lo que mejora su experiencia

Flujo de trabajo de aprovisionamiento manual
wallet-provisioning-flow-2.png

  1. El cliente agrega manualmente los detalles de su tarjeta a una billetera digital.

  2. Rapyd procesa la información del token y envía una verificación OTP.

  3. El token es creado por Card Network.

  4. El token se activa en los servidores de monederos digitales.

  5. El cliente completa la verificación (ya sea con OTP o con la verificación de OTP y del emisor).

Flujo de trabajo de aprovisionamiento en la aplicación
wallet-provisioning-flow-3.png

  1. Añades los detalles de la tarjeta de cliente a través de tu aplicación.

  2. La solicitud de aprovisionamiento se envía a Rapyd.

  3. El cliente completa la verificación (OTP y verificación del emisor).

  4. Obtienes una carga útil de respuesta con el token. Reenvías el token a la aplicación móvil de monedero electrónico para crear el token digital

Certificación PCI

Solo clientes con PCI-DSS La certificación puede gestionar la información de identificación personal de las tarjetas. Este método está disponible para los comerciantes que hayan firmado un acuerdo especial con Rapyd

Cómo funciona el aprovisionamiento desde la aplicación a una billetera digital
Requisitos de aprovisionamiento en la aplicación

Antes de poder habilitar el aprovisionamiento integrado en la aplicación mediante la API de Rapyd, también debes integrarlo con las plataformas para desarrolladores de Apple Pay o Google Pay. Cada servicio de monedero digital tiene una serie de requisitos que debes cumplir para integrar las funciones de Google Pay o Apple Pay en

Tras la integración, la API de Rapyd te permite usar el aprovisionamiento integrado en la aplicación para las tarjetas emitidas por Rapyd.

Para obtener información más específica sobre cómo realizar la integración con Google Pay o Apple Pay, consulta la Documentación para desarrolladores de Apple y el documentación para desarrolladores de Google.

Cumple los siguientes requisitos para completar la integración:

  1. Intégralo con el emisor de la tarjeta.

    Nota: Rapyd, como emisor de tu tarjeta, interactuará con los servidores de monederos digitales para transferir los datos de carga cifrados y tokenizar la información de la tarjeta.

  2. Regístrate como desarrollador con tu proveedor de monedero digital (Google Pay o Apple Pay).

  3. Muestra el botón Apple Pay o Google Pay en tu aplicación.

  4. Inicie la solicitud de aprovisionamiento.

    Nota: Utilizará la API Rapyd para iniciar la solicitud de aprovisionamiento.

Aprovisionamiento en la aplicación

Puedes proporcionar una tarjeta a una billetera digital. Usa los parámetros de ruta aplicables para la solicitud:

Descripción de los parámetros de ruta

Parámetro de ruta

Descripción

google_pay

La billetera digital Google Pay utilizada para el aprovisionamiento de tarjetas.

apple_pay

La billetera digital Apple Pay utilizada para el aprovisionamiento de tarjetas.

Nota: El google_pay el parámetro path se usa en la solicitud de ejemplo que aparece a continuación.

Solicitud de aprovisionamiento en la aplicación

    • Solicitud

      • // Request URL: POST https://sandboxapi.rapyd.net/v1/issuing/cards/:card_id/card_tokens/google_pay 

{
  "client_wallet_provider": "40010075001", 
  "client_wallet_account_id": "4CEBB556CBB31B94", 
  "client_device_id": "je-UCHgwQ97Icy-wrI_f48PU" 
}
Respuesta de aprovisionamiento en la aplicación

    • Respuesta

      • { 
    "status": { 
      "error_code": "", 
      "status": "SUCCESS", 
      "message": "", 
      "response_code": "", 
      "operation_id": "11b95b4b-7783-4062-b32f-d607c3f5bad1" 
  }, 

  "data": { 
    "PaymentInstrumentData": "", 
    "UserAddress": { 
    } 
  } 
}
Cómo funciona la gestión de fichas para tarjetas
Lista de fichas de cartas disponibles

Puedes enumerar las fichas de tarjeta existentes adjuntas a una tarjeta específica. Usa los siguientes parámetros:

Descripción de los parámetros de ruta

Parámetro de ruta

Descripción

id_tarjeta

El identificador de la tarjeta que comienza por tarjeta_.

Solicitud de lista de fichas de tarjeta disponibles

    • Solicitud

      • // Request URL: GET https://sandboxapi.rapyd.net/v1/issuing/cards/:card_id/card_tokens 

// Message body absent
Lista de fichas de cartas disponibles: respuesta

    • Respuesta

      • { 
    "status": { 
      "error_code": "", 
      "status": "SUCCESS", 
      "message": "", 
      "response_code": "", 
      "operation_id": "386fcaf5-d50c-43b0-9d12-ead3d3c0ef11" 
  }, 
  "data": [ 
    { 
      "HashedTokenId": "p37Y9skr7289mUWKrCSss+L47yjDGkEcD5BOuYXRMV0=", 
      "TokenIdLast4": "L011", 
      "DeviceId": "TestDeviceId987654321011", 
      "DeviceManufacturer": "LG", 
      "DeviceLanguageCode": "is", 
      "DeviceName": "G8 Feitur V", 
      "CreationTime": "2019-04-01T00:00:00", 
      "TokenRequestorId": "40010030273", 
      "TokenRequestorName": "Apple Pay", 
      "Status": "INACTIVE" 
    }, 
    { 
      "HashedTokenId": "WcOpDxmzhWN9SCp2nTf0mtIN+6DKHBr9/uNak/nTXg4=", 
      "TokenIdLast4": "L012", 
      "DeviceId": "TestDeviceId987654321012", 
      "DeviceManufacturer": "LG", 
      "DeviceLanguageCode": "is", 
      "DeviceName": "G8 Feitur V", 
      "CreationTime": "2019-04-01T00:00:00", 
      "TokenRequestorId": "40010075001", 
      "TokenRequestorName": "Google Pay", 
      "Status": "SUSPENDED" 
    }, 
    { 
      "HashedTokenId": "rUIJkyoz4J8EvxsZuedskKjA+fOYluu0GRZXARd2ytE=", 
      "TokenIdLast4": "L013", 
      "DeviceId": "TestDeviceId987654321013", 
      "DeviceManufacturer": "LG", 
      "DeviceLanguageCode": "is", 
      "DeviceName": "G8 Feitur V", 
      "CreationTime": "2019-04-01T00:00:00", 
      "TokenRequestorId": "40010051602", 
      "TokenRequestorName": "Amazon", 
      "Status": "ACTIVE" 
    }, 
    { 
      "HashedTokenId": "9Q5xEzliI1Iyx0FU4gWKML2YUnGEUuCGVAExDHjKsts=", 
      "TokenIdLast4": "L014", 
      "DeviceId": "TestDeviceId987654321014", 
      "DeviceManufacturer": "LG", 
      "DeviceLanguageCode": "is", 
      "DeviceName": "G8 Feitur V", 
      "CreationTime": "2019-04-01T00:00:00", 
      "TokenRequestorId": "40010075839", 
      "TokenRequestorName": "Netflix", 
      "Status": "DEACTIVATED" 
    } 
  ] 
}
Cambiar el estado del token

Puedes cambiar el estado del token de tu tarjeta a uno de los siguientes estados:

  • Activo

  • Pendiente

  • Suspendido

  • Desactivado

Utilice los siguientes parámetros de ruta y campos obligatorios en la solicitud:

Descripción de los parámetros de ruta

Parámetro de ruta

Descripción

activar

El token se activará.

reactivar

El token se reactivará.

suspender

El token se suspenderá.

Nota: El suspender el parámetro de ruta se utilizará en la solicitud de ejemplo que aparece a continuación

Utilice los siguientes campos obligatorios en la solicitud:

Descripción de los campos obligatorios

Campo

Descripción

identificador_de_token hashed_id

Un identificador único para el token.

ejecutado_por

El usuario que envía el cambio de estado del token. Longitud de caracteres: 50.

motivo de la solicitud

El motivo del cambio de estado del token. Longitud de caracteres: 5 - 254.

Solicitud de cambio de estado del token

    • Solicitud

      • // Request URL: POST https://sandboxapi.rapyd.net/v1/issuing/cards/:card_id/card_tokens/suspend 

{ 
  "hashed_token_id": "dB/xDjJzxcwruDMTMLmdjs7UZ7JW97CHKwmMgg9hk14=", 
  "performed_by": "user name", 
  "request_reason": "some reason" 
}
Respuesta de cambio de estado del token

    • Respuesta

      • { 
  "status": { 
    "error_code": "", 
    "status": "SUCCESS", 
    "message": "", 
    "response_code": "", 
    "operation_id": "60e0671a-cae9-4568-bb8c-8db58677dc46" 
  } 
}
En esta sección:

Regulations developed for the payment card industry for data security and protection against fraud.