Inhaltsverzeichnis

Neuen Händler melden

Mit dieser Funktion kann ein neuer Händler an die GiroSolution AG gemeldet werden.

Anfrage

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

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