Skip to main content
All CollectionsIntegrationsTyro Health OnlineDigital Card Payments
Inserting Pre-Payment Links In Appointment Reminders
Inserting Pre-Payment Links In Appointment Reminders
Updated over 6 months ago

This feature requires the Tyro Health Online Integration. Please ensure you have set up the Tyro Health Online integration if you want to use this feature.

Table of Contents

Overview

The <<PaymentLink>> merge tag for email and SMS templates is designed for clinics that request prepayment for appointments in their confirmation and reminder messages.

This feature automatically creates an invoice using the appointment's default item code at the time appointment confirmations and reminders are sent. A payment link for this invoice is created using the Tyro Health Online integration and will be inserted into your message.

It is not possible to use the <<PaymentLink>> merge tag to send a link for an existing invoice. Click here to learn how to create a payment link for an existing invoice.

Enabling Payment Links

To enable this feature, go to Settings > Integrations > Tyro Health Online.

Using Payment Links Without a Provider Number

Tyro Health Online requires provider numbers to match with PracSuite for the payments feature to work correctly. To ensure this feature works for all practitioners regardless of provider numbers, we strongly encourage adding your Unique Location ID to PracSuite. This will be used as a fallback if provider numbers can't be matched and will allow your patient to continue with the payment process without error.

Your Unique Identification Number can be found in the Locations tab in Tyro Health Online. After selecting the relevant location for the practitioner without a provider number, select the Claiming tab and find the Unique Identification Number as shown below.

After copying this number, within PracSuite go to Settings > Integrations > Tyro Health Online and scroll down to the Tyro Health Online Payment Overrides grid.

After selecting Add, select the business and add the respective Unique Identification Number.

Click Save to finalise your changes.

Valid Payment Scenarios

It is not possible to use the <<PaymentLink>> merge tag to send a link for an existing invoice. Click here to learn how to create a payment link for an existing invoice.

This feature is supported when sending SMS and emails with the <<PaymentLink>> tag in the following scenarios:

In a valid scenario, PracSuite will automatically raise an invoice for an appointment using the default item code preferences relevant to the appointment type. Note that payment links expire 30 days after they're created.

Choose the text that you wish to display in front of the payment link in valid scenarios:


Invalid Payment Scenarios and Troubleshooting

If payment links are not being generated with your SMS or Email, despite the <<PaymentLink>> tag appearing on your template, please confirm the following:

  1. Have you enabled and configured Tyro payment links correctly?
    Ensure you have enabled payment links correctly as above, entering your 'Unique ID Number' for each location.

  2. Are you sending the SMS/Email from the correct place?
    Payment links will only be generated when sending from an appointment or via the online booking process.

  3. Does the patient file contain both an email address and mobile number?
    Tyro requires both an email address and mobile number to proceed with an online payment.

  4. Is an invoice already linked to the appointment?

    Payment links can only be generated if an invoice is not already linked to the appointment.

  5. Is the appointment booked on a patient account where third-party billing is enabled?
    Payment links can only be generated for individuals. If the patient account is linked to a third-party payer the payment link will not be generated.

  6. Have you applied Fee Category restrictions in your payment link settings?
    In the Integrations > Tyro Health Online settings there are options to restrict payment links to specific Fee Categories (see below). If this has been enabled, please confirm the patient is assigned to an appropriate Fee Category.

  7. Is there a valid Fee within the the appointment?
    The fee within the appointment must not be $0.00, otherwise a payment link cannot be generated.

If a payment link cannot be created due to an invalid scenario (above), the following option determines whether the ​<<PaymentLink>> tag should return blank or alternate text.


We recommend setting this to Return Blank for invalid scenarios. This way, if an invalid scenario does occur, nothing regarding the payment will be inserted into the message and confuse the patient.

If you prefer to display more direct text in the event of an invalid payment scenario, then you can select Use Alternate Text.


Fee Category Restrictions

Fee Category restrictions can be enabled to ensure that payment links aren't generated inappropriately. This will prevent payment links from being generated for e.g. third-party billing scenarios. If PracSuite attempts to generate a message with a payment link for any Fee Categories other than those listed, the invalid payment text will be inserted into the message.


Adding the <<PaymentLink>> Merge Tag to Templates

After completing the above configuration, you're now ready to modify the SMS and/or email templates that need to include the <<PaymentLink>> merge tag.

In place of the <<PaymentLink>> tag will be the 'valid text' you entered earlier, followed by the payment link. In the event of an invalid scenario, the payment link tag will be left blank, or your chosen invalid text will be inserted. To minimise confusion, our recommendation is to Return Blank in the event of an invalid scenario.


Review Your Appointment Confirmation and Reminder Settings

After completing the above configuration, review the templates you have selected for the following, ensuring you select templates containing the <<PaymentLink>> merge tag where appropriate.


Testing Your Payment Link Template

To test your template, book an appointment using your testing patient file.

After selecting your preferred appointment type, pay attention to the default item code and fee. An invoice will be raised with this item code, and this will be fee the patient will be asked to pay when they click the payment link.

After reviewing the item and fee, use the phone or email icons to generate a new message from the Appointment Details screen.

Note that payment links will be generated after clicking the send button.


What does the patient see when visiting a payment link?

When patients click the payment link, they will be presented with the following screen in their web browser. The patient must enter their card details and approve the payment.

It's possible to require patients to save their card details. Click here to learn more about how to enable this option via your Tyro Online settings.

Did this answer your question?