====== Report a new merchant ====== This function allows the reporting of a new merchant to GiroSolution AG. ==== Request ==== **URL:** <>/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 |[[#List_of_organization_types|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_list|Branch Id]]| |merchantShopsystem |Optional |Integer |[[#shopsystem_list|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|List of payment methods]])\\ Example for giropay, direct debit with locking file and credit card:\\ 1,11,7 | |giropaypsp |Optional |Integer |[[#list_of_psps|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 | === Example === 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 ==== Response ==== A JSON object is returned as response.\\ In case of error, rc contains one of these [[#list_of_error_codes|error codes]].\\ In case of success, rc = 0 and the field merchantId is set. === Example with Success === { "merchantId":"12345678", "rc":"0", "msg":"", } === Example with Error === { "merchantId":"", "rc":"5000", "msg":"", } ====== Appendices ====== ==== List of organization types ==== ^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 | ==== Branch List ==== ^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 - | ==== Shopsystem List ==== ^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 | ==== List of payment methods ==== ^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 | ==== List of PSPs ==== ^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 | ==== List of error codes ==== ^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 |