Integration
Apple Pay
Bluecode
Credit Card
Direct Debit
Direktüberweisung
eps
Google Pay
iDEAL
Klarna
Maestro
Payment Page
PayPal
Tools
Error codes
Result codes
Test data
Apple Pay
Bluecode
Credit Card
Direct Debit
Direktüberweisung
eps
Google Pay
iDEAL
Klarna
Maestro
Payment Page
PayPal
Tools
Error codes
Result codes
Test data
This is an old revision of the document!
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 Anpsrechpartners |
personGender | Optional | String | Mögliche Werte: männlich weiblich |
personEmail | Ja | String(255) | E-Mail Adresse des Anpsrechpartners |
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 | Dutchschnittlicher Warenkorbin EUR |
products | Optional | String | Kommaseparierte 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 | Kommaseparierte 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. |
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 |
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 |
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 |
653 | modified Shopsoftware (xtcModified) | 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 Premium |
23 | Paydirekt |
24 | GiroCode Basic |
25 | GiroCode Klassic |
26 | Blue Code |
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 |
---|---|
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 |
9999 | Interner Fehler |