Mit dieser Funktion kann ein neuer Händler an die GiroSolution AG gemeldet werden.
URL: «SERVER»/girocheckout/api/v2/reseller/addmerchant
| Name | Pflicht | Type | Beschreibung |
|---|---|---|---|
| affiliateId | Ja | Integer | Affiliate-ID aus den Zugangsdaten |
| merchantEmail | Ja | String(254) | Eindeutige E-Mail Adresse |
| merchantLanguage | Optional | String(2) | Sprache für die Oberfläche de = deutsch (default) en = englisch |
| merchantCompanyType | Optional | Integer | Id des Organisationstypes |
| merchantOrganisationName | Ja | String(128) | Firmenname |
| merchantAddress1 | Ja | String(128) | Straße und Hausnummer |
| merchantAddress2 | Optional | String(128) | Adresszusatz |
| merchantPostcode | Ja | String(128) | Postleitzahl |
| merchantCity | Ja | String(128) | Ort |
| merchantCountry | Optional | String(2) | Ländercode ISO 3166 DE = Deutschland (default) |
| merchantUrl | Optional | String(250) | Homepage des Unternehmens |
| merchantUstId | Optional | String(14) | Umsatzsteuer-ID mit Ländercode |
| merchantTaxNumber | Optional | String(20) | Steuernummer |
| merchantRegisterNumber | Optional | String(100) | Registernummer (z.B. Handelsregister) |
| merchantBranche | Optional | Integer | Id der Branche |
| merchantShopsystem | Optional | Integer | Id des Shopsystems |
| personFirstname | Ja | String(255) | Vorname des Ansprechpartners |
| personLastname | Ja | String(255) | Nachname des Ansprechpartners |
| personGender | Optional | String | Mögliche Werte: männlich weiblich |
| personEmail | Ja | String(255) | E-Mail Adresse des Ansprechpartners |
| personPhone1 | Optional | String(32) | Telefonnummer des Ansprechpartners |
| personPhone2 | Optional | String(32) | Zusätzliche Telefonnummer des Ansprechpartners |
| forecastTxMonth | Optional | Integer | Anzahl Transaktionen im Monat |
| forecastTxAverage | Optional | Integer | Durchschnittlicher Warenkorb in EUR |
| products | Optional | String | Komma-separierte List der gewünschten Produkte (siehe Liste der Zahlungsmethoden) Beispiel für giropay, Lastschrift mit Sperrdatei und Kreditkarte: 1,11,7 |
| giropaypsp | Optional | Integer | Id des PSP |
| salesTag | Optional | String(255) | Vertriebspartner-Kennzeichen |
| ccTypes | Optional | String | Komma-separierte List der gewünschten Kreditkartentypen. Mögliche Werte: V = Visa M = Mastercard A = Amex Beispiel für Visa und Mastercard: V,M |
| subId | Optional | String(50) | Kennzeichen eines Vertriebspartners, dem der neue Händler zugeordnet werden soll. Die Kennzeichen werden von der GiroSolution AG vergeben und sind nur nach Rücksprache zu verwenden. |
| pricemodel | Optional | Integer | Id des Preismodells |
| hash | Ja | String(32) | HMAC-MD5 Checksumme |
curl -d "affiliateId=350000" \
-d "merchantEmail=1373527619-test@test.de" \
-d "merchantLanguage=de" \
-d "merchantCompanyType=8" \
-d "merchantOrganisationName=Testfirma" \
-d "merchantAddress1=Adresse" \
-d "merchantAddress2=Adresszusatz" \
-d "merchantPostcode=12345" \
-d "merchantCity=Musterhausen" \
-d "merchantCountry=DE" \
-d "merchantUrl=http://www.testmerchant.de" \
-d "merchantUstId=UstId 0815" \
-d "merchantTaxNumber=Steuernummer" \
-d "merchantRegisterNumber=HRB 4711" \
-d "merchantBranche=19" \
-d "merchantShopsystem=606" \
-d "personFirstname=Max" \
-d "personLastname=Mustermann" \
-d "personGender=männlich" \
-d "personEmail=max.mustermann@test.de" \
-d "personPhone1=Telefon 1" \
-d "personPhone2=Telefon 2" \
-d "forecastTxMonth=10000" \
-d "forecastTxAverage=150" \
-d "products=1,11,7" \
-d "hash=c29656b1648ef7935b3d05a7009116d4" \
http://dev.girosolution/girocheckout/api/v2/reseller/addmerchant
Als Antwort wird ein JSON Objekt zurückgeliefert.
Im Fehlerfall enthält rc einen dieser Fehlercodes.
Im Erfolgsfall is rc = 0 und das Feld merchantId ist gesetzt.
{
"merchantId":"12345678",
"rc":"0",
"msg":"",
}
{
"merchantId":"",
"rc":"5000",
"msg":"",
}
| ID | Organisationstyp |
|---|---|
| 1 | AG |
| 2 | e.K. (Eingetragener Kaufmann) |
| 3 | eG |
| 4 | e.V. |
| 5 | Einzelunternehmen |
| 6 | GbR |
| 7 | GmbH |
| 8 | GmbH & Co. KG |
| 9 | KG |
| 10 | OHG |
| 11 | UG |
| 12 | Sonstige |
| ID | Branche |
|---|---|
| 1 | Antiquitäten & Kunst |
| 2 | Audio & Hi-Fi |
| 3 | Auto & Motorrad |
| 4 | Baby |
| 5 | Beauty & Gesundheit |
| 6 | Bücher |
| 7 | Büro & Schreibwaren |
| 8 | Business & Industrie |
| 10 | Feinschmecker |
| 11 | Filme & DVDs |
| 12 | Foto & Camcorder |
| 13 | Garten |
| 14 | Handy & Organizer |
| 15 | Haushaltsgeräte |
| 16 | Heimwerker |
| 17 | Immobilien |
| 18 | Kleidung & Accessoires |
| 19 | Lotterien & Wetten |
| 20 | Möbel & Wohnen |
| 21 | Modellbau |
| 22 | Münzen |
| 24 | Musik |
| 25 | Musikinstrumente |
| 26 | Onlinespiele |
| 27 | PC- & Videospiele |
| 28 | Prepaid |
| 29 | Software |
| 30 | Spielzeug |
| 31 | Sport |
| 32 | Tickets |
| 33 | Tierwelt |
| 34 | TV, Video & Elektronik |
| 35 | Uhren & Schmuck |
| 36 | Urlaub & Reisen |
| 37 | - Sonstige - |
| ID | Shopsystem | Unterstützt? |
|---|---|---|
| 8363 | 1&1 E-Shop | Nein |
| 8364 | 004 Shop-System | Nein |
| 80284 | Afterbuy | Ja |
| 8365 | Awinta | Ja |
| 8366 | Bigware | Nein |
| 8367 | Continue (FUTURE web market) | Nein |
| 8368 | DataBecker (shop to date) | Nein |
| 606 | Drupal / Ubercart | Ja |
| 9154 | DR-WebShop | Ja |
| 8369 | e.pages | Nein |
| 8370 | ESHOP2 PRO (econdoo) | Nein |
| 651 | Gambio | Ja |
| 8371 | GlobeCharge | Nein |
| 8372 | Hybris | Nein |
| 8373 | JTL Shop | Ja |
| 650 | Magento | Ja |
| 8374 | Mallux | Nein |
| 8375 | Mauve Mailorder Software | Nein |
| 653 | modified Shopsoftware (xtcModified) | Ja |
| 8376 | Mondo Shop | Nein |
| 4730 | OpenCart | Ja |
| 655 | osCommerce 2 | Ja |
| 648 | OXID eSales | Ja |
| 8377 | plentymarkets | Nein |
| 658 | PrestaShop | Ja |
| 5940 | SEOshop | Ja |
| 8378 | ShopFactory | Nein |
| 649 | Shopware 3 | Ja |
| 6445 | Shopware 4 | Ja |
| 8379 | Shopodia | Nein |
| 8716 | Sonstiges | Ja |
| 8380 | store systems | Nein |
| 8381 | Strato-Shop | Nein |
| 8382 | SchulverpflegungPlus | Ja |
| 654 | VirtueMart (Joomla) | Ja |
| 8383 | Websale | Nein |
| 10771 | WooCommerce (Wordpress) | Ja |
| 656 | xtCommerce 3 | Ja |
| 657 | xtCommerce 4 / Veyton | Ja |
| 8384 | Zen Shop | Nein |
| 2032 | Eigenentwicklung | Ja |
| 8386 | GiroSpende | Ja |
| ID | Zahlungsmethode |
|---|---|
| 1 | giropay |
| 2 | EPS |
| 4 | Käufersiegel |
| 6 | Lastschrift |
| 7 | Lastschrift mit Sperrdatei |
| 8 | Garantierte Lastschrift |
| 11 | Kreditkarte |
| 12 | iDEAL |
| 14 | PayPal |
| 16 | giropay-ID |
| 17 | giropay-ID + giropay |
| 18 | giropay mit Zahlungsbestätigung |
| 19 | giropay Spende |
| 20 | GiroCode RE |
| 23 | Paydirekt |
| 24 | GiroCode QR |
| 25 | GiroCode ÜW |
| 26 | Blue Code |
| 32 | Payment Page |
| 33 | Maestro |
| ID | Beschreibung |
|---|---|
| 3752 | Adyen |
| 3536 | Computop |
| 2307 | EOS Payment |
| 2599 | Expercash |
| 4 | GiroSolution AG |
| 6211 | heidelpay |
| 4944 | ICEPAY |
| 6212 | LogPay |
| 6214 | mPay24 |
| 4732 | Ogone |
| 2469 | Omba Pay |
| 5732 | PAY.ON |
| 2283 | PAYONE |
| 6213 | PayUnity |
| 6216 | RBS WorldPay |
| 6170 | SIX Payment Services |
| 6215 | Smart2Pay |
| 6225 | Sonstige |
| 3241 | TeleCash |
| 2330 | VöB ZVD |
| ID | Beschreibung |
|---|---|
| 1 | Basic |
| 2 | Business |
| ID | Beschreibung |
|---|---|
| 0 | OK |
| 5000 | Authentifizierung fehlgeschlagen |
| 5001 | Keine Berechtigung |
| 5002 | ungültiger hash |
| 5003 | Mindestens ein Pflichtfeld nicht angegeben |
| 5009 | Ungültige E-Mail Adresse |
| 5010 | Ungültige Sprache |
| 5011 | Ungültiges Land |
| 5012 | Ungültige Branche |
| 5013 | Ungültiges Shopsystem |
| 5014 | Ungültiges Geschlecht |
| 5015 | Ungültiges Produkt |
| 5016 | Organisationstyp ungültig |
| 5017 | Händler existiert bereits |
| 5018 | giropay PSP ungültig |
| 5019 | Ungültiger Kreditkartentyp |
| 5091 | Unfültiges Preismodell |
| 9999 | Interner Fehler |