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 |