Integration
Grundlagen
FAQ
eps
giropay
iDEAL
Kreditkarte
Lastschrift
Bluecode
Maestro
Payment Page
PayPal
Tools
Fehlernummern
Ergebniscode
Testdaten
Grundlagen
FAQ
eps
giropay
iDEAL
Kreditkarte
Lastschrift
Bluecode
Maestro
Payment Page
PayPal
Tools
Fehlernummern
Ergebniscode
Testdaten
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 |