1.2.8. Templates management¶
1.2.8.1. 1. What are Taler templates?¶
Taler templates allow merchants to create pre-defined orders that customers can pay using the GNU Taler wallet. This is especially useful for businesses without internet access or websites that want to accept payments on static pages, like for donations.
A template sets fixed order details that customers cannot change. However, merchants can allow customers to enter specific information, such as the amount to be paid or a message (order summary).
1.2.8.1.1. How it works¶
The customer scans a QR code or clicks a taler:// link, which contains a payment template.
The wallet may ask the customer to enter missing details (if allowed).
The wallet creates the order and fetches the contract details.
The customer reviews and completes the payment.
If the customer cancels, they can modify the details and try again (if allowed).
If all details are fixed, the order is created, and payment proceeds immediately.
1.2.8.1.2. Merchant setup¶
Merchants create templates via the Taler Backoffice or API.
Each template gets a unique template ID (URL-encoded).
Merchants can generate a QR code and payment link to share with customers.
Webhooks or OTPs can be used for payment confirmation, especially for stores without an internet or mobile access.
1.2.8.1.3. Benefits¶
Quick and easy cashless payments.
Works without internet at the store.
Supports static websites for simple online payments.
Customers only need to scan, enter details (if needed), and pay.
1.2.8.2. 2. Templates overview¶
To view all templates, navigate to the Templates page in the sidebar. Here, you can see a list of all templates with details like the ID and description.
Near each template, you’ll find options:
Use template: Modify the template if “Amount” and “Summary” fields are not locked.
QR: Generate a QR code and payment link for easy access. Also allows printing.
Delete: Remove the template.
1.2.8.3. 3. Adding a template¶
To create a new template, click the “+” button in the top-right corner of the template page. A form will appear where you need to provide the following details:
Identifier (required, URL friendly): A unique name for the template.
Description (required): A short description explaining the template’s purpose.
Summary: Allows customers to modify the summary.
Summary is editable: If enabled, the customer can modify the summary.
Amount (required): Template will create orders with the same price.
Amount is editable: Allows customers to modify the amount.
Minimum age: Specifies the minimum required age for the payment.
Payment timeout: Defines how long the customer has to complete the payment.
OTP device: Used to verify transactions in offline mode. OTP devices tutorial.
Once you are done, click on the “Confirm” button to add the template.
1.2.8.4. 4. Editing a template¶
To edit an existing template:
Click on the template you wish to modify.
Update the fields as needed.
Click “Confirm” to save changes.
1.2.8.5. 5. Deleting a template¶
To delete a template, click on the “Delete” button next to the template you want to remove. Confirm the deletion in the dialog that appears by clicking on the “Delete template” button.
Warning
This action is irreversible.