Possible Salutations
| Gender "femaile": | Gender "male": |
|---|---|
| frau | herr |
| fräulein | hr |
| fr | hr. |
| fr. | sir |
| miss | mr |
| ms | mr. |
| ms. | signor |
| mrs | sig |
| mrs. | sig. |
| signora | gentleman |
| sig.a | gentiluomo |
| sig.ra | padrone |
| donna | monsieur |
| la signora | m. |
| madame | m |
| mme | |
| mademoiselle | |
| mlle | |
| mle |
Allowed values for the field „legalForm“ in the business to business authorization requests.
| Value for the API | Description / Identifier to be displayed | DEU | CHE |
|---|---|---|---|
| ag / AG | (Aktiengesellschaft) | x | x |
| eg / eG | (eingetragene Genossenschaft) | x | x |
| einzel | Einzelfirma | x | |
| ek / EK | (eingetragener Kaufmann) | x | |
| e_ges | Einfache Gesellschaft | x | |
| ev | e.V. (eingetragener Verein) | x | x |
| freelancer | Freiberufler/Kleingewerbetreibender/Handelsvertreter | x | x |
| gbr | GbR/BGB (Gesellschaft bürgerlichen Rechts) | x | |
| gmbh | GmbH (Gesellschaft mit beschränkter Haftung) | x | x |
| gmbh_ig | GmbH in Gründung | x | |
| gmbh_co_kg | GmbH & Co. KG | x | |
| inv_kk | Investmentgesellschaft für kollektive Kapitalanlagen | x | |
| kgKG | (Kommanditgesellschaft) | x | x |
| kgaa | Kommanditgesellschaft auf Aktien | x | x |
| k_ges | Kollektivgesellschaft | x | |
| ltd | Limited | x | x |
| ltd_co_kg | Limited & Co. KG | x | |
| ohg | OHG (offene Handelsgesellschaft) | x | |
| public_inst | Öffentliche Einrichtung | x | x |
| misc_capital | Sonstige Kapitalgesellschaft | x | x |
| misc | Sonstige Personengesellschaft | x | x |
| foundation | Stiftung | x | x |
| ug | UG (Unternehmensgesellschaft haftungsbeschränkt) | x |
When is the field "registerNumber and "holderName" mandatory?
| API Value | registerNumber | holderName | ||
|---|---|---|---|---|
| --- | DEU | CHE | DEU | CHE |
| ag | x | x | ||
| eg | x | |||
| einzel | x | |||
| ek | x | |||
| e_ges | x | |||
| ev | ||||
| freelancer | x | x | ||
| gbr | x | |||
| gmbh | x | x | ||
| gmbh_ig | ||||
| gmbh_co_kg | x | |||
| inv_kk | ||||
| kg | x | x | ||
| kgaa | x | |||
| k_ges | x | |||
| ltd | ||||
| ltd_co_kg | x | |||
| ohg | x | |||
| public_inst | ||||
| misc_capital | ||||
| misc | ||||
| foundation | x | |||
| ug | x |
Possible Values for the field "error_field" from the BillPay server response.
| Error Field | XML element of the authorization request (XPath) |
|---|---|
| tcaccepted | //data/@tcaccepted |
| address_gender | //data/customer_details/@salutation |
| address_title | //data/customer_details/@title |
| address_firstname | //data/customer_details/@firstName |
| address_lastname | //data/customer_details/@lastName |
| address_street | //data/customer_details/@street |
| address_streetno | //data/customer_details/@streetNo |
| address_zip | //data/customer_details/@zip |
| address_city | //data/customer_details/@city |
| address_phone | //data/customer_details/@phone |
| address_cell | phone//data/customer_details/@cellPhone |
| address_email | //data/customer_details/@email |
| address_birthday | //data/customer_details/@birthday |
| address_country | //data/customer_details/@country |
| shippingaddress_gender | //data/shipping_details/@salutation |
| shippingaddress_title | //data/shipping_details/@title |
| shippingaddress_firstname | //data/shipping_details/@firstName |
| shippingaddress_lastname | //data/shipping_details/@lastName |
| shippingaddress_street | //data/shipping_details/@street |
| shippingaddress_streetno | //data/shipping_details/@streetNo |
| shippingaddress_zip | //data/shipping_details/@zip |
| shippingaddress_city | //data/shipping_details/@city |
| shippingaddress_phone | //data/shipping_details/@phone |
| shippingaddress_cellphone | //data/shipping_details/@cellPhone |
| shippingaddress_country | //data/shipping_details/@country |
| bankaccount_accountholder | //data/bank_account/@accountholder |
| bankaccount_accountnumber | //data/bank_account/@accountnumber |
| bankaccount_sortcode | //data/bank_account/@sortcode |
| raterequest_ratecount | //data/rate_request/@ratecount |
| companydetails_name | //data/company_details/@name |
| companydetails_legalform | //data/company_details/@legalForm |
| companydetails_registernumber | //data/company_details/@registerNumber |
| companydetails_holdername | //data/company_details/@holderName |
| companydetails_taxnumber | //data/company_details/@taxNumber |
Attention: Depending on the implementation, some of the validation errors can be prevented by implementing optimal front-end UI solutions (e.g. dropdown for the "salutation" field)