Développeurs

Applications

Une application :

  • vous permet de configurer le nécessaire pour pouvoir créer vos liens de paiements ;

  • doit être créée pour toute intégration en direct (donc hors plugin CMS qui doit être créé avec une Boutique).

  • vous permet d'être notifié de tout événement survenu sur un paiement (webhooks) de manière personnalisée sur la base des règles que vous définissez.

Le nombre d'applications à créer est à définir en fonction de votre cas d'usage.

Une application est associée à un compte bancaire par défaut : c'est le compte sur lequel les paiements de vos clients seront versés. Ce compte se sélectionne à l'étape Paiement du parcours de création.

Créer une application

La création se fait en 4 étapes : Informations, Paiement, Personnalisation et URLs.

Informations

  1. "Nom de l'application" : mentionnez un nom explicite sur son usage

  2. "Description de l'application" : champ libre pour décrire le cas d'usage de cette application

  3. "Membres avec accès à l'application" :

    • Vous permet de sélectionner les membres qui seront en mesure de voir les paiements ou générer des demandes de paiements pour cette application.

    • Par défaut, tous les membres sont sélectionnés.

    • Les "Administrateurs" ne peuvent pas être supprimés.

  4. "Environnement" : sélectionnez l'environnement selon si vous souhaitez tester Virement Maitrisé en Sandbox ou le rendre disponible pour vos clients en Production

Paiement

  • Rubrique "Compte bénéficiaire"

    "Compte bancaire" : sélectionnez le compte bancaire sur lequel les paiements de vos clients seront versés (le compte doit avoir été créé au préalable dans le menu Vos comptes bancaires). Un compte est présélectionné par défaut : vérifiez-le et modifiez-le si besoin.

  • Rubrique "Moyens de paiement"

    Activez les modes de paiement à proposer à l'acheteur :

    1. Virement simplifié

    2. Virement classique

  • Rubrique "Options additionnelles"

    • Proposer les banques ayant une confirmation de paiement différée : S'applique au parcours Virement simplifié. En désactivant l'option, certaines banques ne seront plus affichées ou appliqueront des frais de virement instantané à vos clients.

    • Permettre à vos clients de réessayer après un paiement échoué : S'applique au parcours Virement simplifié.

    • Proposer le Virement classique sur le menu principal : En désactivant l'option, le Virement classique ne sera proposé qu'en solution alternative au Virement simplifié.

Personnalisation

  • Rubrique "Page de paiement en ligne"

    Vous permet d'intégrer une icône sur l'interface de paiement Virement Maitrisé pour rassurer l'acheteur.

  • Rubrique "Email"

    • Signature personnalisée : saisissez le nom commercial. Cette signature apparaîtra dans l'objet et la signature des emails

    • Style graphique personnalisé :

      • ajout du logo

      • personnalisation de la couleur de la bannière du mail

  • Rubrique "SMS"

    ⚠️

    Important

    Ce mode de communication peut être soumis à une clause contractuelle, les frais d'envoi sont alors à votre charge.

    • Nom commercial : vous permet de personnaliser le nom de l'expéditeur des sms.

    • "Demande de paiement personnalisée"

      Lors de l'envoi d'une demande de paiement par sms, le message peut être :

      • Personnalisé par l'utilisateur (la personnalisation est faite durant la création du lien de paiement)

      • Par défaut celui du modèle

  • Rubrique "Rappels de paiement par email"

    Vous pouvez activer des e-mails de relance automatiques envoyés au payeur lorsqu'une demande de paiement par e-mail inclut une date d'échéance :

    • 3 jours avant l'échéance
    • 1 jour après l'échéance
    • 10 jours après l'échéance

URLs (optionnel)

  • Rubrique "URLs de redirection"

    • Vous permet de rediriger le client vers une page spécifique après validation du paiement
  • Rubrique "Webhooks"

    • Webhook endpoint : lien URL sur lequel envoyer la notification

    • Temps de décalage : délai entre l'action et l'alerte

    • Ajoutez un événement : sélection de l'évènement qui sera source de la notification

  • Rubrique "En-têtes"

    • Mesure de sécurité supplémentaire que vous pouvez mettre.
💡

Note

✅ Pour valider la création de l'application, il est nécessaire de cliquer en fin de processus sur "Créer mon application" puis sur "Générer la clé privée".

🔡 À la fin de la création de l'application, les clefs API à utiliser pour finaliser l'intégration Virement Maitrisé sont fournies :

→ APP ID

→ APP SECRET

→ Clé Privée

🔗 Ces éléments vous permettent de vous authentifier et d'être utilisés dans votre API.

💻 Les ID sont automatiquement téléchargés sur votre ordinateur lorsque vous créez l'application.

Modifier une application

Une application existante s'édite via les onglets Informations, Paiement, Personnalisation et URLs.

Pour changer le compte bancaire sur lequel les paiements sont encaissés, ouvrez l'onglet Paiement : le compte bénéficiaire se trouve en haut de cet onglet.


Simulateur d'événements

Pour réaliser vos tests en sandbox, nous mettons à votre disposition un simulateur d'événements pour simuler les paiements d'un utilisateur. Certains cas de Virement classique ne peuvent être testés que par ce biais.

Pour simuler un virement, veuillez renseigner le nom du bénéficiaire, l'IBAN virtuel associé à l'utilisateur ou a la session de paiement, ainsi que la référence du paiement dans le champ Label.


Did this page help you?