Un guide pas à pas pour connecter ConvesioPay à Checkout Champ / Konnective et traiter des paiements en production. Suivez-le du début à la fin et vous encaisserez vos paiements via Convesio à l’arrivée.
Trois étapes : créez une intégration connectée dans ConvesioPay, raccordez cette intégration à Checkout Champ, puis effectuez un test rapide sur votre tunnel de vente avant la mise en production.
À l’étape 1, vous générerez une clé secrète qui ne s’affiche qu’une seule fois. Avant de commencer, prévoyez un emplacement sécurisé où la coller (un gestionnaire de mots de passe ou le coffre-fort sécurisé de votre équipe).
Commencez par créer l’intégration dans ConvesioPay et générer la clé secrète qui servira à relier les deux systèmes.
Dans le portail ConvesioPay, rendez-vous dans Advanced Settings et sélectionnez Connected Integrations.

Cliquez sur Create New Integration dans le coin supérieur droit. Saisissez un nom pour votre intégration et notez-le — vous aurez besoin de ce nom exact lors de la connexion à Checkout Champ / Konnective.

Cliquez sur Create & Generate Key. Une fenêtre contextuelle affiche votre clé secrète.
La clé secrète ne s’affiche qu’une seule fois et ne pourra pas être récupérée par la suite. Copiez-la dans un emplacement sécurisé avant de fermer la fenêtre contextuelle.

Vous disposez maintenant d’une intégration nommée et d’une clé secrète enregistrée. Gardez les deux sous la main — ce sont elles qui feront le lien avec Checkout Champ à l’étape 2.
Activez maintenant ConvesioPay dans Checkout Champ / Konnective, saisissez les informations de votre entreprise et reliez votre compte pour que les deux systèmes communiquent.
Dans Checkout Champ / Konnective, sélectionnez Gateway Integration dans la barre latérale gauche. Recherchez Convesio, choisissez l’icône ConvesioPay dans la liste, puis cliquez sur Activate.

Renseignez les champs obligatoires à l’aide du tableau de référence ci-dessous.
| Champ | Valeur à saisir |
|---|---|
| Title | Le nom d’intégration (Integration Name) créé à l’étape 1. |
| Domain | L'URL de votre tunnel Checkout Champ — par ex. get.domain.com ou checkout.domain.com. |
| URL | L’URL de votre boutique Shopify. |
| Customer Service | Le numéro de téléphone et l’adresse e-mail de votre service client. |
| ISO | convesio pay |
| Descriptor (libellé de facturation) | Votre Statement Descriptor, c’est-à-dire votre libellé de facturation (voir la note ci-dessous). |
Vous n’avez pas votre libellé ? Demandez-le à l’équipe Compaytence, ou retrouvez-le dans le Convesio Portal : Advanced Settings → Support Details (sous Business Settings). Il y figure sous le nom Statement Descriptor — saisissez cette valeur dans le champ Descriptor.

Cliquez sur le bouton vert Create Gateway en bas à droite.

Une fois la passerelle créée, modifiez-la : cliquez sur le bouton bleu edit de la passerelle que vous venez de créer.

Dans la vue de modification de la passerelle, activez le bouton bascule Send Product Details (sendProductDetails). C'est désormais obligatoire au titre de la conformité — les détails produit doivent être transmis à chaque transaction — et c'est ce qui permet à Convesio de recevoir les données de transaction.
Cliquez sur le nouveau bouton Connect Account qui apparaît. La section Generate ConvesioPay API Credentials s’ouvre. Saisissez l’e-mail et le mot de passe que vous utilisez pour vous connecter au ConvesioPay Dashboard, puis cliquez sur Submit.
Il doit s’agir des identifiants ConvesioPay du Master User. Les identifiants des utilisateurs ajoutés ne fonctionneront pas ici.
La secretKey s'affiche alors — l'intégration est connectée. Cliquez sur le bouton bleu Update dans le coin inférieur droit pour terminer.
ConvesioPay est maintenant activé et connecté dans Checkout Champ. Reste à le tester avant d’y diriger du trafic réel.
L’intégration étant connectée, attribuez la passerelle Convesio à vos offres et effectuez un test sur votre tunnel de vente avant de passer entièrement en production.
Les étapes ci-dessous basculent en lot toutes les commandes vers la passerelle Convesio. Si vous préférez ne pas tout basculer d’un coup, attribuez plutôt la passerelle Convesio à un seul identifiant produit et testez-le sur votre tunnel de test.
Dans Checkout Champ, rendez-vous dans la section CRM et sélectionnez Campaigns. Repérez la campagne qui contient vos offres et cliquez sur l’icône bleue edit.

Dans General Details, vérifiez que Base Currency est défini sur USD, puis cliquez sur le bouton bleu Save.
Rendez-vous dans la section Offers, ouvrez le menu déroulant Options et cliquez sur Batch Update.

Le panneau Batch Update Products s’ouvre. Cliquez sur la barre Update Gateway Account, sélectionnez Convesio dans la section Gateway Account, puis cliquez sur Batch Update.

Vous pouvez maintenant tester Convesio sur votre tunnel de vente Checkout Champ en production.
Intégration créée, connectée et testée. Convesio est prêt à traiter les paiements via votre tunnel de vente Checkout Champ.
Si un élément de la configuration de la passerelle ne se comporte pas comme ce guide le décrit, contactez votre interlocuteur Compaytence avant de passer en mode réel.