====== Neuen Händler melden ====== Mit dieser Funktion kann ein neuer Händler an die GiroSolution AG gemeldet werden. ==== Anfrage ==== **URL:** <>/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 |[[#liste_der_organisationstypen|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 |[[#liste_der_branchen|Id der Branche]]| |merchantShopsystem |Optional |Integer |[[#liste_der_shopsysteme|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|Liste der Zahlungsmethoden]])\\ Beispiel für giropay, Lastschrift mit Sperrdatei und Kreditkarte:\\ 1,11,7 | |giropaypsp |Optional |Integer |[[#liste_der_psps|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 |[[#liste_der_preismodelle|Id des Preismodells]] | |hash |Ja |String(32) |HMAC-MD5 Checksumme | === Beispiel === 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 ==== Antwort ==== Als Antwort wird ein JSON Objekt zurückgeliefert.\\ Im Fehlerfall enthält rc einen dieser [[#liste_der_fehlercodes|Fehlercodes]].\\ Im Erfolgsfall is rc = 0 und das Feld merchantId ist gesetzt. === Beispiel bei Erfolg === { "merchantId":"12345678", "rc":"0", "msg":"", } === Beispiel bei Fehler === { "merchantId":"", "rc":"5000", "msg":"", } ====== Anlagen ====== ==== Liste der Organisationstypen ==== ^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 | ==== Liste der Branchen ==== ^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 - | ==== Liste der Shopsysteme ==== ^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 | ==== Liste der Zahlungsmethoden ==== ^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 | ==== Liste der PSPs ==== ^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 | ==== Liste der Preismodelle ==== ^ID ^Beschreibung ^ |1 |Basic | |2 |Business | ==== Liste der Fehlercodes ==== ^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 |