Integration
Credit Card
Direct Debit
Bluecode
eps
giropay
iDEAL
Maestro
PayPal
Payment Page
Tools
Error codes
Result codes
Test data
This function allows the reporting of a new merchant to GiroSolution AG.
URL: «SERVER»/girocheckout/api/v2/reseller/addmerchant
Name | Mandatory | Type | Description |
---|---|---|---|
affiliateId | Yes | Integer | Affiliate-ID from your access data |
merchantEmail | Yes | String(254) | Unique E-Mail Address |
merchantLanguage | Optional | String(2) | Language for the user interface de = German (default) en = English |
merchantCompanyType | Optional | Integer | Organization type ID |
merchantOrganisationName | Yes | String(128) | Company name |
merchantAddress1 | Yes | String(128) | Street and number |
merchantAddress2 | Optional | String(128) | Additional address info |
merchantPostcode | Yes | String(128) | Postal code |
merchantCity | Yes | String(128) | City |
merchantCountry | Optional | String(2) | Country code ISO 3166 DE = Germany (default) |
merchantUrl | Optional | String(250) | Company Homepage |
merchantUstId | Optional | String(14) | VAT-ID with country code |
merchantTaxNumber | Optional | String(20) | Tax Number |
merchantRegisterNumber | Optional | String(100) | Registry number (e.g. commercial register) |
merchantBranche | Optional | Integer | Branch Id |
merchantShopsystem | Optional | Integer | Shopsystem Id |
personFirstname | Yes | String(255) | First name of the contact person |
personLastname | Yes | String(255) | Last name of the contact person |
personGender | Optional | String | Gender, possible values: männlich (male) weiblich (female) |
personEmail | Yes | String(255) | E-Mail Address of the contact person |
personPhone1 | Optional | String(32) | Phone number of the contact person |
personPhone2 | Optional | String(32) | Additional phone number of the contact person |
forecastTxMonth | Optional | Integer | Forecast: Number of transactions per month |
forecastTxAverage | Optional | Integer | Forecast: Average shopping cart in EUR |
products | Optional | String | Comma separated list of the desired products (see List of payment methods) Example for giropay, direct debit with locking file and credit card: 1,11,7 |
giropaypsp | Optional | Integer | PSP ID |
salesTag | Optional | String(255) | ID of sales partner |
ccTypes | Optional | String | Comma separated list of the desired credit card types. Possible values: V = Visa M = Mastercard A = Amex Example for Visa and Mastercard: V,M |
subId | Optional | String(50) | ID of a sales partner that the new merchant is to be assigned to. These IDs are defined by GiroSolution AG and are only to be used with permission. |
hash | Yes | String(32) | HMAC-MD5 check sum |
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
A JSON object is returned as response.
In case of error, rc contains one of these error codes.
In case of success, rc = 0 and the field merchantId is set.
{ "merchantId":"12345678", "rc":"0", "msg":"", }
{ "merchantId":"", "rc":"5000", "msg":"", }
ID | Organization type |
---|---|
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 | Others |
ID | Branch |
---|---|
1 | Antiques & Art |
2 | Audio & Hi-Fi |
3 | Car & Motorcycle |
4 | Baby |
5 | Beauty & Health |
6 | Books |
7 | Office supplies & Stationery |
8 | Business & Industry |
10 | Gourmets |
11 | Movies & DVDs |
12 | Photographic & Camera equipment |
13 | Garden |
14 | Mobile phone & Organizers |
15 | Household appliances |
16 | Handymen |
17 | Real Estate |
18 | Clothing & Accessories |
19 | Lottery & Bets |
20 | Furniture & Living |
21 | Modelling |
22 | Coins |
24 | Music |
25 | Musical instruments |
26 | Online games |
27 | PC- & Video games |
28 | Prepaid |
29 | Software |
30 | Toys |
31 | Sports |
32 | Tickets |
33 | Animals |
34 | TV, Video & Electronics |
35 | Watches & Jewelry |
36 | Vacation & Travel |
37 | - Others - |
ID | Shopsystem | Supported? |
---|---|---|
8363 | 1&1 E-Shop | No |
8364 | 004 Shop-System | No |
80284 | Afterbuy | Yes |
8365 | Awinta | Yes |
8366 | Bigware | No |
8367 | Continue (FUTURE web market) | No |
8368 | DataBecker (shop to date) | No |
606 | Drupal / Ubercart | Yes |
9154 | DR-WebShop | Yes |
8369 | e.pages | No |
8370 | ESHOP2 PRO (econdoo) | No |
651 | Gambio | Yes |
8371 | GlobeCharge | No |
8372 | Hybris | No |
8373 | JTL Shop | Yes |
650 | Magento | Yes |
8374 | Mallux | No |
8375 | Mauve Mailorder Software | No |
653 | modified Shopsoftware (xtcModified) | Yes |
8376 | Mondo Shop | No |
4730 | OpenCart | Yes |
655 | osCommerce 2 | Yes |
648 | OXID eSales | Yes |
8377 | plentymarkets | No |
658 | PrestaShop | Yes |
5940 | SEOshop | Yes |
8378 | ShopFactory | No |
649 | Shopware 3 | Yes |
6445 | Shopware 4 | Yes |
8379 | Shopodia | No |
8716 | Sonstiges | Yes |
8380 | store systems | No |
8381 | Strato-Shop | No |
8382 | SchulverpflegungPlus | Yes |
654 | VirtueMart (Joomla) | Yes |
8383 | Websale | No |
10771 | WooCommerce (Wordpress) | Yes |
656 | xtCommerce 3 | Yes |
657 | xtCommerce 4 / Veyton | Yes |
8384 | Zen Shop | No |
2032 | Own development | Yes |
8386 | GiroSpende | Yes |
ID | Payment method |
---|---|
1 | giropay |
2 | EPS |
4 | Käufersiegel |
6 | Lastschrift (direct debit) |
7 | Lastschrift mit Sperrdatei (direct debit with lock file) |
8 | Garantierte Lastschrift (guaranteed direct debit) |
11 | Credit card |
12 | iDEAL |
14 | PayPal |
16 | giropay-ID |
17 | giropay-ID + giropay |
18 | giropay mit Zahlungsbestätigung (giropay with payment confirmation) |
19 | giropay Spende (giropay donation) |
20 | GiroCode RE |
23 | Paydirekt |
24 | GiroCode QR |
25 | GiroCode ÜW |
26 | Blue Code |
32 | Payment Page |
33 | Maestro |
ID | Description |
---|---|
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 | Others |
3241 | TeleCash |
2330 | VöB ZVD |
ID | Description |
---|---|
0 | OK |
5000 | Authentication failed |
5001 | No permission |
5002 | invalid hash |
5003 | At least one mandatory field not given |
5009 | Invalid E-Mail Address |
5010 | Invalid language |
5011 | Invalid country |
5012 | Invalid branch |
5013 | Invalid shop system |
5014 | Invalid gender |
5015 | Invalid product |
5016 | Invalid organization type |
5017 | Merchant already exists |
5018 | Invalid giropay PSP |
5019 | Invalid Credit card type |
9999 | Internal error |