Parameter
Durch das Ergänzen der URL eines Zahlungsformulars mit Parametern können Standardwerte gesetzt und das Formular auf diese Weise individualisiert werden.
Durch das Ergänzen der URL eines Zahlungsformulars mit Parametern können Standardwerte gesetzt und das Formular auf diese Weise individualisiert werden.
Übersicht über alle Parameter
Die folgende Übersicht zeigt, welche Parameter in den verschiedenen Formularen zur Verfügung stehen.
Globale Parameter
Die folgenden Parameter funktionieren in allen E-Commerce-Tools von zahls.ch:
| Name | Parameter |
|---|---|
| Betrag (Default) | invoice_amount |
| Betrag (Terminal) | amount |
| Währung (Default) | invoice_currency |
| Währung (Terminal) | currency |
| Zweck (Default) | invoice_number |
| Zweck (Terminal) | purpose |
| Anrede | contact_title |
| Vorname | contact_forename |
| Nachname | contact_surname |
| Firma | contact_company |
| Strasse | contact_street |
| PLZ | contact_postcode |
| Ort | contact_place |
| Land | contact_country |
| Telefon | contact_phone |
| contact_email | |
| Inhalt Textfeld | contact_text |
| Inhalt mehrzeiliges Textfeld | contact_textbox |
| Rabattcode | code |
| Referenz | referenceId |
Parameter für das Donation-Tool
Die folgenden Parameter funktionieren nur im Tool "Donation":
| Beschreibung | Parameter |
|---|---|
| Der Betrag von 50 ist vorgeschlagen. Kann vom Spender geändert werden.[Werte: Betrag, Betrag mit Komma (z. B. 10.50)] | donation[preselect_amount] |
| Intervall ist ausgewählt. Kann nicht mehr geändert werden.[Werte: one_time, weekly, monthly, quarterly, annually] | donation[interval] |
| Intervall ist vorgeschlagen. Kann vom Spender noch geändert werden.[Werte: one_time, weekly, monthly, quarterly, annually] | donation[preselect_interval] |
| Spendenzweck ist vorausgewählt. Kann vom Spender noch geändert werden.[Werte: 1,2,3,...] | donation[preselect_purpose] |
| Kampagneneschreibung wird ausgeblendet.[Werte: 0,1] | hide_description |
Beispiele für die Nutzung von URL-Parametern
Die folgenden Beispiele dienen als Veranschaulichung, wie du die URL-Parameter den E-Commerce-Tools von zahls.ch nutzen kannst.
| Link mit URL-Parametern | Funktion |
|---|---|
| https://[instanz].zahls.ch/de-CH/vpos?amount=19.50 | Beim Aufrufen des Terminals wird der Betrag von 19.50 vordefiniert. |
| https://[instanz].zahls.ch/de-CH/vpos?amount=19.50&purpose=Testbestellung | Beim Aufrufen des Terminals werden der Betrag von 19.50 und der Zahlungszweck "Testbestellung" vordefiniert. |
| https://[instanz].zahls.ch/de-CH/pay?tid=fbd71f97&contact_title=Herr&contact_forename=Peter&contact_surname=Muster | Beim Aufrufen der Verkaufsseite werden die Felder "Anrede", "Vorname" und "Name" automatisch mit den Werten "Herr", "Peter" und "Muster" befüllt. |
| https://[instanz].zahls.ch/de-CH/pay?cid=74eb3a66&donation[preselect_amount]=50 | Beim Aufrufen der Spendenseite wird der Betrag von 50.00 automatisch ausgewählt, kann vom Spender aber noch geändert werden. |