Back Office

Back Office vs Merchant Portal

Le Merchant Portal et le Back Office ont chacun des pages de connexion distinctes et une disposition d'interface utilisateur différente.

Pour vous assurer lequel vous utilisez actuellement, consultez ces captures d'écran / URLs de connexion.

Back Office

Connexion de test Back Office Connexion de production Back Office

Merchant Portal

Connexion de test du Merchant Portal Connexion de production du Merchant Portal

Configuration de l'API Key/Secret

Le mécanisme d'authentification de l'API Direct est basé sur une paire de API Key/API secret liée à votre PSPID. Suivez ces étapes : 

1. Connectez-vous au Back Office. Allez dans Configuration > Information technique > Paramètres de l'API > Clé API Direct
2. Si vous n'avez encore rien configuré, l'écran affiche "Aucun identifiant API trouvé". Pour créer à la fois la API Key et le API secret cliquez sur "GÉNÉRER"

1. L'écran affiche maintenant les deux codes dans le tableau respectivement dans la colonne "Clé" / "Secret"

Clé	La clé actuelle configurée dans ce PSPID
Date de version	La date à laquelle la paire Clé/Secret a été créée
Date d'expiration	La date à laquelle la paire Clé/Secret expirera. La durée par défaut de validité est de deux ans
Statut	Le statut actuel de la paire clé/secret de l'API "Actif" : utilisable jusqu'à la date définie dans la colonne "Date d'expiration" "Expiration" : expire après la date définie dans la colonne "Date d'expiration"

Si vous souhaitez utiliser une nouvelle API Key et un API Secret, suivez ces étapes :

1. Sélectionnez une période dans le menu déroulant "garder valable pendant X heure(s)". Cliquez sur le bouton "RENOUVELER". La paire de API Key/Secret actuellement utilisée expirera après la date définie dans "Date d'expiration"
2. Simultanément, une nouvelle paire de API Key/Secret apparaît dans la première ligne du tableau. Assurez-vous de sauvegarder le Secret API dans votre système, car il ne sera plus visible dans le Back Office une fois que vous accédez de nouveau à ce menu
3. Pour forcer une expiration immédiate de la paire API Key/Secret en cours d'expiration, cliquez sur "EXPIRER". Notre plateforme supprime la paire de API Key/Secret respective du tableau et de notre plateforme, la rendant inutilisable pour les requêtes

Webhooks key

Direct utilise les Webhooks pour mettre à jour votre base de données sur les résultats des transactions et les changements de statut. Suivez ces étapes : 

1. Connectez-vous au Back Office. Allez dans Configuration > Informations techniques > Paramètres de l'API > Configuration Webhooks
2. Cliquez sur "GÉNÉRER LA CLÉ DES D'API WEBHOOKS" ou saisissez manuellement la clé api des webhooks souhaitée. La "WebhooksKey" est utilisée pour valider les messages comme un transfert de données légitime entre notre plateforme et votre serveur. Si vous utilisez l'un de nos SDKs, ce processus se produit automatiquement. Si vous choisissez de créer votre propre application, assurez-vous de l'inclure
3. Dans "Urls cible", saisissez votre ou vos destination(s) des webhooks sur votre serveur. Entrez toute URL supplémentaire sur une ligne séparée
4. Cliquez sur "SAUVEGARDEZ" pour confirmer vos paramètres

1. Pour traiter les webhooks entrants dans votre système, vous devez construire une application sur un point de terminaison HTTPS sur votre serveur. Elle doit être capable de :

• Traduire le JSON en objets et vérification de signature. Nos SDKs serveur vous aident à réaliser cela
• Répondre à une action GET et restituer la valeur de l'en-tête 'X-GCS-Webhooks-Endpoint-Verification' dans le corps
• Répondre à l'action POST avec un code de statut 2XX pour tous les événements livrés
• Valider la signature sur le message

Réinitialiser son mot de passe

Pour réinitialiser votre mot de passe, suivez ces étapes :

1. Allez sur l'écran de connexion de test/production et cliquez sur Vous avez perdu votre mot de passe ?

1. Suivez les instructions à l'écran en entrant votre PSPID et l'adresse e-mail de votre utilisateur

1. Gardez un œil sur votre boîte de réception. Notre système vous enverra un mot de passe en quelques minutes. Utilisez ce mot de passe pour vous connecter à votre compte.
2. Le mot de passe que vous avez reçu par e-mail est un mot de passe à usage unique. Vous devez le changer dès la connexion. Saisissez les trois champs comme suit :
   a) Mot de passe actuel : entrez le mot de passe que vous avez reçu par e-mail et utilisé pour vous connecter
   b) Nouveau mot de passe : entrez un nouveau mot de passe de votre choix. Veuillez noter que certaines exigences doivent être respectées comme décrit dans la partie inférieure de l'écran
   c) Confirmer le nouveau mot de passe : entrez à nouveau le nouveau mot de passe du champ Nouveau mot de passe
   
   

Si vous rencontrez toujours des problèmes pour changer votre mot de passe, contactez-nous.

Réinitialisation du mot de passe pour d'autres utilisateurs/PSPIDs

Si vous avez plusieurs utilisateurs dans votre PSPID, vous pouvez réinitialiser leurs mots de passe. Pour ce faire, suivez ces étapes :

1. Connectez-vous au Back Office. Allez dans Configuration > Utilisateurs.
2. Dans l'aperçu du tableau, cliquez sur "Envoyer le nouveau mot de passe" dans la ligne pour l'utilisateur concerné. Si un utilisateur est bloqué en raison de trop nombreux erreurs de mot de passe, vous devez d'abord cliquer sur un bouton "Activer" séparé. Ce n'est qu'alors que le "Envoyer le nouveau mot de passe" sera disponible.
3. Vous recevez un message de réussite à l'écran. Notre système envoie un e-mail automatisé avec un nouveau mot de passe à l'utilisateur. Comme le mot de passe est un mot de passe à usage unique, le destinataire devra le changer comme décrit ci-dessus juste après la première connexion.

Statut de l'activation de la méthode de paiement

Vous pouvez vérifier le statut d'activation de la méthode de paiement via Configuration > Activation PM. Vous pouvez changer son statut d'activation en cliquant sur le symbole "Modifier" via Activation PM.

Apple Pay

Pour proposer ce moyen de paiement, vous devez soit enregistrer votre identifiant marchand (pour le mode d'intégration Hosted Checkout Page) et/ou créer vos certificats Apple Pay (pour Intégration mobile/client).

Enregistrer l'identifiant marchand (Hosted Checkout Page)

Suivez ces étapes :

1. Connectez-vous au Back Office. Allez dans Configuration > Méthodes de paiement > Apple Pay > Enregistrement de marchands > Enregistrement de marchands.
2. Lisez les termes et conditions d'Apple Pay en cliquant sur le lien correspondant. Cliquez sur "S'ENREGISTRER" pour les approuver.
3. Cliquez sur "VÉRIFIER LE STATUT DU COMPTE" et attendez que le message "Votre PSPID est correctement enregistré" apparaisse. Cela prendra seulement quelques secondes : Vous êtes prêt à proposer Apple Pay à vos clients via le mode d'intégration Hosted Checkout Page.

Gardez ce qui suit à l'esprit :

• Vous pouvez répéter l'étape 3 à tout moment pour vérifier votre statut.
• Vous pouvez révoquer votre approbation à tout moment en cliquant sur "SE DÉSINSCRIRE".
• Si vous rejetez les termes et conditions d'Apple Pay, la méthode de paiement ne sera pas disponible sur notre Hosted Checkout Page.
• Les termes et conditions d'Apple peuvent changer. Mettez-vous à jour régulièrement en y accédant.

Créer des certificats Apple Pay (Intégration Mobile/Client)

Pour les paiements via Intégration mobile/client, vous devez créer des certificats Apple. Selon que vous laissiez le traitement de la décryption des données de paiement à nous ou le fassiez vous-même, des différences s'appliquent :

Nous gérons la décryption

Cela nécessite que vous créiez des certificats et que vous les téléchargez dans le Back Office. Pour ce faire, suivez ces étapes :

1. Connectez-vous au Back Office. Allez dans Configuration > Méthodes de paiement > Apple Pay > Enregistrement de marchands > Enregistrement de marchands > Configuration du Hosted Checkout > Ajouter un nouveau certificat.
2. Suivez les instructions sur la page pour :
   a) Télécharger la demande de signature de certificat (CSR) sur cette page.
   b) Créer le certificat Apple Pay sur le portail développeur Apple en utilisant ce CSR.
   c) Téléchargez le certificat généré via les boutons Parcourir... / TÉLÉCHARGER LE CERTIFICAT.

Trouvez des informations détaillées sur la manière d'appliquer ce mode de décryption dans les chapitres "Intégration" et "Cinématique".

Gardez ce qui suit à l'esprit :

• Assurez-vous de créer des certificats séparés pour notre environnement de test / production.
• Apple vous permet de créer un maximum de trois certificats par identifiant marchand. Sachez qu'un seul certificat par identifiant marchand peut être actif. Utilisez les trois emplacements pour gérer les certificats expirants.
• En raison de cette limitation, nous vous recommandons d'utiliser un identifiant marchand différent pour notre environnement de test / production.
• Les certificats Apple expirent après deux ans. Assurez-vous de créer et de télécharger un nouveau certificat à temps. Nous vous enverrons une notification par e-mail dès qu'un certificat sera sur le point d'expirer.

Vous gérez la décryption

Cela nécessite que vous créiez des certificats et que vous les téléchargiez sur votre serveur. Pour ce faire, suivez ces étapes :

1. Contactez-nous pour configurer votre compte Worldline afin de vous permettre de gérer la décryption par vous-même.
2. Configurez votre compte développeur Apple pour vous permettre de gérer le jeton Apple Pay par vous-même.
3. Créez les certificats Apple Pay sur le portail développeur Apple
   a) Créez une demande de signature de certificat
   b) Créez un certificat d'identité marchand
   c) Créez un certificat de traitement de paiement
4. Écrivez le code pour votre application de décryption des données.

Trouvez des informations détaillées sur la manière d'appliquer ce mode de décryption dans les chapitres "Intégration" et "Cinématique".

Ce mode de décryption nécessite plus d'efforts de votre part, notamment

• La décryption du jeton de paiement Apple Pay.
• La génération de clés publiques.
• La création de demandes de signature de certificats (CSR).

Nous recommandons de l'implémenter uniquement si vous

• Préférez gérer la décryption des données vous-même.
• Souhaitez accéder au jeton de paiement avant de traiter le paiement réel.

Bizum

Configure the activation credentials, activate this payment method and make the test configuration.

Configuration and activation

1. Get your Bizum credientials (Bizum ID, Terminal ID, Secret Key).
2. Login to the Back Office (test / live). Go to Configuration > direct.backOfficePath.paymentMethods > Choisissez de nouvelles méthodes de paiement. 
3. Look up Bizum via the search mask and click on "AJOUTER".
4. In "direct.backOfficePath.paymentMethods.contractDataEnter", enter the activation credentials. Click on "ENVOYER".
5. In "Activation PM", select "Yes" and click on "ENVOYER". 

Configuration de test

Vous pouvez activer Bizum de la manière suivante :

• En test avec le simulateur de Direct
• En test avec des tests de bout en bout
• En production pour le traitement de transactions réelles

Activer dans un compte de test avec le simulateur Direct

Cela vous permet d'envoyer des demandes de transaction à notre environnement de test et d'effectuer des tests comme décrit dans notre chapitre Test. Ces transactions n'ont pas d'impact financier.

Suivez ces étapes :

1. Connectez-vous à votre compte de test. Accédez à Configuration > Méthodes de paiement > Choisissez de nouvelles méthodes de paiement.
2. Dans "Critères de filtre supplémentaires", allez sur "Web Banking". Dans le tableau, cliquez sur "Ajouter" à côté de "Bizum".
3. Dans l'onglet "Données de contrat", remplissez les propriétés suivantes :
   

   Propriété	Description/Actions
   UID	Entrez une valeur numérique à 8 chiffres.
   TID	Entrez une valeur numérique à 3 chiffres.
   Secret Key	Entrez l'une de ces chaînes SHA-256 SecretKey : VmFsaWRCaXp1bUtleUluMjRQb3MwMDAx Qml6dW1LZXlJbjI0UG9zMDAwMlZhbGlk S2V5SW4yNFBvczAwMDNWYWxpZEJpenVt SW4yNFBvczAwMDRWYWxpZEJpenVtS2V5 MjRQb3MwMDA1VmFsaWRCaXp1bUtleUlu UG9zMDAwNlZhbGlkQml6dW1LZXlJbjI0 MDAwN1ZhbGlkQml6dW1LZXlJbjI0UG9z

4. Cliquez sur "ENVOYER" pour confirmer.
5. Accédez à l'onglet "Méthodes de paiement". Dans "Activation", sélectionnez le bouton radio "Oui". Cliquez sur "ENVOYER" pour confirmer.

Activer dans un compte de test avec les tests de bout en bout

Cela vous permet d'envoyer des demandes de transaction à notre environnement de test. Notre plateforme envoie vos requêtes à l'environnement de test de Bizum pour traiter vos transactions. Ces transactions n'ont pas d'impact financier.

Suivez ces étapes :

1. Connectez-vous à votre compte de test. Accédez à Configuration > Méthodes de paiement > Choisissez de nouvelles méthodes de paiement.
2. Dans "Critères de filtre supplémentaires", allez sur "Web Banking". Dans le tableau, cliquez sur "Ajouter" à côté de "Bizum".
3. Dans l'onglet "Données de contrat", remplissez les propriétés suivantes :
   

   Propriété	Description/Actions
   UID	Entrez l'Identifiant Unique à 8 chiffres que vous avez reçu de Bizum.
   TID	Entrez l'ID de Terminal à 3 chiffres que vous avez reçu de Bizum.
   Clé Secrète	Entrez la Clé Secrète SHA-256 que vous avez reçue de Bizum.

4. Cliquez sur "ENVOYER" pour confirmer.
5. Accédez à l'onglet "Activation PM". Dans "Activation", sélectionnez le bouton radio "Oui". Cliquez sur "ENVOYER" pour confirmer.

Activer en production pour un traitement réel des transactions

Cela vous permet d'envoyer des demandes de transaction à notre environnement direct. Notre plateforme envoie vos requêtes à l'environnement direct de Bizum pour traiter vos transactions. Ces transactions ont un impact financier.

Suivez ces étapes :

1. Connectez-vous à votre compte direct. Accédez à Configuration > Méthodes de paiement > Choisissez de nouvelles méthodes de paiement.
2. Dans "Critères de filtre supplémentaires", allez sur "Web Banking". Dans le tableau, cliquez sur "Ajouter" à côté de "Bizum".
3. Dans l'onglet "Données de contrat", remplissez les propriétés suivantes :
   

   Propriété	Description/Actions
   UID	Entrez l'Identifiant Unique à 8 chiffres que vous avez reçu de Bizum.
   TID	Entrez l'ID de Terminal à 3 chiffres que vous avez reçu de Bizum.
   Clé Secrète	Entrez la Clé Secrète SHA-256 que vous avez reçue de Bizum.

4. Cliquez sur "ENVOYER" pour confirmer.

Przelewy24

Configurez les identifiants de devise/d'activation et activez cette méthode de paiement.

Configuration de devise pour Przelewy24

1. Connectez-vous au Back Office (test / production). Allez dans Configuration > Abonnement > Devise.
2. Sélectionnez "PLN : Zloty polonais" dans le menu déroulant et cliquez sur "AJOUTER".
3. La devise a été ajoutée au tableau répertoriant toutes les devises disponibles pour vous.

Activation

1. Obtenez vos identifiants d'activation (Merchant ID/CRC/Secret) depuis votre profil utilisateur Przelewy24.
2. Connectez-vous au Back Office (test / direct). Allez dans Configuration > direct.backOfficePath.paymentMethods > Choisissez de nouvelles méthodes de paiement.
3. Recherchez Przelewy24 via le masque de recherche et cliquez sur "AJOUTER".
4. Dans "direct.backOfficePath.paymentMethods.contractDataEnter", entrez les identifiants d'activation. Cliquez sur "ENVOYER".
5. Dans "Activation PM", sélectionnez "Oui" et cliquez sur "ENVOYER".