Le token est une référence à des informations stockées dans la plateforme. Comme ces informations peuvent être sensibles ou non structurées, nous vous offrons un moyen simple de stocker ces informations dans notre plateforme en créant un token avec une référence. Pour utiliser les informations lors du paiement, par exemple avec un charge flow ou une transaction, vous pouvez utiliser ce token et n’avez pas besoin de redemander les informations au client.
Le principal cas d’utilisation des tokens est le stockage d’informations critiques de carte de crédit, car celles-ci ne peuvent être stockées que dans des environnements certifiés PCI. Mais il existe diverses autres situations où l’utilisation de tokens peut être utile. Vous pouvez créer un token pour chaque connecteur qui prend en charge la tokenisation.
Un client a déjà commandé en ligne dans votre boutique en utilisant le prélèvement SEPA comme mode de paiement. Vous pouvez stocker ces informations avec un token pour un achat ultérieur. Imaginez qu’il appelle après 4 mois et souhaite commander à nouveau certains produits. Vous pouvez alors créer une transaction sans présence du client en utilisant la référence du token, sans redemander les informations.
Toutes les opérations sur les tokens peuvent être effectuées via le Token Service. Les tokens créés peuvent être consultés dans le back office sous Space > Paiement > Token
Tous les modes de paiement et toutes les configurations de connecteur ne prennent pas en charge la fonctionnalité de token. Si vous souhaitez vérifier si le mode de paiement la prend en charge, vous trouverez plus d’informations dans notre référence des modes de paiement. Vous pouvez le faire en ouvrant votre processeur dans notre liste des connecteurs et en cliquant sur le connecteur. Cela ouvrira un écran qui affiche les fonctionnalités de la page de paiement.
Si le paiement récurrent est sélectionné, un token est créé après le premier paiement.
Pour créer un token, vous utilisez le Token Service
avec l’opération create.
Vous pouvez définir si le token doit être activé pour le paiement en un clic. Lorsqu’un token est activé pour les paiements en un clic, l’acheteur pourra sélectionner le token dans l’iFrame ou sur la page de paiement afin de payer avec le token. L’utilisation du token réduira le nombre d’étapes que l’acheteur doit franchir. L’acheteur est reconnu par l’ID client de la transaction. Cela signifie que les tokens précédemment utilisés seront présentés à l’acheteur lorsque nous disposons d’un token qui a le même ID client que la transaction. De plus, le mode de paiement doit être configuré pour autoriser les paiements en un clic.
La requête ci-dessous crée un nouveau token pour le client de test. La référence de paiement sera désormais automatiquement stockée dans la Token Version.
Requête
{
"customerEmailAddress": "test@email.com",
"enabledForOneClickPayment": true,
"externalId": "1",
"tokenReference": "test-customer"
}Réponse
La requête ci-dessous crée une transaction en utilisant le token créé.
{
"createdOn": "2017-12-07T14:53:20.285Z",
"customerEmailAddress": "test@email.com",
"enabledForOneClickPayment": true,
"externalId": "1",
"id": 1572,
"linkedSpaceId": 396,
"state": "ACTIVE",
"timeZone": "Europe/Zurich",
"tokenReference": "test-customer",
"version": 0
}Vous pouvez utiliser le token pour créer une transaction. Pour cela, il suffit de fournir l'`id` du token dans la Transaction Create Operation. Le token peut alors être utilisé des manières suivantes :
Vous pouvez afficher le token en utilisant l’autorisation iframe, ce qui permettra à votre client de choisir le token pour traiter la transaction.
Vous pouvez utiliser le token via l’autorisation par la page de paiement. Cela débitera directement le
client et l’enverra vers la successURL ou la failedURL selon que le token a pu être débité ou non.
Vous pouvez appliquer un Charge Flow à la transaction qui utilise un token. Cela entraînera un débit direct, ou les niveaux du Charge Flow seront déclenchés si le token ne peut pas être débité.
Requête
La requête ci-dessous crée une transaction en utilisant le token créé.
{
"billingAddress": {
"city": "Zurich",
"country": "Switzerland",
"familyName": "Test",
"givenName": "Customer",
"street": "Teststreet 4"
},
"currency": "chf",
"lineItems": [{
"amountIncludingTax": "15",
"name": "Test",
"quantity": "1",
"type": "PRODUCT",
"uniqueId": "12354"
}],
"token": 1572
}Le paiement en un clic augmente votre taux de conversion, car les informations de paiement de votre client peuvent être stockées en toute sécurité pour des achats ultérieurs, de sorte que la prochaine fois votre client pourra payer directement avec le token. Cette fonctionnalité est disponible dans l’intégration Iframe ou Page de paiement pour tous les modes de paiement qui prennent en charge les tokens (voir ci-dessus).
Pour que le paiement en un clic fonctionne, vous devez vous assurer que les conditions suivantes sont remplies :
Le mode de paiement prend en charge la tokenisation (consultez la liste des connecteurs)
Vous fournissez la propriété customerId dans la Transaction Create Operation
Le mode de paiement en un clic doit être activé dans la configuration du mode de paiement (voir ci-dessous)
Si ces conditions sont remplies, l’application initialisera automatiquement un token et stockera les informations de paiement en toute sécurité auprès de votre processeur. Cela fonctionne avec la intégration de la page de paiement et avec la intégration iframe.
Veillez à activer le mode de paiement en un clic pour chaque mode de paiement pour lequel vous souhaitez activer le paiement en un clic. Vous avez le choix entre 3 options :
Désactiver (par défaut) : dans ce cas, aucun token ne sera créé
Forcer le stockage : dans ce cas, l’application essaiera toujours de créer un token.
Autoriser le stockage : dans ce cas, le client sera invité à indiquer s’il souhaite stocker le token. Il a également la possibilité de gérer les tokens stockés.
Dès qu’un ID client est fourni, que le mode un clic est activé et qu’un token est enregistré, un token sera proposé à l’acheteur pour payer, ou il aura la possibilité d’utiliser un autre mode de paiement.
Si vous souhaitez débiter directement le token, vous pouvez fournir le tokenId directement dans la Transaction Create Operation ; dans ce cas, le token sera débité directement.
