--- title: HaloPSA Payment Button - PDF Invoice description: Learn how to embed dynamic 'Pay Online' buttons directly into your HaloPSA invoice PDF templates using custom HTML mapping from Cloud Depot RPS. --- [Skip to content](https://kb.clouddepot.com/knowledge/halopsa-setup-online-payment-button-in-your-pdf-invoice#main-content) English Show submenu for translations ![CoudDepot\_LOGO\_RGB.png\]](https://kb.clouddepot.com/hs-fs/hubfs/CoudDepot_LOGO_RGB.png?height=40&name=CoudDepot_LOGO_RGB.png) - [Read Our Blog](https://blog.clouddepot.com/) Open main navigation Close main navigation - [Read Our Blog](https://blog.clouddepot.com/) - English Show submenu for translations - [Go to clouddepot.com](https://www.clouddepot.com/) [Go to clouddepot.com](https://www.clouddepot.com/) Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Cloud Depot Knowledge Base](https://kb.clouddepot.com/knowledge?hsLang=en) 2. [Integrations](https://kb.clouddepot.com/knowledge/integrations?hsLang=en) 3. [HaloPSA](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#halopsa) # HaloPSA Payment Button - PDF Invoice ## With Cloud Depot RPS, you can embed dynamic payment buttons or hyperlinks directly into your HaloPSA PDF invoice templates. When a client receives their invoice via email or downloads the PDF, they can click the button to be taken straight to your branded online payment portal. #### Prerequisites Before you begin, ensure that: 1. Cloud Depot RPS (Recurring Payment Service) is fully configured. 2. You have administrative access to your HaloPSA instance. #### ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-May-08-2025-10-54-20-7890-PM.png?width=308&height=431&name=image-png-May-08-2025-10-54-20-7890-PM.png) (Example of a HaloPSA PDF invoice with Pay Online Button) #### Step 1: Copy Your HaloPSA Code Snippet Cloud Depot generates different code variations depending on whether you want a styled button or a text hyperlink. 1. Log into Cloud Depot and navigate to **Recurring Payments \> Configuration \> Customer Portal**. 2. Click on the **HaloPSA Payment Details** tab. ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-03-2026-01-01-00-5837-AM.png?width=421&height=103&name=image-png-Jun-03-2026-01-01-00-5837-AM.png) 3. Choose either the **Hyperlink HTML** or the **Button HTML** option. 4. Copy the entire raw code block and save it to a notepad for later use. ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-03-2026-01-01-47-7124-AM.png?width=628&height=235&name=image-png-Jun-03-2026-01-01-47-7124-AM.png) #### Step 2: Access the PDF Templates in HaloPSA 1. Log into HaloPSA with administrator privileges. 2. Go to **Configuration \> Reporting\> PDF Templates**. ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-03-2026-01-03-11-9909-AM.png?width=337&height=148&name=image-png-Jun-03-2026-01-03-11-9909-AM.png) 3. Locate the template you use for customer billing and click **Edit** (or click *New* to create a dedicated layout for online payments). ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-03-2026-01-03-36-4519-AM.png?width=433&height=235&name=image-png-Jun-03-2026-01-03-36-4519-AM.png) #### Step 3: Insert the Payment Link Code HaloPSA allows you to inject raw HTML directly into specific structural containers on the PDF layout. **Option 1 - Use HTML Footer** This option will add your payment button to each invoice template page and is the simplest setup method. 1. Click **Edit button** then click the **Appearance Tab** 2. Click **Include Footer** and **Use HTML** Footer ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-03-2026-01-07-58-5041-AM.png?width=355&height=204&name=image-png-Jun-03-2026-01-07-58-5041-AM.png) 3. Paste in the code from step 1 item 4 above. ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-03-2026-01-10-52-2151-AM.png?width=306&height=188&name=image-png-Jun-03-2026-01-10-52-2151-AM.png) 4. Set the Footer height to be 50 (this can be adjusted if its too much) 5. Save changes and preview your PDF to see the outcome #### **Option 2 - Amend the HTML code to place the button in the body** This option places the payment button in the body of the invoice (as shown in the example above). Unlike the footer option, the button will not repeat on every page. This method is more technically advanced, but if you are comfortable working with HTML, it provides a more flexible and precise placement. 1. Click **Edit button** then click the **Pages Tab** 2. Select the page you would like to place the button on, in our example the page is called 'Main Page' then click the pencil icon to edit ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-03-2026-01-18-50-5478-AM.png?width=389&height=139&name=image-png-Jun-03-2026-01-18-50-5478-AM.png) 3. Important: Before making any changes, copy all of the HTML and save it to a text file as a backup. If you make a mistake, you can easily roll back to the original version. 4. Scroll through the HTML until you locate the `$INVOICETOTAL` tag. This is where the customer sees the total amount due and is the most logical position to insert the Pay Online button. ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-03-2026-01-22-03-1112-AM.png?width=308&height=254&name=image-png-Jun-03-2026-01-22-03-1112-AM.png) 5. Under the last \ tag under \. Paste in the code from step 1 item 4 above. ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-03-2026-01-25-01-7405-AM.png?width=378&height=186&name=image-png-Jun-03-2026-01-25-01-7405-AM.png) 6. Scroll to the bottom and save changes. 7. Preview your PDF template and make any necessary changes.   - [Product - Autotask to Xero](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#main-content) - [Getting Started](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#getting-started) - [Setup](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#setup) - [Troubleshooting](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#troubleshooting) - [Product - Recurring Payment Service (RPS)](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#main-content) - [Getting Started](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#getting-started) - [Customers & Invoices](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#customers-invoices) - [Payment Rules & Auto Pay](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#payment-rules-auto-pay) - [Customer Portal](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#customer-portal) - [Surcharges](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#surcharges) - [Payment Gateways](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#payment-gateways) - [Troubleshooting](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#troubleshooting) - [Product - HostedPay](https://kb.clouddepot.com/knowledge/product-hostedpay?hsLang=en) - [Integrations](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#main-content) - [Xero](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#xero) - [Autotask](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#autotask) - [HaloPSA](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#halopsa) - [Support, security & updates](https://kb.clouddepot.com/knowledge/support-security-updates?hsLang=en) - [Billing and Accounting](https://kb.clouddepot.com/knowledge/billing-and-accounting?hsLang=en) - [Setting up Cloud Depot](https://kb.clouddepot.com/knowledge/setting-up-cloud-depot?hsLang=en) - [Cloud Depot Status and Contacting Support](https://kb.clouddepot.com/knowledge/cloud-depot-status-and-contacting-support?hsLang=en#main-content) - [View Service Status](https://kb.clouddepot.com/knowledge/cloud-depot-status-and-contacting-support?hsLang=en#view-service-status) - [Support](https://kb.clouddepot.com/knowledge/cloud-depot-status-and-contacting-support?hsLang=en#support) - [Sync Customization Documentation](https://kb.clouddepot.com/knowledge/sync-customization-documentation?hsLang=en) - [Read Our Blog](https://blog.clouddepot.com/) # Cloud Depot Cloud Depot Help Center Copyright © 2026, Cloud Depot