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 |