Skip to main content

Square Payment Links - Knowledgebase / SalesPad / Extended Modules - Cavallo Technical Support

Square Payment Links

Authors list

Overview

Square payment link functionality has been added to SalesPad as of version 5.4.14. This allows users to generate and send Square payment links to customers for their sales orders. The customer can complete their purchase by following the payment link to a Square checkout page, where they can enter their payment information into Square’s secure webpage. Once their checkout steps are completed, the payment information is retrieved by SalesPad and used to create a corresponding payment for that sales order.

Review the Get Started with Square Payment Links guide for more information.

Configuration

This guide is for configuring Square payment links. Please review the Square Integration documentation for general Square configuration in SalesPad.

Security Editor

Sales Document Payments

Open the Security Editor in SalesPad and filter to “sales document payments”. Set the Allow Payment Links sub-security to true and save all changes. Log off and back into SalesPad for the changes to take effect.

h4TVp8grDf4g-1wgRGxpIhIkxBKcidmYsMAfjfq43t1NTix0IfnzQHHJjbRNPCPnHxOlAFudI_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oi-svvnsiaxhu-a75b5b8c2e204e53cb57fe6bc9f6fe7a31d5c91a

Sales Document Entry Plugins

Open the Security Editor and filter to “payment link” to review securities for the following Sales Document Entry plugins:

  • Square Create Payment Link

  • Square Retrieve Payment Link

  • Square Cancel Payment Link

  • Square Move Payment Link To History

f7zxNqYAWg4G4K_D6RgVT9J7YovqtA1L4LzZuJqU5dAgh3QJONoNND5GHGM5v3wospplCwJyo_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3og-cdfmzdwbot-7d688ebd708d1017b7f2a6d7f0c4736e7468ba64

These plugins can be configured to run automatically in workflow, so each plugin also has a Failed Transaction Queue sub-security. Documents that fail plugin processing when forwarding through workflow will be moved to this queue for review.

The Square Move Payment Link To History plugin has a Can Move Links Awaiting Payment sub-security. When enabled, payment links can be moved to history even if they are still awaiting payment.

Make sure the desired plugins are enabled, save your changes, and log off and back into SalesPad for the changes to take effect.

Settings

Open Settings in SalesPad and filter to “Square payment link” to review payment link settings:

MD2hXJ5TAWye3X7HO6jydO9SVJ_b-3C9fWeO_tzMCq7YXvdRwZcoijSUCDBDZ0qZn-Ds9l6AK_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oj-wafukwhqlu-05141d6208ec6c23948e039e7d7b4ceccb7dee96

Allow Apple Pay - Indicates whether Apple Pay is accepted at checkout. Defaults to false.

Allow Google Pay - Indicates whether Google Pay is accepted at checkout. Defaults to false.

Default Cash Receipt Batch ID - Default Batch ID to be used when creating a cash receipt through the Square payment link.

Default Currency ISO Code - Default ISO Code sent if the document currency is not found. Defaults to USD.

Link Name Format - Format of the link name that will be displayed to the end-user. Defaults to ({Sales_Doc_Type}) {Sales_Doc_Num}.

Order Credit Card Payment Type - The payment type to use for payment link credit card payments for sales orders. Defaults to Credit Card Payment.

Square Authorization

Square payment links require ORDERS_READ and ORDERS_WRITE permissions. It may be necessary to grant access by requesting a new access token in the application settings. If these permissions are not granted, an insufficient permissions error message will appear:

M7f0Koua4CuV7oebL5TAlpyDM1MJt6kGPkjSAa8hQnq2YwKqDzYFhBfzOpxGiPsfR9T2MRDCi_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oc-thcumyvifi-2ecdd4e615a34c61ce6ef8c12f5e44a80ccf36c8

Sending Payment Links

Square currently does not handle automatic emailing of payment links. SalesPad must be configured to send Square payment links using the Email Template Editor and Smart Printing Maintenance.

Email Template Editor

Open the Email Template Editor screen in SalesPad and create a new sales document email template or select an existing sales document email template.

Click the Insert Sales Document Merge Field dropdown button, select the Square Payment Link option, and select the Link_URL or Link_Long_URL field to add to the template.

A0pz_KTkdLkpN_mcTyjF3J4C37rsYDI8nBnTtWZW1geCpwdZ6gBt9hZgo3VEH0ESvrNCtQzT6_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3ob-hzkpmyehjh-85936275f6ec2a4115476407a3a57583171b44b3

Once the field has been added, it will appear in the template:

nNETHS3v1homz1tEaT2dGupzgrB3ANbdJ31GoTEmPdJxbDrysgHEAzTzCNb9vloHh7rZicMVd_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3of-gcsargyade-dc881c5d54f36eb229a69a6133a6e37ad39c0c64

Save all changes and close the Email Template Editor.

Smart Printing Maintenance

Open the Smart Printing Maintenance screen in SalesPad and create a new configuration or modify an existing configuration. In the Email Template dropdown, select the email template that was configured in the previous step. Save all changes and close Smart Printing Maintenance.

GDg29jQrlS9W0d6MxQAlBgTJSCyVNCB7SRuaEiMFIVe7gQDWyCbv7JQenKq1dpLtaa03MXpN0_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oi-dzrdldpauh-d3165d3ebf6bac5a4f57085fb6694d76d20d5197

Processing Payment Links

Payment Entry Link Creation and Retrieval

In Sales Document Entry, open the Payments window by clicking the Accept Payment button. Switch to the Square tab if needed, then click the Create Payment Link button to create a new payment link for this sales document.

0db6ADw9PkzWRQ-lri2icgP6RhX76u6jmiTI5LFa_c-QfkCyV2UUXyR1zDHAQm8oHo2dE-UDB_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3of-chtliikuyq-6ca455ee8f37c709e97e899d4fcc5cc859f7b918

NOTE: Only one payment link can be created for a sales document at a time.

A prompt will request the amount for the payment link:

thuqgLtaeYcbxl4llD0gnJD1T-24OBn5zTOQLF209RR7-gioSIzNi5BYLGbbPnblwBluzavZp_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oe-vaoagugfdu-689d36edea6a024fd63bf7ad28caf57f9eff822c

Enter the desired amount and click OK to create the link.

Click the Retrieve Payment Link button to retrieve the payment information associated with the payment link.

lUoc4ie06x8DIDF55cOQgBY6_zucKffIxj5Z55hGgeAL34NofJMY0X8KqwrwP72jjv7pwCbeK_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oh-ifrbsvigdt-19b08a0d823dd8fd16bdebf50def49ac23fa9067

NOTE: Payment links that are still awaiting payment cannot be retrieved.

Once the payment link is retrieved successfully, the payment will be automatically applied to the sales document, and the payment link information will be sent to history.

lXo_KCe3h7seYcm59qowwuMrho5Cg10gBpHzScjIkedvju8zOq4ACtePGB91WcMrahLliO-LN_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oe-yivpnwkznq-a33abe2736cda0770a155148600123d11c377801

Sales Document Entry Plugins

Create Payment Link

The Square Create Payment Link plugin creates a new payment link for the sales document. Simply select the Square Create Payment Link plugin in Sales Document Entry. SalesPad will display a notification for whether the payment link creation was successful.

w3ZKuLlA2LWMtT7_6Pe2GJYhcR2gKYm6Rd543hFFewdL9rb16YGZH8YGMj4XrMdE3ci8jcJiW_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oe-uasozlqjjg-dc03fe48c89f7a5ab06f342548d98ad96bf90f0c

Retrieve Payment Link

The Square Retrieve Payment Link plugin retrieves the payment link information for the sales document from Square, which will update the sales document with payment information if the payment link has been paid. To manually retrieve an existing sales document payment link, select the Square Retrieve Payment Link plugin in Sales Document Entry. SalesPad will display a notification for whether the payment link retrieval was successful.

PQFtAlKTttcamJVkeAtlqR0QLM_NiDrNvBuFZOT87PhVcg2liHC3bckr-0hBRtv2PGP3nB5qm_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oi-lmlkbcfzej-39ef32c8f539a5398b97579570827141f9d39bd2

Note: Payment links that are still pending will notify that they are awaiting payment.

rBPWtLhARBz78nSARRLZ4oF5MQXXQaQ8uyXztcec1hVF69xZEHgQCZ5ezQ4OR7OluB1RF3JJ_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oi-admdwdslra-02d3f149837d3b6210ceba7fe93d4671a209f1e6

Cancel Payment Link

The Square Cancel Payment Link plugin cancels the existing payment link for the sales document. Simply select the Square Cancel Payment Link plugin in Sales Document Entry. SalesPad will display a notification for whether the payment link cancellation was successful.

xYocGMMc45N08pX09d8z_Gu5N_bXsto_x-AFRR9S2TwgnMBWIxbKanGlEwRSC3Pj9Mc8m90Kw_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oh-kaphgeozyi-327772e685052aad64503922c777e40e1bad5d89

Move Payment Link To History

The Square Move Payment Link To History plugin manually moves payment link information from the open spSquareSalesDocumentPaymentLink table to the historical spSquareSalesDocumentPaymentLinkHistory table and sets the status as Completed.

Simply select the Square Move Payment Link To History plugin in Sales Document Entry. SalesPad will display a notification for whether the payment link update was successful.

VgBbh7irlF3W7ye51lB1P_6QeodVDwBpFHsYmtDUoP5kjVNxeWV5FNYW4vDKj_1lA1N3dxeUU_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3of-lyyrlekwrn-5019cb3406b1548ce196cebd0530068a9893713a

IMPORTANT: Upon successful completion, the Square Retrieve Payment Link and Square Cancel Payment Link plugins will automatically move the payment link to history with the Completed or Canceled status respectively. There is no need to use this plugin unless you cannot complete or cancel an existing payment link and need to create a new one.

Square Checkout

When a customer follows the payment link, they will be greeted with a Square checkout page:

YSZqeHMOilwzfrN7-9bbyvovOlLMj_hpPmfAgvXML0FFC5_wwtJ7pWopSI6y5l8qxXB05vMKx_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3ok-zqiqgyzufp-68db8b763c8860b349f2f1b1fa20661033fd2824

This displays the total amount due for the sales document, and it provides checkout fields for the customer to fill out. Once the customer completes the payment, the payment link information can be retrieved in SalesPad.

Workflow

The Square payment link plugins can also be triggered automatically in the sales document workflow. Open the Sales Document Workflow Setup screen in SalesPad and select the document type and ID. For the queue where the action should be triggered, select the desired Square payment link plugin from the Plugin dropdown menu. Make sure to save all changes.

4WPyjKDWHtJtdeQlLDHGCjUFd4fy80tImrcKJluWXx7pTVnVNR-1e0yQdZtgIWRMoCkuVqpJa_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3ol-nzjkudrfzf-6feddc0f243c6048db9f873d5e39ff2a3533f5a3

Automation Agent

Automation Agent has a Square Payment Link job that can be configured to retrieve payment link information from Square automatically on a set schedule.

Open the Automation Lookup screen (requires the Automation Agent DLL) in SalesPad and click the New Automation button. Select the Square Payment Link platform and click OK to create the job.

AuLBqSWDnavTEqd4LaOIWFZn3IMd8aZPhnRQwD3T5YilfOFCI0U60Gqki242tYSp7moVJB59g_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3oi-bnuepilpoo-b9eab6dac237f2d0415c8784fc96bbcbf441a6c3

The following settings can be configured for the Square Payment Link job:

KMWHwjMsR6Ag3xdadwhc7vX8R8N9T9liC3ZaHFE3PMetK8bJcO5byf3nknYhJRILVrTZmshht_key_yQi1ADQe1AgntrMy1-F-dg.png?access_token=snx3ok-jkdpjskjpa-8aa5d67c0aea943ac172e156eb445dd711a9a5e4

Audit Awaiting Payment Message - When enabled, the awaiting payment message will be logged to the sales document audit log. Do not enable this setting if the payment link job is running frequently to avoid unnecessary sales document audit entries. Defaults to false.

Batches - Semicolon-delimited list of sales document batches that this task will process. Leave blank to not process open sales documents.

Payment Wait Duration - Duration in days until payment links still awaiting payment are logged to the Action Center. Set to -1 for an unlimited number of days. Defaults to 30 days.

Process Historical Invoices - When enabled, historical invoices with payment links will be processed. Defaults to false.

Send To Batch On Fail - Name of the batch to move open sales documents into when the payment link cannot be retrieved. Leave blank to not move failed sales documents.


Note: After payment links are successfully retrieved by the Square Payment Link job, open sales documents will be automatically forwarded through the workflow.

Helpful Unhelpful