Tarjetas guardadas: flujo de checkout de un clic para compradores recurrentes

Therius te permite ofrecer a los compradores recurrentes un checkout de un clic depositando su tarjeta en el vault durante el primer pago y presentándola en las visitas posteriores. El flujo de tarjeta guardada está totalmente limitado a la sesión — una sesión nunca puede acceder a las tarjetas de otro comprador. El depósito en el vault y la recuperación están ligados al customerId que suministras al crear la sesión del SDK en tu servidor.

Cómo funciona

Primera visita — deposita la tarjeta en el vault

Pasa customerId a POST /sdk/session cuando el comprador llega al checkout. Cuando completa el pago, incluye card.nonceData.tokenize: true y shopper.id en tu solicitud de cobro del lado del servidor. Therius deposita la tarjeta en el vault bajo ese ID de comprador.

{
  "card": {
    "nonceData": {
      "nonce": "<nonce>",
      "tokenize": true
    }
  },
  "shopper": {
    "id": "customer-42"
  }
}

La respuesta del cobro incluye un token que puedes almacenar contra el comprador en tu propia base de datos como referencia.

Visita de regreso — recupera las tarjetas guardadas

Pasa el mismo customerId a POST /sdk/session. El Widget de checkout muestra automáticamente las tarjetas guardadas del comprador. Para recuperarlas de forma programática, llama a sdk.getSavedMethods():

// El JWT de la sesión limita esta llamada al propio comprador de la sesión
// — no se necesita ningún ID de comprador suministrado por el cliente
const savedMethods = await sdk.getSavedMethods()

Cada método guardado se devuelve como:

{
  "brand": "visa",
  "last4": "4242",
  "expiryMonth": "12",
  "expiryYear": "2027",
  "token": "tok_..."
}

Nunca se devuelve un PAN sin procesar al navegador.

Cobra la tarjeta guardada

Pasa el token a sdk.authorizeToken() con el monto del pago. No se requiere reingreso de la tarjeta.

const result = await sdk.authorizeToken(token, {
  amount: { currency: 'USD', value: 4999, exponent: 2 },
})

if (result.actionRequired) {
  const finalResult = await sdk.handleAction(result.actionRequired)
}

Alcance del token y seguridad

Las tarjetas guardadas se devuelven como { brand, last4, expiryMonth, expiryYear, token } — nunca un PAN utilizable. Tu UI puede mostrar los datos de tarjeta de forma segura.
Las tarjetas están limitadas al comercio — un token creado bajo una cuenta de comercio no se puede usar en otra.
La recuperación de métodos del vault se resuelve puramente a partir del JWT de la sesión — el navegador no puede enumerar las tarjetas de un comprador diferente suministrando un ID diferente. Therius aplica el alcance del lado del servidor.

Cuando hay un customerId establecido en la sesión, el Widget de checkout maneja la visualización y selección de tarjetas guardadas automáticamente. Pasa onSavedMethodSelected para recibir el token cuando un comprador recurrente elige una tarjeta:

const checkout = sdk.checkout({
  vaultConsentEnabled: true,
  onSavedMethodSelected: async (token) => {
    const result = await sdk.authorizeToken(token, {
      amount: { currency: 'USD', value: 4999, exponent: 2 },
    })
  },
})

El endpoint GET /sdk/vaulted-methods que respalda la recuperación de tarjetas guardadas también es accesible directamente si prefieres llamarlo desde tu propio código de front-end. El JWT de la sesión en el encabezado Authorization limita los resultados al comprador de la sesión automáticamente.

Descripción general

Recolección de tarjeta

Billeteras y más

Tarjetas guardadas: flujo de checkout de un clic para compradores recurrentes

Cómo funciona

Alcance del token y seguridad

Usar tarjetas guardadas con el Widget de checkout

​Cómo funciona

​Alcance del token y seguridad

​Usar tarjetas guardadas con el Widget de checkout

Cómo funciona

Alcance del token y seguridad

Usar tarjetas guardadas con el Widget de checkout