This article describes an advanced method for configuring your touchpoint solution. Using the configuration options provided by the user interface in Hub is easier and will fit most use cases.
You can use URL parameters described below to alter the configuration of a touchpoint solution you have set up in Hub. The functionality is only available for PayLinks, not for QR codes.
Example usage:
https://pay.raisenow.io/rvbks?amount.default=10&supporter.email.value=example@test.com
For all fields, values of “null” and “undefined” are ignored, but empty values are interpreted.
Amounts
Predefined amounts
amount.values=5.2,11
This overrides the predefined amounts, in the above example to 5.20 and 11. Pass an empty value to remove all predefined amounts configured in the solution.
Custom amount
amount.custom=true
This overrides the setting whether your supporters can specify their own, custom amount. “0“ and “false“ are interpreted as false, all other values (including empty) as true.
The custom-amount field is always shown if the amount section would otherwise be empty.
Default amount
amount.default=10
This overrides the setting of which amount is selected by default. If the default amount is not predefined, it is filled as custom amount. If also the custom-amount field is not shown, the amount is added to the list of predefined amounts, and the list of predefined amounts is sorted.
Supporter fields
You can override which fields are shown, and you can prefill the contents of a field.
supporter.{field name}.show=true&supporter.{field name}.value=RaiseNow
In case you prefill a field that is not shown, the prefilled value will still be stored with the payment. The supporter will see the values on the confirmation page, as well as in e-mails. If you prefill such a hidden field with invalid data, then the payment will fail.
Field name |
Field limitations |
---|---|
salutation | Expects one of: mx, mr, ms, other, family, none |
first_name | |
last_name | |
Must be a valid e-mail address | |
street | |
house_number | |
address_addendum | |
postal_code | |
city | |
country | Expects an ISO-3166-1 alpha-2 code |
References
You can set the following references. They have no influence on the supporter’s experience, but will be added to the payment for your reference.
reference.campaign_id
reference.campaign_subid
reference.creditor
reference.qr
Comments
0 comments
Please sign in to leave a comment.