Prérequis

Pour des raisons de sécurité des paiements et éviter les opérations frauduleuses, le formulaire embarqué s’appuie sur un serveur marchand que vous devez mettre à disposition.

Ce serveur répond à plusieurs besoins :

• Valider que les transactions à transmettre à la plateforme de paiement correspondent bien à des achats issus de votre site marchand, et que les montants et devises sont conformes,
• Conserver de manière sécurisée vos clés de communication avec la plateforme de paiement,
• Recevoir les notifications instantannées de la plateforme de paiement, pour chaque événement de paiement (accepté, refusé, etc…)

Vous avez besoin de 3 clés pour authentifier vos échanges avec la plateforme de paiement:

Les clés sont disponibles dans le Back Office Marchand. Pour y accéder, il faut d’abord se connecter au Back Office Marchand. L’identification d’un utilisateur se réalise par reconnaissance de son identifiant de connexion et du mot de passe associé.

1. Connectez-vous au Back Office Marchand :

2. Saisissez votre identifiant de connexion. Votre identifiant de connexion vous a été communiqué par e-mail ayant pour objet Identifiants de connexion - [nom de votre boutique].
3. Saisissez votre mot de passe. Votre mot de passe vous a été communiqué par e-mail ayant pour objet Identifiants de connexion - [nom de votre boutique].
4. Cliquez sur Valider pour accéder à la page de gestion des transactions.

Vous pouvez récuperer vos clés d’API et informations d’authentification depuis le Back Office Marchand.

Dans le menu Paramétrage > Boutique, sélectionnez votre boutique puis allez dans l’onglet Clés d’API REST.

L’onglet vous présente l’ensemble des informations nécessaires pour l’authentification :

Les Web services REST de paiement utilisent l’authentification HTTP Basic pour sécuriser les appels entre le serveur marchand et les serveurs de la plateforme de paiement (voir Phase d’authentification pour plus de détails). Pour procéder à l’authentification, vous avez besoin d’un compte utilisateur et d’un mot de passe.

Ces informations sont à récupérer dans l’onglet Clés d’API REST du Back Office Marchand :

Pour plus de détails sur l’implémentation, veuillez consulter la page Implémentation dans divers langages de programmation.

Le formulaire embarqué JavaScript nécessite une clé lors de son utilisation dans le navigateur de l’acheteur (il s’agit du paramètre kr-public-key qui est passé dans la balise script de chargement du composant JavaScript). Ces clés sont disponibles dans le Back Office Marchand dans l’onglet Clés d’API REST, dans la partie Clés pour le client JavaScript.

Deux clés sont disponibles :

La clé est dite ‘publique’ car elle est publiquement visible dans le code source de la page affichée par le navigateur de l’acheteur.

Il existe deux cas où des informations sont envoyées au marchand :

Ces deux flux d’information peuvent être interceptés ou modifiés lors de leur transport. Un processus de hashage est donc utlisé pour permettre au marchand de vérifier l’authenticité et l’intégrité des données reçues.

Deux clés sont disponibles à cet effet :

Pour plus de détails sur le calcul de la clé Retour navigateur : rendez-vous sur la page Paiement effectué. Pour le calcul de la clé lors des appels IPNs, rendez-vous ici Utilisation de l’IPN (URL de notification).

Si vous n’avez pas encore accès au Back Office Marchand, des jeux de clés de démonstration sont mis à votre disposition :

Ces clés sont 100% fonctionnelles. Par contre, il n’est pas possible d’accéder au Back Office Marchand sans avoir de compte personnel.