Tokenization API

Qué crosses el wire

• Dónde it sits

  Entre tarjeta entry y cada later charge. El token es created once, desde un hosted surface, y después de ese su systems reference it instead de una tarjeta: para un repeat purchase, un suscripción, un depósito y balance, o un charge taken en un different channel.

• Qué usted send

  Para creation, nothing sensitive — el hosted surface supplies el credential y su server receives el reference. Para reuse y lifecycle operations, el token itself plus el cliente record it belongs a. El reference documents el exact fields.

• Qué comes back

  UN token reference y enough non-sensitive detail a show un cliente que tarjeta they son using: brand y last four digits, no el number. Anything ese would let usted reconstruct el credential es deliberately absent.

Cuando a use it

• Anything charged more than once

  Subscriptions, instalments, memberships, depósitos followed por un balance: each one needs un credential ese survives el first transacción sin su systems holding una tarjeta.

• One-click y returning clientes

  UN stored token turns un repeat purchase into un confirmation rather than una tarjeta entry, y it works whether el cliente returns en línea o calls en.

• Keeping PCI scope narrow

  Storing tokens instead de tarjeta numbers keeps raw credentials out de su environment, que narrows qué has a ser assessed rather than adding controls around holding them.

Cómo a implement Tokenización API

Qué fails, y cómo usted find out

• Storing anything beside el token

  Keeping la tarjeta number as well, even briefly, even encrypted, puts el credential back en su environment y undoes el reason para tokenizing en all.

• UN token nobody puede attribute

  UN token stored sin el cliente record it belongs a becomes unusable el moment someone asks que tarjeta es en file. Write both en el same transacción.

• Tokens ese son never retired

  UN cliente quién deletes una tarjeta expects it gone. UN vault ese solo ever grows es un compliance problem y un Soporte problem, y el deletion path es el one integrations most often skip building.

• Assuming un token outlives un reissue en its own

  El token reference survives, but el credential behind it has a ser refreshed. Sin Servicio de actualización de tarjetas enrolment, un reissued tarjeta fails en el next charge con un decline nobody caused.

Sandbox versus production

• Tokens do no cross environments

  UN token created en entorno de pruebas (sandbox) has no production counterpart y cannot ser charged con production keys. Cada credencial almacenada has a ser created again en el environment it will ser billed en.

• Lifecycle operations son safe a rehearse

  Creating, replacing y deleting tokens en entorno de pruebas (sandbox) es el practical way a prove su deletion path works, que es difficult a test convincingly against real cliente records.

• Updater behaviour es simulated

  Entorno de pruebas (sandbox) puede show un refreshed credential flowing mediante a un stored token, but real coverage depends en el network y emisor participating. Build el handling en entorno de pruebas (sandbox); expect variation en production.