Als reseller van ons platform heb je toegang tot onze reseller-API. Met deze technische documentatie kan je bijvoorbeeld een account koppelen aan jouw reseller account, inloggen of een websiteprofiel aanmaken. Hieronder lees je hier alles over.

 

Introductie

De Reseller API kan gebruikt worden om nieuwe klanten aan te melden bij Mollie, om bestaande klanten aan jouw reseller-account te koppelen en om instellingen van de door jou aangebrachte klanten te wijzigen.

De Reseller API maakt gebruik van geheime sleutels voor authenticatie en beveiliging. Je wordt geadviseerd eerst de daarbijhorende API documentatie te lezen voordat je verder gaat.

API endpoint

De API is te bereiken via:

https://www.mollie.com/api/reseller/v1/methode

Overzicht van alle beschikbare methodes

De reseller API maakt gebruik van geheime sleutels voor authenticatie en beveiliging. Je wordt geadviseerd eerst de daarbijhorende API documentatie te lezen voordat je verder gaat. In deze documentatie staat uitgelegd hoe je de API-methodes kunt aanroepen.

account-claim
account-create
account-edit
account-valid
available-payment-methods
bankaccount-edit
bankaccounts
disconnect-account
get-login-link
profile-create
profiles
set-fees
De methodes van de Reseller API kunnen alleen via HTTP POST benaderd worden. Dit zodat gevoelige parameters niet in logs terechtkomen. Het versturen van een GET request of GET parameters naar deze API zal een foutmelding geven.

Methode: account-claim

De methode account-claim kan gebruikt worden om een bestaande Mollie-account aan jouw eigen account te koppelen.

Je wordt dan reseller van dit account en het account zal verschijnen in de lijst van klanten die je hebt aangebracht. Het account zal hetzelfde iDEAL tarief krijgen als jouw andere klanten. Ook ontvang je een partner commissie voor deze klant.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account die je wilt claimen.
password Het wachtwoord van het account die je wilt claimen.
Alle verplichte parameters

Mogelijke resultaten

Code Uitleg
10 Het account is met succes geclaimed.
20 Het veld username ontbreekt.
21 Het veld password ontbreekt.
30 De combinatie van gebruikersnaam en wachtwoord is incorrect.

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?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>

Methode: account-create

Met behulp van deze methode kun je een account voor een klant aanmaken. Deze account zal in jouw lijst van aangebrachte klanten verschijnen.

Parameter Uitleg Opmerkingen
testmode Testmodus Waardes: 1 of weglaten. Indien deze optie aanstaat, zal er geen account aangemaakt worden. Deze optie kun je gebruiken om te experimentern met het aanmaken van accounts. Het resulterende partner_id zal dan 1000 zijn.
username Gewenste gebruikersnaam
name De volledige naam van de klant
company_name Bedrijfsnaam
email Emailadres van de klant. Er zal een bevestigingsmail naar dit adres gestuurd worden.
address Straat en huisnummer
zipcode Postcode
city Stad
country ISO 3166-1 alpha-2 lancode NL voor Nederland, BE voor België
Optionele parameters
Locale Voorkeur van de locale van de klant Gebruik de volgende locale format: nl_NL / en_US etc
registration_number Registratienummer van dit bedrijf, voor Nederlandse bedrijven het KVK-nummer.
legal_form Rechtsvorm van dit bedrijf Moet één van de volgende waardes zijn:
  • eenmanszaak (Eenmanszaak (Nederland))
  • eenmanszaak-be (Eenmanszaak (België))
  • eenmans-bvba-be (Eenmans besloten vennootschap met beperkte aansprakelijkheid (België))
  • maatschap (Maatschap (Nederland))
  • vof (Vof (Nederland))
  • vof-be (Vof (België))
  • bv (Bv (Nederland))
  • bvba-be (Bvba (België))
  • cv (Cv (Nederland))
  • commv-be (Comm.v (België))
  • commva-be (Comm.va (België))
  • nv (Nv (Nederland))
  • nv-be (Nv (België))
  • coöperatie (Coöperatie (Nederland))
  • cvoa-be (Coöperatieve vennootschap (CVOA) (België))
  • cvba-be (Coöperatieve vennootschap (CVBA) (België))
  • stichting (Stichting (Nederland))
  • stichting-be (Stichting (België))
  • vereniging (Vereniging (Nederland))
  • vzw-be (Vereniging zonder winstoogmerk (vzw) (België))
  • overheid (Overheidsinstantie (Nederland))
  • kerkgenootschap (Kerkgenootschap (Nederland))
  • kroondomein (Kroondomein (Nederland))
  • lbvn-be (Landbouwvennootschap (België))
  • esv-be (Economisch samenwerkingsverband (België))
  • es-be (Europese vennootschap (België))
  • vvzrl-be (Vennootschap of vereniging zonder rechtspersoonlijkheid (België))
  • niet-be (Buitenlandse onderneming (België))
  • buitenlandse-ven (Buitenlandse vennootschap in Nederland geregistreerd (Nederland))
  • niet-nl (Buitenlandse bedrijfsvorm)
representative Vertegenwoordiger Naam van de rechtsgeldig vertegenwoordiger van dit bedrijf.
billing_address Factuuradres Indien dit veld is gegeven, moet je alle billing_* velden meegeven.
billing_zipcode Postcode voor factuuradres
billing_city Plaats voor factuuradres
billing_country ISO 3166-1 alpha-2 landcode voor factuuradres NL voor Nederland, BE voor België
bankaccount_iban IBAN voor uitbetalingen Indien dit veld is gegeven, moet je alle bankaccount_* velden meegeven.
bankaccount_bic BIC code van de bank
bankaccount_bankname Naam van de bank
bankaccount_location Stad waar de bank gevestigd is
vat_number BTW nummer
Alle verplichte parameters

Mogelijke resultaten

Code Uitleg
10 Het account is met succes aangemaakt.
34 Het account kan niet aangemaakt worden, omdat één of meer velden afgekeurd zijn. Een uitgebreidere omschrijving is opgenomen in het antwoord.
36 Het account kan niet aangemaakt worden, omdat de gebruikersnaam al in gebruik is.

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?xml version="1.0" encoding="UTF-8"?>
<response version="v1">
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Account created successfully.</resultmessage>
<username>jandevries</username>
<password>Vfj@$&amp;MC</password>
<partner_id>127035</partner_id>
</response>

Methode: account-edit

Met deze methode kun je een bestaande klant wijzigen. Je kunt alleen jouw eigen klanten wijzigen. Let op: sommige wijzigingen kunnen ervoor zorgen dat de klant niet meer uitbetaald zal worden.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account die je wilt wijzigen.
Optionele parameters
name De volledige naam van de klant
company_name Bedrijfsnaam
email Emailadres van de klant. Er zal een bevestigingsmail naar dit adres gestuurd worden.
address Straat en huisnummer
zipcode Postcode
city Stad
country ISO 3166-1 alpha-2 lancode NL voor Nederland, BE voor België

Locale

Voorkeur van de locale van de klant

Gebruik de volgende locale format: nl_NL / en_US etc

registration_number Registratienummer van dit bedrijf, voor Nederlandse bedrijven het KVK-nummer.
legal_form Rechtsvorm van dit bedrijf Moet één van de volgende waardes zijn:

 

  • eenmanszaak (Eenmanszaak (Nederland))
  • eenmanszaak-be (Eenmanszaak (België))
  • eenmans-bvba-be (Eenmans besloten vennootschap met beperkte aansprakelijkheid (België))
  • maatschap (Maatschap (Nederland))
  • vof (Vof (Nederland))
  • vof-be (Vof (België))
  • bv (Bv (Nederland))
  • bvba-be (Bvba (België))
  • cv (Cv (Nederland))
  • commv-be (Comm.v (België))
  • commva-be (Comm.va (België))
  • nv (Nv (Nederland))
  • nv-be (Nv (België))
  • coöperatie (Coöperatie (Nederland))
  • cvoa-be (Coöperatieve vennootschap (CVOA) (België))
  • cvba-be (Coöperatieve vennootschap (CVBA) (België))
  • stichting (Stichting (Nederland))
  • stichting-be (Stichting (België))
  • vereniging (Vereniging (Nederland))
  • vzw-be (Vereniging zonder winstoogmerk (vzw) (België))
  • overheid (Overheidsinstantie (Nederland))
  • kerkgenootschap (Kerkgenootschap (Nederland))
  • kroondomein (Kroondomein (Nederland))
  • lbvn-be (Landbouwvennootschap (België))
  • esv-be (Economisch samenwerkingsverband (België))
  • es-be (Europese vennootschap (België))
  • vvzrl-be (Vennootschap of vereniging zonder rechtspersoonlijkheid (België))
  • niet-be (Buitenlandse onderneming (België))
  • buitenlandse-ven (Buitenlandse vennootschap in Nederland geregistreerd (Nederland))
  • niet-nl (Buitenlandse bedrijfsvorm)
representative Vertegenwoordiger Naam van de rechtsgeldig vertegenwoordiger van dit bedrijf.
billing_address Factuuradres Indien dit veld is gegeven, moet je alle billing_*velden meegeven.
billing_zipcode Postcode voor factuuradres
billing_city Plaats voor factuuradres
billing_country ISO 3166-1 alpha-2 landcode voor factuuradres NL voor Nederland, BE voor België
bankaccount_iban IBAN voor uitbetalingen Indien dit veld is gegeven, moet je allebankaccount_* velden meegeven.
bankaccount_bic BIC code van de bank
bankaccount_bankname Naam van de bank
bankaccount_location Stad waar de bank gevestigd is
vat_number BTW nummer
Alle verplichte parameters

Mogelijke resultaten

Code Uitleg
10 Het account is met succes aangepast.
30 Je kunt deze account niet wijzigen, omdat de combinatie van gebruikersnaam en wachtwoord onjuist is.
35 Je kunt deze account niet wijzigen, omdat deze account niet door jou is aangebracht.
34 Het account kan niet aangemaakt worden, omdat één of meer velden afgekeurd zijn. Een uitgebreidere omschrijving is opgenomen in het antwoord.

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?xml version="1.0" encoding="UTF-8"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Account edited successfully.</resultmessage>
<username>Jan Janssen</username>
<partner_id>123456</partner_id>
</response>

Methode: account-valid

Met deze methode kun je controleren of een Mollie account bestaat en of het wachtwoord van dit account correct is. De methode geeft het partner id van het account terug.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account die je wilt controleren.
password Het wachtwoord van het account die je wilt controleren.
Alle verplichte parameters

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Customer janjansen exists and password is correct.</resultmessage>
<exists>true</exists>
<partner_id>1337</partner_id>
</response>

Methode: available-payment-methods

Met deze methode kun je controleren welke betaalmethodes geactiveerd zijn voor een klant.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account waarvan je wilt controleren welke betaalmethodes geactiveerd zijn
password Het wachtwoord van het account waarvan je wilt controleren welke betaalmethodes geactiveerd zijn
partner_id_customer Het partner id van het account waarvan je wilt controleren welke betaalmethodes geactiveerd zijn. Dit kan gebruikt worden in plaats van de parameters username en password.
Alle verplichte parameters

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Customer has the following payment services available.</resultmessage>
<services>
<ivr>true</ivr>
<psms>true</psms>
<ideal>false</ideal>
<paysafecard>true</paysafecard>
<creditcard>false</creditcard>
<mistercash>false</mistercash>
</services>
</response>

Methode: bankaccount-edit

Met deze methode kun je de bankrekening van een klant wijzigen.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account waarvan je de bankrekening wilt wijzigen
password Het wachtwoord van het account waarvan je de bankrekening wilt wijzigen
partner_id_customer Het partner id van het account waarvan je de bankrekening wilt wijzigen. Dit kan gebruikt worden in plaats van de parameters username en password.
id Het id van de bankaccount die je wilt wijzigen
Optionele parameters
name Tenaamstelling van de rekening
iban IBAN voor uitbetalingen
bic BIC code van de bank
bankname Naam van de bank
location Stad waar de bank gevestigd is
Alle verplichte parameters

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?xml version="1.0" encoding="UTF-8"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Bankaccount successfully updated.</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>

Methode: bankaccounts

Met deze methode kun je alle bankrekeningen van een klant ophalen.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account waarvan je de bankrekeningen wilt ophalen
password Het wachtwoord van het account waarvan je de bankrekeningen wilt ophalen
partner_id_customer Het partner id van het account waarvan je de bankrekeningen wilt ophalen. Dit kan gebruikt worden in plaats van de parameters username en password.
Alle verplichte parameters

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?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>true</selected>
<verified>false</verified>
</bankaccount>
</items>
</response>

Methode: disconnect-account

Met deze methode kun je één van jouw klanten afmelden als reseller. De koppeling tussen jouw account en dat van de klant zal verbroken worden. Eventuele aangepaste tarieven die de klant via je account had, zullen teruggezet worden op de normale tarieven.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account die je wilt loskoppelen
password Het wachtwoord van het account die je wilt loskoppelen
partner_id_customer Het partner id van het account die je wilt loskoppelen. Dit kan gebruikt worden in plaats van de parameters username en password.
Alle verplichte parameters

Mogelijke resultaten

Code Uitleg
10 Het account is met succes losgekoppeld.
30 Je kunt deze account niet loskoppelen, omdat de combinatie van gebruikersnaam en wachtwoord onjuist is.
35 Je kunt deze account niet loskoppelen, omdat deze account niet door jou is aangebracht.

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?xml version="1.0" encoding="UTF-8"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Account disconnected successfully.</resultmessage>
</response>

Niet standaard beschikbaar!
Met deze methode kun je een speciale link krijgen, waarmee een klant direct kan worden ingelogd.

Je dient de klant door te sturen naar de login-link. Deze zal de klant inloggen, indien deze nog niet is ingelogd. In andere gevallen blijft de klant ingelogd, die ingelogd was.

Wanneer de klant de algemene voorwaarden van Mollie nog niet heeft geaccepteerd, moet de klant deze eerst accepteren voordat hij / zij doorgestuurd wordt.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account waarin je wilt inloggen
password Het wachtwoord van het account die waarin je wilt inloggen
partner_id_customer Het partner id van het account waarin je wilt inloggen. Dit kan gebruikt worden in plaats van de parameters username en password.
Optionele parameters
redirect_URL De URL waar de klant na het inloggen naar toe gestuurd moet worden. Dit moet een URL op het www.mollie.com domein zijn.
Alle verplichte parameters

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?xml version="1.0" encoding="UTF-8"?>
<response version="v1">
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Redirect the customer to the following url.</resultmessage>
<redirect_url>https://www.mollie.com/login/oneTimeLogin/4299193/008788d1a618c3aff51acd57ca82661c?redirect_url=%2Fbeheer%2Fbetaalmethodes%2F</redirect_url>
</response>

Methode: profile-create

Met deze methode kun je een websiteprofiel aanmaken voor een klant.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account waarbij je een websiteprofiel wilt toevoegen
password Het wachtwoord van het account waarbij je een websiteprofiel wilt toevoegen
partner_id_customer Het partner id van het account waarbij je een websiteprofiel wilt toevoegen. Dit kan gebruikt worden in plaats van de parameters username en password.
name De naam van het websiteprofiel.
website De website van het websiteprofiel
email Het emailadres waarop jouw klanten je kunnen bereiken
phone Het telefoonnummer waarop jouw klanten je kunnen bereiken
category De category waarin de klant actief is. De waarde is een merchant category code. 5399
Fysieke producten5732
Electronica, computers en software4121
Reizen, verhuur, vervoer6012
Financiële dienstverlening5499
Drank- en etenswaren7999
Evenementen, festivals en recreatie5192
Boeken, tijdschriften en kranten7299
Fysieke dienstverlening8398
Goede doelen en donaties0
Anders
Alle verplichte parameters

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?xml version="1.0" encoding="UTF-8"?>
<response version="v1">
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Profile created successfully</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>

Methode: profiles

Met deze methode kun je alle actieve websiteprofielen van een klant ophalen.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account waarvan je de profielen wilt ophalen
password Het wachtwoord van het account waarvan je de profielen wilt ophalen
partner_id_customer Het partner id van het account waarvan je de profielen wilt ophalen. Dit kan gebruikt worden in plaats van de parameters username en password.
Alle verplichte parameters

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?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>

Methode: set-fees

Niet standaard beschikbaar!
De methode set-fees kan gebruikt worden om de tarieven van de klant aan te passen.

Parameter Uitleg Opmerkingen
username De gebruikersnaam van het account waarvan je de tarieven wilt instellen
password Het wachtwoord van het account waarvan je de tarieven wilt instellen
partner_id_customer Het partner id van het account waarvan je de tarieven wilt instellen. Dit kan gebruikt worden in plaats van de parameters username en password.
payment_method De betaalmethode waarvan je het tarief wilt aanpassen. Mogelijke opties zijn: ideal, paysafecard, creditcard, mistercash, banktransfer, paypal, bitcoin, sofort, belfius, directdebit, podiumcadeaukaart, refund.
payment_subtype Het subtype betaalmethode waarvan je het tarief wilt aanpassen. Alleen van toepassing op creditcard:

 

  • region_1 voor het aanpassen van tarieven Regio 1 (Intra EU consumentenkaarten aan mechants in de EU)
  • region_2 voor het aanpassen van tarieven Regio 2 (Overige kaarten)

Alleen van toepassing op SOFORT Banking:

  • retail
  • digital
  • adult

Alleen van toepassing op refunds:

  • ideal voor het aanpassen van iDEAL/Overboeking/Bancontact Mister Cash/ SOFORT Banking en PayPal refunds.
  • creditcard voor het aanpassen van creditcard refunds
fee_type Het soort tarief dat je aan wilt passen. Mogelijke opties zijn: fixed voor het aanpassen van de vaste kosten per transactie en percentage voor het aanpassen van de variabele transactiekosten.
fee Het nieuwe tarief Stuur bedragen (van type fixed met twee decimalen (bijvoorbeeld 0.43), en variabele transactiekosten als een fractie (bijvoorbeeld 0.025 voor 2,50%).
Alle verplichte parameters

Mogelijke resultaten

Code Uitleg
10 Het tarief is aangepast.
20 Het veld username ontbreekt.
21 Het veld password ontbreekt.
30 De combinatie van gebruikersnaam en wachtwoord is incorrect.
37 De combinatie van payment_method en fee_type is ongeldig; het ingestelde bedrag of percentage voor fee is te hoog of te laag, of de betaalmethode kan niet ingesteld worden via de API. Zie de bijbehorende error message voor de precieze fout.

Voorbeeld XML-resultaat
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:


<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Fee for payment method iDEAL set to &#x20AC; 0,22 per transaction.</resultmessage>
</response>

Downloads & voorbeelden
Je hoeft zelf niet opnieuw het wiel uit te vinden. Mollie heeft een kant-en-klaar PHP script voor je klaar staan. Natuurlijk kun je er ook voor kiezen om de integratie geheel zelf te doen als de scripts niet voldoen aan jouw eisen.

Maak je gebruik van node.js? Dan kun je gebruik maken van de open source API-client voor node.js, die ontwikkeld is door Matthijs van Henten.

Ondersteuning
Heb je ondersteuning nodig? Neemt dan gerust contact met ons op.

Was dit artikel nuttig?