Tokénisation
Comment ça marche
La tokénisation fait référence à un ensemble d’endpoints API qui vous permettent de traiter les paiements de manière sécurisée sans ouvrir l’interface de paiement ni impliquer l’utilisateur. Caractéristiques principales :
- obtenir la liste des comptes de paiement enregistrés ;
- effectuer un paiement avec un compte de paiement enregistré ;
- supprimer un compte de paiement.
Les comptes de paiement sont enregistrés dans les cas suivants :
- Lorsque le paiement est effectué via l’interface de Pay Station. Si l’utilisateur accepte d’enregistrer ses données de paiement lors de la saisie, un nouveau compte enregistré est ajouté.
- Lorsque la Pay Station est ouverte en mode d’enregistrement de comptes de paiement. Pour activer ce mode, passez le paramètre
settings.ui.mode
lors de l’obtention du jeton.
Lorsque le compte de paiement est enregistré, un ID lui est attribué. Spécifiez cet ID dans la requête API pour effectuer un paiement sans intervention de l’utilisateur et sans ouvrir l’interface de paiement.
Modes de paiement prenant en charge la tokénisation :
- Cartes bancaires
- Amazon Pay
- Skrill Digital Wallet
- PayPal
- Alipay
- GCash
- DANA
- Rabbit LINE pay
- Touch ’n Go
- Boost
- Toss
- PayPay
- Paysafecard
- TrueMoney Wallet
- Mercado Pago
- Docomo
- SoftBank
- au Easy payment
- Y!mobile
- Maya
- Klarna
Comment configurer
Pour utiliser la tokénisation, implémentez les endpoints permettant d’utiliser les comptes de paiement enregistrés.
Payer avec un compte de paiement enregistré
Pour effectuer un paiement avec un compte de paiement enregistré sans ouvrir l’interface de paiement, implémentez la logique de paiement dans votre application comme suit :- Obtenez la liste des comptes de paiement enregistrés de l’utilisateur.
- Prélevez le paiement via l’un des comptes de paiement de l’utilisateur.
- Traitez les données reçues dans le webhook Payment et attribuez les biens virtuels achetés à l’utilisateur.
Afficher les comptes de paiement enregistrés de votre côté
À l’aide de la requête Lire les comptes enregistrés, vous pouvez obtenir les données masquées des comptes de paiement enregistrés de l’utilisateur sur votre page de commande.
Pour stocker les données masquées des comptes de paiement enregistrés de votre côté et les tenir à jour :
- Configurez le webhook Ajout de compte de paiement. Lorsque l’utilisateur ajoute un nouveau compte de paiement, vous pouvez l’enregistrer et lui suggérer ensuite de payer avec ce compte sans ouvrir l’interface de paiement.
- Configurez le webhook Suppression de compte de paiement.
Traiter les événements de l'interface sur la page de gestion des comptes de paiement enregistrés
Pour afficher les informations de la page de gestion des comptes de paiement enregistrés en temps réel, traitez les événements de l’interface de paiement suivants :
add_saved_account
— enregistrement du compte de paiement réussi.
Format :
command: "add_saved_account"
data:
id: 12345678
name: "1111111111111111"
payment_method: 0001
type: "card"
add_saved_account_error
— erreur lors de l'enregistrement du compte de paiement.cancel_save_account
— annulation de l'enregistrement du compte de paiement par l'utilisateur.
Si l’interface de paiement est ouverte dans un iframe ou à l’aide du script Pay Station Embed, vous recevrez les événements de l’interface de paiement via postMessage.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.