En tant que partenaire de notre plateforme, vous avez accès à notre reseller API. Avec cette documentation technique, vous pouvez, par exemple, lier un compte à votre compte partenaire, vous connecter ou créer un profil de site Web. Lisez tout cela ci-dessous.
Introduction
Le reseller API peut être utilisée pour enregistrer de nouveaux commerçants auprès de Mollie, relier les commerçants existants à votre compte partenaire ou modifier les paramètres des commerçants que vous avez amenés.
Le reseller API utilise des clés secrètes pour l'authentification et la sécurité. Nous vous conseillons de lire d'abord la documentation API avant de continuer.
Terminal API
L'API est accessible via :
https://www.mollie.com/api/reseller/v1/methode
Aperçu de toutes les méthodes disponibles
Le reseller API utilise des clés secrètes pour l'authentification et la sécurité. Nous vous conseillons de lire d'abord la documentation API avant de continuer. La documentation explique comment les méthodes API peuvent être utilisées.
account-claim
account-create
account-edit
account-valid
available-payment-methods
bankaccount-edit
bankaccounts
disconnect-account
get-login-link
profile-create
profiles
set-fees
Les méthodes de l'API Partenaire ne peuvent être approchées que par HTTP POST. Ceci permet d'éviter que des paramètres sensibles ne se retrouvent dans les journaux. L'envoi d'une requête GET ou de paramètres GET à cette API provoquera un message d'erreur.
Méthode : account-claim
La méthode account-claim peut être utilisée pour lier un compte Mollie existant à votre propre compte Mollie.
Vous devenez alors le partenaire de ce compte, et il apparaîtra dans la liste des commerçants que vous avez amenés . Le compte recevra le même taux iDEAL que vos autres commerçants. Vous recevrez également une commission de partenaire pour avoir fait venir ce commerçant.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte que vous voulez réclamer. | – |
password | Le mot de passe du compte que vous voulez réclamer. | – |
Tous les paramètres obligatoires |
---|
Résultats possibles
Code | Explication |
10 | Le compte a été réclamé avec succès |
20 | Le champ du nom d'utilisateur est manquant. |
21 | Le champ du mot de passe est manquant. |
30 | La combinaison du nom d'utilisateur et du mot de passe est incorrecte. |
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Succesfully claimed the account.</resultmessage>
<partner_id>1337</partner_id>
<username>chucknorris</username>
</response>
Méthode : account-create
Vous pouvez utiliser cette méthode pour créer un compte pour un commerçant. Ce compte apparaîtra dans votre liste de commerçants que vous avez amenés.
Paramètre | Explication | Commentaires |
test mode | Mode test | Valeurs : 1 ou laisser de côté. Si cette option est activée, aucun compte ne sera créé. Vous pouvez utiliser cette option pour expérimenter la création de comptes. L'ID partenaire résultant sera 1000. |
username | Nom d'utilisateur choisi | – |
name | Nom complet du commerçant. | – |
company_name | Nom de l'entreprise | – |
L'adresse email du commerçant | Un courriel de confirmation sera envoyé à cette adresse. | |
address | Rue et numéro | – |
zip code | Code postal | – |
city | Ville | – |
country | ISO 3166-1 alpha-2 code du pays | NL pour les Pays-Bas, BE pour la Belgique |
Paramètres optionnels | ||
---|---|---|
locale | Lieu de prédilection du commerçant | Doit être au format local : par exemple, nl_NL / en_US etc. |
registration_number | Numéro d'enregistrement de cette société, pour les sociétés néerlandaises, le numéro d'enregistrement de la Chambre de Commerce. | – |
legal_form | Forme juridique de cette société | Doit être l'une des valeurs suivantes :
|
representative | Représentant | Nom du représentant légal de cette société. |
billing_address | Adresse de facturation | Lorsque ce champ est inclus, vous devez remplir tous les champs facturation_*. |
billing_zip code | Code postal de facturation | – |
billing_city | Ville de facturation | – |
billing_country | Code pays ISO 3166-1 alpha-2 pour l'adresse de facturation | NL pour les Pays-Bas, BE pour la Belgique |
bankaccount_iban | Paiement IBAN | Lorsque ce champ est inclus, vous devez remplir tous les champs compte bancaire_*. |
bankaccount_bic | Code BIC de la banque | – |
bankaccount_bankname | Nom de la Banque | – |
bankaccount_location | Ville où la banque est domiciliée | – |
vat_number | Numéro de TVA | – |
Tous les paramètres obligatoires |
Résultats possibles
Code | Explication |
10 | Le compte a été créé avec succès. |
34 | Le compte ne peut pas être créé parce qu'une ou plusieurs zones ont été refusées. Une description plus détaillée a été incluse dans la réponse. |
36 | Le compte ne peut pas être créé parce que le nom d'utilisateur a été pris en compte. |
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0" encoding="UTF-8"?>
<response version="v1">
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Compte créé avec succès.</resultmessage>
<username>jandevries</username>
<password>Vfj@$&MC</password>
<partner_id>127035</partner_id>
</response>
Méthode : account-edit
Cette méthode vous permet de modifier un commerçant existant. Vous ne pouvez changer que vos propres commerçants. Veuillez noter que certains changements peuvent faire en sorte que le commerçant ne reçoive plus de paiements.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte que vous souhaitez modifier. | – |
Paramètres optionnels | ||
---|---|---|
name | Nom complet du commerçant. | – |
company_name | Nom de l'entreprise | – |
L'adresse email du commerçant | Un courriel de confirmation sera envoyé à cette adresse. | |
address | Rue et numéro | – |
zip code | Code postal | – |
city | Ville | – |
country | ISO 3166-1 alpha-2 code du pays | NL pour les Pays-Bas, BE pour la Belgique |
locale | Lieu de prédilection du commerçant |
Doit être au format local : par exemple, nl_NL / en_US etc. |
registration_number | Numéro d'enregistrement de cette société, pour les sociétés néerlandaises, le numéro d'enregistrement de la Chambre de Commerce. | – |
legal_form | Forme juridique de cette société | Doit être l'une des valeurs suivantes :
|
representative | Représentant | Nom du représentant légal de cette société. |
billing_address | Adresse de facturation | Lorsque ce champ est inclus, vous devez remplir tous les champs facturation_*. |
billing_zip code | Code postal de facturation | – |
billing_city | Ville de facturation | – |
billing_country | Code pays ISO 3166-1 alpha-2 pour l'adresse de facturation | NL pour les Pays-Bas, BE pour la Belgique |
bankaccount_iban | Paiement IBAN | Lorsque ce champ est inclus, vous devez remplir tous les champs compte bancaire_*. |
bankaccount_bic | Code BIC de la banque | – |
bankaccount_bankname | Nom de la Banque | – |
bankaccount_location | Ville où la banque est domiciliée | – |
vat_number | Numéro de TVA | – |
Tous les paramètres obligatoires |
Résultats possibles
Code | Explication |
10 | Le compte a été ajusté avec succès. |
30 | Vous ne pouvez pas modifier ce compte, car la combinaison du nom d'utilisateur et du mot de passe est incorrecte. |
35 | Vous ne pouvez pas modifier ce compte, car vous n'avez pas apporté ce compte. |
34 | Le compte ne peut pas être créé parce qu'une ou plusieurs zones ont été refusées. Une description plus détaillée a été incluse dans la réponse. |
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0" encoding="UTF-8"?>
<response><success>true</success>
<resultcode>10</resultcode>
<resultmessage>Compte édité avec succès.</resultmessage>
<username>Jan Janssen</username>
<partner_id>123456</partner_id>
</response>
Méthode : account-valid
Cette méthode vous permet de vérifier si un compte Mollie existe réellement et si le mot de passe de ce compte est correct. La méthode renvoie l'ID partenaire du compte.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte que vous souhaitez vérifier. | – |
password | Le mot de passe du compte que vous souhaitez vérifier. | – |
Tous les paramètres obligatoires |
---|
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Le client janjansen existe et le mot de passe est correct.</resultmessage>
<exists>true</exists>
<partner_id>1337</partner_id>
</response>
Méthode : available-payment-methods
Cette méthode vous permet de vérifier quels modes de paiement ont été activés pour un commerçant.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte dont vous souhaitez vérifier quels modes de paiement ont été activés. | – |
password | Le mot de passe du compte dont vous souhaitez vérifier quels modes de paiement ont été activés. | – |
partner_id_customer | ID partenaire du compte dont vous souhaitez vérifier quels modes de paiement ont été activés. Il peut être utilisé à la place des paramètres nom d'utilisateur et mot de passe. | – |
Tous les paramètres obligatoires |
---|
Exemple de résultat XML
Après l'envoi de la requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Le client dispose des services de paiement suivants.</resultmessage>
<services>
<ivr>vrai</ivr>
<psms>true</psms>
<ideal>faux</ideal>
<paysafecard>true</paysafecard>
<creditcard>false</creditcard>
<mistercash>false</mistercash>
</services>
</response>
Méthode : bankaccount-edit
Cette méthode vous permet de changer le compte bancaire d'un commerçant.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte dont vous souhaitez modifier le compte bancaire | – |
password | Le mot de passe du compte pour lequel vous souhaitez modifier le compte bancaire | – |
partner_id_customer | ID partenaire du compte dont vous souhaitez modifier le compte bancaire. Il peut être utilisé à la place des paramètres nom d'utilisateur et mot de passe. | – |
ID | L'ID du compte bancaire que vous souhaitez modifier | – |
Paramètres optionnels | ||
---|---|---|
name | Nom du compte | – |
IBAN | Paiement IBAN | – |
BIC | Code BIC de la banque | – |
bank name | Nom de la Banque | – |
location | Ville où la banque est domiciliée | – |
Tous les paramètres obligatoires |
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0" encoding="UTF-8"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Compte bancaire mis à jour avec succès.</resultmessage>
<bankaccount>
<id>9d7512a3d2c16b5f9dd49b7aae2d7eaf</id>
<account_name>JAN JANSEN</account_name>
<account_iban>NL40RABO0123456789</account_iban>
<bank_bic>RABONL2U</bank_bic>
<bank>RABOBANK</bank>
<location>AMSTERDAM</location>
<selected>true</selected>
<verified>false</verified>
</bankaccount>
</response>
Méthode : bankaccounts
Cette méthode vous permet de récupérer tous les comptes bancaires d'un client.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte dont vous souhaitez récupérer les comptes bancaires | – |
password | Le mot de passe du compte dont vous souhaitez récupérer les comptes bancaires | – |
partner_id_customer | L'ID partenaire du compte dont vous souhaitez récupérer les comptes bancaires. Il peut être utilisé à la place des paramètres nom d'utilisateur et mot de passe. | – |
Tous les paramètres obligatoires |
---|
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0"?>
<response>
<items>
<bankaccount>
<id>9d7512a3d2c16b5f9dd49b7aae2d7eaf</id>
<account_name>JAN JANSEN</account_name>
<account_iban>NL40RABO0123456789</account_iban>
<bic_code>RABONL2U</bic_code>
<bank>RABOBANK</bank>
<location>AMSTERDAM</location>
<selected>vrai</selected>
<verified>faux</verified>
</bankaccount>
</response>
Méthode : disconnect-account
Cette méthode vous permet d'annuler un de vos commerçants en tant que partenaire. Le lien entre votre compte et celui du commerçant sera rompu. Tous les taux préférentiels dont votre commerçant a bénéficié via votre compte seront réajustés aux taux normaux.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte que vous souhaitez déconnecter | – |
password | Le mot de passe du compte que vous souhaitez déconnecter | – |
partner_id_customer | L'ID du partenaire du compte que vous souhaitez déconnecter. Il peut être utilisé à la place des paramètres nom d'utilisateur et mot de passe. | – |
Tous les paramètres obligatoires |
---|
Résultats possibles
Code | Explication |
10 | Le compte a été déconnecté avec succès. |
30 | Vous ne pouvez pas déconnecter ce compte parce que la combinaison du nom d'utilisateur et du mot de passe est incorrecte. |
35 | Vous ne pouvez pas déconnecter ce compte parce que vous ne l'avez pas apporté. |
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0" encoding="UTF-8"?>
<response><success>true</success>
<resultcode>10</resultcode>
<resultmessage>Compte déconnecté avec succès</resultmessage>
</response>
Méthode : get-login-link
Non disponible normalement!
Cette méthode vous permet d'obtenir un lien spécial, avec lequel un commerçant peut être directement connecté.
Vous devez rediriger le commerçant vers le lien de connexion. Il enregistrera le commerçant, s'il ne l'était pas déjà. Dans tous les autres cas, le commerçant qui était déjà connecté restera connecté.
Lorsque le client n'a pas encore accepté les conditions de Mollie, il doit d'abord le faire avant d'être redirigé.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte auquel vous souhaitez vous connecter | – |
password | Le mot de passe du compte auquel vous souhaitez vous connecter | – |
partner_id_customer | L'ID du partenaire du compte auquel vous souhaitez vous connecter. Il peut être utilisé à la place des paramètres nom d'utilisateur et mot de passe. | – |
Paramètres optionnels | ||
---|---|---|
redirect_URL | L'URL vers laquelle un commerçant doit être redirigé après s'être connecté. Il doit s'agir d'une URL dans le domaine www.mollie.com. | – |
Tous les paramètres obligatoires |
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0" encoding="UTF-8"?>
<response version="v1">
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Rediriger le client vers l'url suivante.</resultmessage>
<redirect_url>https://www.mollie.com/login/oneTimeLogin/4299193/008788d1a618c3aff51acd57ca82661c?redirect_url=%2Fbeheer%2Fbetaalmethodes%2F</redirect_url>
</response>
Méthode : profile-create
Cette méthode vous permet de créer un profil de site Web pour un commerçant.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte auquel vous souhaitez ajouter un profil de site Web. | – |
password | Le mot de passe du compte auquel vous souhaitez ajouter un profil de site Web | – |
partner_id_customer | L'ID du partenaire du compte auquel vous souhaitez ajouter un profil de site Web. Il peut être utilisé à la place des paramètres nom d'utilisateur et mot de passe. | – |
name | Le nom du profil du site Web. | – |
website | Le site web du profil du site web | – |
L'adresse électronique à laquelle vos commerçants peuvent vous joindre | – | |
phone | Le numéro de téléphone auquel vos commerçants peuvent vous joindre | – |
category | La catégorie dans laquelle le commerçant est actif. La valeur est un code de catégorie de commerçant. |
5399 Physical Products5732 Électronique, Ordinateurs et Logiciels4121 Voyages, Locations, Transport6012 Services Financiers5499 Nourriture et Boissons7999 Événements, Festivals et Loisirs5192 Livres, Magazines et Journaux7299 Services Physiques8398 Organismes de Bienfaisance et Dons0 Autre |
Tous les paramètres obligatoires |
---|
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0" encoding="UTF-8"?>
<response version="v1">
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Profil créé avec succès</resultmessage>
<profile>
<name>Snoep.nl</name>
<hash>9C696E36</hash>
<website>http://snoep.nl/</website>
<sector>6</sector>
<category>5399</category>
<verified>false</verified>
<phone>0201234567</phone>
<email>info@snoep.nl</email>
<api_keys>
<test>test_ImXWtEB4alZ149cxDrLxr1XDt8kbI9</test>
<live>live_DjymcBSCZX4MijQ2RKHGTmAvB4J4xw</live>
</api_keys>
</profile>
</response>
Méthode : profiles
Cette méthode vous permet de récupérer tous les profils de sites Web actifs d'un commerçant.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte dont vous souhaitez récupérer les profils | – |
password | Le mot de passe du compte dont vous souhaitez récupérer les profils | – |
partner_id_customer | L'ID du partenaire du compte dont vous souhaitez récupérer les profils. Il peut être utilisé à la place des paramètres de nom d'utilisateur et de mot de passe. | – |
Tous les paramètres obligatoires |
---|
Exemple de XML-result
Après l'envoi d'une requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0"?>
<response>
<items>
<profile>
<name>Snoep.nl</name>
<hash>9C696E36</hash>
<website>http://snoep.nl/</website>
<sector>6</sector>
<category>5399</category>
<verified>true</verified>
<phone>0201234567</phone>
<email>info@snoep.nl</email>
<api_keys>
<test>test_ImXWtEB4alZ149cxDrLxr1XDt8kbI9</test>
<live>live_DjymcBSCZX4MijQ2RKHGTmAvB4J4xw</live>
</api_keys>
</profile>
</items>
</response>
Méthode : set-fees
Non normalement disponible!
La méthode set-fees peut être utilisée pour modifier les tarifs d'un commerçant.
Paramètre | Explication | Commentaires |
username | Le nom d'utilisateur du compte dont vous souhaitez fixer les tarifs | – |
password | Le mot de passe du compte dont vous souhaitez définir les tarifs | – |
partner_id_customer | L'ID partenaire du compte dont vous souhaitez définir les taux. Il peut être utilisé à la place des paramètres de nom d'utilisateur et de mot de passe. | – |
payment_method | Le mode de paiement dont vous souhaitez ajuster le taux. | Les options possibles sont : ideal, paysafecard, carte de crédit, mistercash, virement bancaire, paypal, bitcoin, sofort, belfius, prélèvement automatique, podiumcadeaukaart, remboursement. |
payment_subtype | Le sous-type de mode de paiement dont vous souhaitez ajuster le taux. | Ne s'applique qu'aux cartes de crédit :
Applicable uniquement aux services bancaires SOFORT :
Applicable uniquement aux remboursements :
|
fee_type | Le type de taux que vous aimeriez ajuster. | Les options possibles sont les suivantes : fixe pour l'ajustement des coûts fixes par transaction et pourcentage pour l'ajustement des coûts de transaction variables. |
fee | Le nouveau taux | Envoyer des montants (du type fixe avec deux décimales (par exemple 0,43) et des coûts de transaction variables sous forme de fraction (par exemple 0,025 pour 2,50 %). |
Tous les paramètres obligatoires |
---|
Résultats possibles
Code | Explication |
10 | Le taux a été ajusté. |
20 | Le champ du nom d'utilisateur est manquant. |
21 | Le champ du mot de passe est manquant. |
30 | La combinaison du nom d'utilisateur et du mot de passe est incorrecte. |
37 | La combinaison mode_de_paiement et tarif_type n'est pas valide ; le pourcentage ou les frais fixés sont trop élevés ou trop bas, ou le mode de paiement ne peut pas être défini via l'API. Voir le message d'erreur ci-joint pour connaître l'erreur exacte. |
Exemple de résultat XML
Après l'envoi de la requête HTTP, notre serveur renvoie un résultat XML. Vous trouverez ci-dessous un exemple :
<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Les frais pour le mode de paiement iDEAL sont fixés à 0,22€ par transaction.</resultmessage>
</response>
Téléchargements et exemples
Vous n'avez pas besoin de réinventer la roue. Mollie a un script PHPprêt à l'emploi pour vous. Bien sûr, vous pouvez toujours choisir de faire l'intégration tout seul si les scripts ne répondent pas à vos demandes.
Utilisez-vous node.js ? Dans ce cas, vous pouvez utiliser le client API open source pour node.js, qui a été développé par Matthijs van Henten.
Support
Besoin de soutien ? N'hésitez pas à nous contacter.