Als Vertriebspartner unserer Plattform haben Sie Zugriff auf unsere Reseller API. Mit dieser technischen Dokumentation können Sie z.B. einen Account mit Ihrem Wiederverkäufer-Account verknüpfen, sich einloggen oder ein Website-Profil erstellen. Lesen Sie hier alles was Sie darüber wissen müssen.

Einführung

Die Reseller API kann verwendet werden, um neue Händler bei Mollie zu registrieren, bestehende Händler mit Ihrem Wiederverkäufer-Konto zu verknüpfen oder Einstellungen von Händlern zu ändern, die Sie eingebracht haben.

Die Reseller API verwendet geheime Schlüssel zur Authentifizierung und Sicherheit. Es wird empfohlen, zuerst die beiliegende API-Dokumentation zu lesen, bevor Sie fortfahren.

API Endpunkt

Sie haben Zugang zur API über:

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

Übersicht aller verfügbaren Methoden

Die Reseller API verwendet geheime Schlüssel zur Authentifizierung und Sicherheit. Es wird empfohlen, zuerst die beiliegende API-Dokumentation zu lesen, bevor Sie fortfahren. Die Dokumentation erklärt, wie die API-Methoden aufgerufen werden können.

account-claim
account-create
account-edit
account-valid
available-payment-methods
bankaccount-edit
bankaccounts
disconnect-account
get-login-link
profile-create
profiles
set-fees


Die Reseller-API-Methoden können nur über HTTP POST erreicht werden. Damit soll verhindert werden, dass sensible Parameter in Protokollen landen. Das Senden einer GET-Anfrage oder eines GET-Parameters an diese API führt zu einer Fehlermeldung.

Methode: account-claim

Die Methode account-claim kann verwendet werden, um ein bestehendes Mollie-Konto mit Ihrem eigenen zu verknüpfen.

Sie werden dann der Vertriebspartner (Reseller) dieses Kontos und es erscheint in der Liste der Händler, die Sie eingebracht haben. Das Konto erhält den gleichen iDEAL-Tarif wie Ihre anderen Händler. Sie erhalten zu dem eine Partnerprovision für das Einbringen dieses Händlers.

Parameter Erklärung Bemerkungen
username Der Benutzername des Kontos, das Sie beanspruchen möchten.
password Das Passwort des Kontos, das Sie beanspruchen möchten.
Alle obligatorischen Parameter

Mögliche Ergebnisse

Code Erklärung
10 Das Konto wurde erfolgreich beansprucht
20 Der Benutzername fehlt.
21 Das Passwort fehlt.
30 Die Kombination von Benutzername und Passwort ist falsch.

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Das Konto wurde erfolgreich beansprucht.</resultmessage>
<partner_id>1337</partner_id>
<username>chucknorris</username>
</response>

Methode: account-create

Mit dieser Methode können Sie ein Konto für einen Händler anlegen. Dieses Konto erscheint in Ihrer Liste der Händler, die Sie mitgebracht haben.

Parameter Erklärung Bemerkungen
test mode Testmodus Werte: 1 oder weglassen. Wenn diese Option eingeschaltet ist, wird kein Konto erstellt. Mit dieser Option können Sie mit dem Anlegen von Konten experimentieren. Die resultierende Partner-ID ist 1000.
username Gewählter Benutzername
name Der volle Name des Händlers.
company_name Firmenname
e-mail Die E-Mail-Adresse des Händlers An diese Adresse wird eine Bestätigungs-E-Mail geschickt.
address Straße und Hausnummer
zip code Postleitzahl
city Wohnort
country ISO 3166-1 Alpha-2 Ländercode NL für die Niederlande, BE für Belgien
Optionaler Parameter
locale Bevorzugte Sprache des Händlers Sollte im lokalisierten Format sein: z.B. nl_NL / en_US usw.
registration_number Registrierungsnummer dieses Unternehmens, für niederländische Unternehmen die Registrierungsnummer der Handelskammer.
legal_form Rechtsform dieses Unternehmens Muss eines der folgenden Optionen sein:
  • Einzelunternehmen (Einzelunternehmen (Niederlande))
  • Einzelunternehmen-be (Einzelunternehmen (Belgien))
  • Einzelunternehmen-bvba-be (Einpersonen-Gesellschaft mit beschränkter Haftung (Belgien))
  • Professionelle Partnerschaft (Professionelle Partnerschaft (Niederlande))
  • Offene Handelsgesellschaft (Offene Handelsgesellschaft (Niederlande))
  • Offene Handelsgesellschaft-be (Offene Handelsgesellschaft (Belgien))
  • Gesellschaft mit beschränkter Haftung (Gesellschaft mit beschränkter Haftung (Niederlande))
  • Private Gesellschaft mit beschränkter Haftung-be (Gesellschaft mit beschränkter Haftung (Belgien))
  • Kommanditgesellschaft (Kommanditgesellschaft (Niederlande))
  • Kommanditgesellschaft-be (Kommanditgesellschaft (Belgien))
  • Börsennotierte Partnerschaft-be (Börsennotierte Partnerschaft (Belgien))
  • Gmbh. (Korp. (Niederlande))
  • korp.-be (Korp. (Belgien))
  • Genossenschaft (Genossenschaft (Niederlande))
  • Genossenschaftsunternehmen mit unbegrenzter Haftung-be (Genossenschaftsunternehmen mit unbegrenzter Haftung (CVOA) (Belgien))
  • Genossenschaftsunternehmen mit beschränkter Haftung-be (Genossenschaftsunternehmen mit beschränkter Haftung (CVBA) (Belgien))
  • Stiftung (Stiftung (Niederlande))
  • Stiftung-be (Stiftung (Belgien))
  • Verband (Verband (Niederlande))
  • Gemeinnützige Organisation-be (Gemeinnütziger Verein (vzw) (Belgien))
  • Regierung (Öffentliche Einrichtung (Niederlande))
  • Kirchengemeinde (Kirchengemeinde (Niederlande))
  • Krongut (Krongut (Niederlande))
  • Landwirtschaftliche Partnerschaft-be (Landwirtschaftliche Partnerschaft (Belgien))
  • Wirtschaftliche Interessenvereinigung-be (Wirtschaftliche Interessenvereinigung (Belgien))
  • Europäische Firma-be (Europäische Firma (Belgien))
  • vvzrl-be (Firma oder Vereinigung ohne Firmenpersönlichkeit (Belgien))
  • non-be (Ausländische Firma (Belgien))
  • ausländische Firma (Ausländische Firma mit Sitz in den Niederlanden (Niederlande))
  • non-nl (Ausländische Gesellschaftsform)
representative Vertreter Name des gesetzlichen Vertreters dieser Gesellschaft.
billing_address Rechnungsadresse Wenn dieses Feld inbegriffen ist, müssen Sie alle billing_*Felder ausfüllen.
billing_zip code Rechnungs-PLZ
billing_city Rechnung Wohnort
billing_country ISO 3166-1 Alpha-2 Ländercode für Rechnungsadresse NL für die Niederlande, BE für Belgien
bankaccount_iban Auszahlungs-IBAN Wenn dieses Feld inbegriffen ist, müssen Sie alle bankaccount_*Felder ausfüllen.
bankaccount_bic Bank-BIC-Code
bankaccount_bankname Name der Bank
bankaccount_location Ort des Sitzes der Bank
vat_number MwSt.-Nummer
Alle obligatorischen Parameter

Mögliche Ergebnisse

Code Erklärung
10 Das Konto wurde erfolgreich erstellt.
34 Das Konto kann nicht erstellt werden, da ein oder mehrere Felder abgelehnt wurden. Eine ausführlichere Beschreibung wurde in die Antwort eingefügt.
36 Das Konto kann nicht erstellt werden, da der Benutzername bereits besteht.

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


<?xml version="1.0" encoding="UTF-8"?>
<response version="v1">
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Konto erfolgreich erstellt.</resultmessage>
<username>jandevries</username>
<password>Vfj@$&MC</password>
<partner_id>127035</partner_id>
</response>

Methode: account-edit

Mit dieser Methode können Sie einen bestehenden Händler ändern. Sie können nur Ihre eigenen Händler verändern. Bitte beachten Sie: Einige Änderungen können dazu führen, dass der Händler keine Auszahlungen mehr erhält.

Parameter Erklärung Bemerkungen
username Der Benutzername des Kontos, das Sie ändern möchten.
Optionaler Parameter
name Der volle Name des Händlers.
company_name Firmenname
e-mail Die E-Mail-Adresse des Händlers An diese Adresse wird eine Bestätigungs-E-Mail geschickt.
address Straße und Hausnummer
zip code Postleitzahl
city Wohnort
country ISO 3166-1 Alpha-2 Ländercode NL für die Niederlande, BE für Belgien
locale Bevorzugte Sprache des Händlers

Sollte im lokalisierten Format sein: z.B. nl_NL / en_US usw.

registration_number Registrierungsnummer dieses Unternehmens, für niederländische Unternehmen die Registrierungsnummer der Handelskammer.
legal_form Rechtsform dieses Unternehmens Muss eines der folgenden Optionen sein:
  • Einzelunternehmen (Einzelunternehmen (Niederlande))
  • Einzelunternehmen-be (Einzelunternehmen (Belgien))
  • Einzelunternehmen-bvba-be (Einpersonen-Gesellschaft mit beschränkter Haftung (Belgien))
  • Professionelle Partnerschaft (Professionelle Partnerschaft (Niederlande))
  • Offene Handelsgesellschaft (Offene Handelsgesellschaft (Niederlande))
  • Offene Handelsgesellschaft-be (Offene Handelsgesellschaft (Belgien))
  • Gesellschaft mit beschränkter Haftung (Gesellschaft mit beschränkter Haftung (Niederlande))
  • Private Gesellschaft mit beschränkter Haftung-be (Gesellschaft mit beschränkter Haftung (Belgien))
  • Kommanditgesellschaft (Kommanditgesellschaft (Niederlande))
  • Kommanditgesellschaft-be (Kommanditgesellschaft (Belgien))
  • Börsennotierte Partnerschaft-be (Börsennotierte Partnerschaft (Belgien))
  • Gmbh. (Korp. (Niederlande))
  • korp.-be (Korp. (Belgien))
  • Genossenschaft (Genossenschaft (Niederlande))
  • Genossenschaftsunternehmen mit unbegrenzter Haftung-be (Genossenschaftsunternehmen mit unbegrenzter Haftung (CVOA) (Belgien))
  • Genossenschaftsunternehmen mit beschränkter Haftung-be (Genossenschaftsunternehmen mit beschränkter Haftung (CVBA) (Belgien))
  • Stiftung (Stiftung (Niederlande))
  • Stiftung-be (Stiftung (Belgien))
  • Verband (Verband (Niederlande))
  • Gemeinnützige Organisation-be (Gemeinnütziger Verein (vzw) (Belgien))
  • Regierung (Öffentliche Einrichtung (Niederlande))
  • Kirchengemeinde (Kirchengemeinde (Niederlande))
  • Krongut (Krongut (Niederlande))
  • Landwirtschaftliche Partnerschaft-be (Landwirtschaftliche Partnerschaft (Belgien))
  • Wirtschaftliche Interessenvereinigung-be (Wirtschaftliche Interessenvereinigung (Belgien))
  • Europäische Firma-be (Europäische Firma (Belgien))
  • vvzrl-be (Firma oder Vereinigung ohne Firmenpersönlichkeit (Belgien))
  • non-be (Ausländische Firma (Belgien))
  • ausländische Firma (Ausländische Firma mit Sitz in den Niederlanden (Niederlande))
  • non-nl (Ausländische Gesellschaftsform)
representative Vertreter Name des gesetzlichen Vertreters dieser Gesellschaft.
billing_address Rechnungsadresse Wenn dieses Feld inbegriffen ist, müssen Sie alle billing_*Felder ausfüllen.
billing_zip code Rechnungs-PLZ
billing_city Rechnung Wohnort
billing_country ISO 3166-1 Alpha-2 Ländercode für Rechnungsadresse NL für die Niederlande, BE für Belgien
bankaccount_iban Auszahlungs-IBAN Wenn dieses Feld inbegriffen ist, müssen Sie alle bankaccount_*Felder ausfüllen.
bankaccount_bic Bank-BIC-Code
bankaccount_bankname Name der Bank
bankaccount_location Ort des Sitzes der Bank
vat_number MwSt.-Nummer
Alle obligatorischen Parameter

Mögliche Ergebnisse

Code Erklärung
10 Das Konto wurde erfolgreich angepasst.
30 Sie können dieses Konto nicht ändern, da die Kombination von Benutzername und Passwort falsch ist.
35 Sie können dieses Konto nicht ändern, da Sie dieses Konto nicht eingebracht haben.
34 Das Konto kann nicht erstellt werden, da ein oder mehrere Felder abgelehnt wurden. Eine ausführlichere Beschreibung wurde in die Antwort eingefügt.

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


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

Methode: account-valid

Mit dieser Methode können Sie überprüfen, ob ein Mollie-Konto tatsächlich existiert und ob das Passwort für dieses Konto korrekt ist. Die Methode gibt die Partner-ID des Kontos zurück.

Parameter Erklärung Bemerkungen
username Der Benutzername des Kontos, das Sie überprüfen möchten.
password Das Passwort des Kontos, das Sie überprüfen möchten.
Alle obligatorischen Parameter

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Kunde janjansen existiert und das Passwort ist korrekt.</resultmessage>
<exists>true</exists>
<partner_id>1337</partner_id>
</response>

Methode: available-payment-methods

Mit dieser Methode können Sie überprüfen, welche Zahlungsmethoden für einen Händler aktiviert wurden.

Parameter Erklärung Bemerkungen
username Der Benutzername des Kontos, für das Sie prüfen möchten, welche Zahlungsmethoden aktiviert wurden.
password Das Passwort für des Kontos, für das Sie überprüfen möchten, welche Zahlungsmethoden aktiviert wurden.
partner_id_customer Die Partner-ID des Kontos, für das Sie überprüfen möchten, welche Zahlungsmethoden aktiviert wurden. Sie kann anstelle der Parameter Benutzername und Passwort verwendet werden.
Alle obligatorischen Parameter

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>unde hat die folgenden Zahlungsdienste zur Verfügung.</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

Mit dieser Methode können Sie das Bankkonto eines Händlers ändern.

Parameter Erklärung Bemerkungen
username Der Benutzername des Kontos, dessen Bankkonto Sie ändern möchten
password Das Passwort des Kontos, dessen Bankkonto Sie ändern möchten
partner_id_customer Die Partner-ID des Kontos, dessen Bankkonto Sie ändern möchten. Die Partner-ID kann anstelle der Parameter Benutzername und Passwort verwendet werden.
ID Die ID des Bankkontos, das Sie ändern möchten.
Optionaler Parameter
name Kontoname
IBAN Auszahlungs-IBAN
BIC Bank-BIC-Code
bank name Name der Bank
location Ort des Sitzes der Bank
Alle obligatorischen Parameter

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


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

Mit dieser Methode können Sie alle Bankkonten eines Kunden abrufen.

Parameter Erklärung Bemerkungen
username Der Benutzername des Kontos, dessen Bankkonten Sie abrufen möchten
password Das Passwort des Kontos, dessen Bankkonten Sie abrufen möchten
partner_id_customer Die Partner-ID des Kontos, dessen Bankkonten Sie abrufen möchten. Sie kann anstelle der Parameter Benutzername und Passwort verwendet werden.
Alle obligatorischen Parameter

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


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

Mit dieser Methode können Sie einen Ihrer Händler als Wiederverkäufer kündigen. Die Verbindung zwischen Ihrem Konto und dem des Händlers wird unterbrochen. Alle Vorzugspreise, die Ihr Händler über Ihr Konto erhält, werden an die normalen Tarife angepasst.

Parameter Erklärung Bemerkungen
username Der Benutzername des Kontos, das Sie entfernen möchten
password Das Passwort des Kontos, das Sie entfernen möchten
partner_id_customer Die Partner-ID des Kontos, das Sie entfernen möchten. Die Partner-ID kann anstelle der Parameter Benutzername und Passwort verwendet werden.
Alle obligatorischen Parameter

Mögliche Ergebnisse

Code Erklärung
10 Das Konto wurde erfolgreich entfernt.
30 Sie können dieses Konto nicht entfernen, da die Kombination von Benutzername und Passwort falsch ist.
35 Sie können dieses Konto nicht abschalten, weil Sie es nicht eingeführt haben.

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


<?xml version="1.0" encoding="UTF-8"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Konto erfolgreich abgeschaltet.</resultmessage>
</response>

Normalerweise nicht verfügbar!
Diese Methode ermöglicht Ihnen, einen speziellen Link zu erhalten, mit dem ein Händler direkt eingeloggt werden kann.

Sie müssen den Händler auf den Login-Link umleiten. Dieser wird den Händler einloggen, wenn der Händler nicht schon eingeloggt war. In allen anderen Fällen bleibt der bereits eingeloggte Händler eingeloggt.

Wenn der Kunde Mollies Auflagen noch nicht akzeptiert hat, muss er dies tun, bevor er weitergeleitet werden kann.

Parameter Erklärung Bemerkungen
username Der Benutzername des Accounts, in das Sie sich einloggen möchten
password Das Passwort des Account, in den Sie sich einloggen möchten
partner_id_customer Die Partner-ID des Accounts, in das Sie sich einloggen möchten. Die Partner-ID kann anstelle der Parameter Benutzername und Passwort verwendet werden.
Optionaler Parameter
redirect_URL Die URL, auf die ein Händler nach dem Einloggen umgeleitet werden muss. Dies muss eine URL in der Domain www.mollie.com sein.
Alle obligatorischen Parameter

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


<?xml version="1.0" encoding="UTF-8"?>
<response version="v1">
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Umleitung des Kunden auf die folgende URL.</resultmessage>
<redirect_url>https://www.mollie.com/login/oneTimeLogin/4299193/008788d1a618c3aff51acd57ca82661c?redirect_url=%2Fbeheer%2Fbetaalmethodes%2F</redirect_url>
</response>

Methode: profile-create

Mit dieser Methode können Sie ein Website-Profil für einen Händler erstellen.

Parameter Erklärung Bemerkungen
username Der Benutzername des Accounts, dem Sie ein Website-Profil hinzufügen möchten.
password Das Passwort des Accounts, dem Sie ein Website-Profil hinzufügen möchten
partner_id_customer Die Partner-ID des Accounts, dem Sie ein Website-Profil hinzufügen möchten. Die Partner-ID kann anstelle der Parameter Benutzername und Passwort verwendet werden.
name Der Name des Webseiten-Profils.
website Die Webseite des Website-Profils
e-mail Die E-Mail-Adresse, unter der Ihre Händler Sie erreichen können
phone Die Telefonnummer, unter der Ihre Händler Sie erreichen können
category Die Kategorie, in der der Händler aktiv ist. Der Wert ist ein Händler-Kategorie-Code. 5399
Physical Products5732
Electronics, Computers and Software4121
Reisen, Mieten, Transport6012
Finanzielle Dienstleistungen5499
Speisen und Getränke7999
Ereignisse, Festivals und Freizeit5192
Bücher, Zeitschriften und Zeitungen7299
physische Dienstleistungen8398
Wohltätigkeit und Spenden0
Sonstige
Alle obligatorischen Parameter

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


<?xml version="1.0" encoding="UTF-8"?>
<response version="v1">
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Profil erfolgreich erstellt</resultmessage>
<profile>
<name>Snoep.nl</name>
<hash>9C696E36</hash>
<website>http://snoep.nl/</website>
<sector>6</sector>
<category>5399</category>
<verified>false</verified> 0201234567 <email>info@snoep.nl</email>
<api_keys>
<test>test_ImXWtEB4alZ149cxDrLxr1XDt8kbI9</test>
<live>live_DjymcBSCZX4MijQ2RKHGTmAvB4J4xw</live>
</api_keys>
</profile>
</response>

Methode: profiles

Mit dieser Methode können Sie alle aktiven Webseiten-Profile eines Händlers abrufen.

Parameter Erklärung Bemerkungen
username Der Benutzername des Accounts, von dem Sie die Profile abrufen möchten
password Das Passwort des Accounts, von dem Sie die Profile abrufen möchten
partner_id_customer Die Partner-ID des Accounts, von dem Sie die Profile abrufen möchten. Die Partner-ID kann anstelle der Parameter Benutzername und Passwort verwendet werden.
Alle obligatorischen Parameter

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


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

Normalerweise nicht verfügbar!
Die Methode set-fees kann benutzt werden, um die Tarife eines Händlers zu ändern.

Parameter Erklärung Bemerkungen
username Der Benutzername des Accounta, dessen Tarife Sie einstellen möchten
password Das Passwort des Accounts, dessen Tarife Sie einstellen möchten
partner_id_customer Die Partner-ID des Accounts, dessen Tarife Sie einstellen möchten. Die Partner-ID kann anstelle der Parameter Benutzername und Passwort verwendet werden.
payment_method Die Zahlungsmethode, dessen Tarif Sie anpassen möchten. Mögliche Optionen sind: ideal, paysafecard, Kreditkarte, mistercash, Banküberweisung, paypal, bitcoin, sofort, belfius, Lastschrift, podiumcadeaukaart, Rückerstattung.
payment_subtype Der Zahlungssubtyp, dessen Tarif Sie anpassen möchten. Gilt nur für Kreditkarten:

 

  • region_1 zur Anpassung der Tarife für Region 1 (Intra-EU-Konsumentenkarten an Händler innerhalb der EU)
  • region_2 zur Anpassung der Tarife für Region 2 (Andere Karten)

Gilt nur für SOFORT Banking:

  • retail
  • digital
  • adult

Gilt nur für Rückerstattungen:

  • ideal Für die Anpassung von iDEAL/Transfer/Bancontact Mister Cash/ SOFORT Banking und PayPal Rückerstattungen.
  • credit card für die Anpassung von Kreditkartenrückerstattungen
fee_type Der Tariftyp, den Sie anpassen möchten. Mögliche Optionen sind: festgelegt für die Anpassung der Fixkosten pro Transaktion und Prozentsatz für die Anpassung der variablen Transaktionskosten.
fee Die neue Gebühr Beträge senden (vom festen Typ mit zwei Dezimalstellen (z.B. 0,43) und variable Transaktionskosten als Bruchteil (z.B. 0,025 für 2,50%).
Alle obligatorischen Parameter

Mögliche Ergebnisse

Code Erklärung
10 Die Gebühr wurde angepasst.
20 Der Benutzername fehlt.
21 Das Passwort fehlt.
30 Die Kombination von Benutzername und Passwort ist falsch.
37 Die Kombination payment_method und fee_type ist ungültig; der eingestellte Prozentsatz oder die Rate ist zu hoch oder zu niedrig, oder der Zahlweg kann nicht über die API eingestellt werden. Den genauen Fehler finden Sie in der dazugehörigen Fehlermeldung.

Beispiel eines XML-Ergebnisses
Nach dem Senden einer HTTP-Anfrage sendet unser Server ein XML-Ergebnis zurück. Nachfolgend finden Sie ein Beispiel:


<?xml version="1.0"?>
<response>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Rate für Zahlungsmethode iDEAL auf 0,22 &#x20AC; pro Transaction eingestellt.</resultmessage>
</response>

Downloads & Vorbilder
Sie müssen das Rad nicht neu erfinden. Mollie hat ein gebrauchsfertiges PHP-Skript für Sie. Natürlich können Sie die Integration auch selbst vornehmen, wenn die Skripte nicht Ihren Anforderungen entsprechen.

Verwenden Sie node.js? In diesem Fall können Sie den Open-Source API-Client für node.js verwenden, der von Matthijs van Henten entwickelt wurde.

Support
Brauchen Sie Hilfe? Nehmen Sie Kontakt mit uns auf.