Q360 Payments: External Payment Links, Token Settings, Surcharges, and Payment Processing
This article explains how to configure payment token attempt limits, set up surcharges, manage saved payment accounts, process payments and refunds, and use reporting tools for payment visibility in Q360. The below actions assume you are already registered as a merchant with the payment processor and that support has already set up your Payment Processor Configuration.
Configurations
Auto Create Payment Token on Record Creation:
- Navigate to Maintenance > API Configuration > Payment Processor > Settings tab. The Payment Processor form will open and display several options (including Token Payment Attempts) above the Company and Branch sub tabs.
- Place the form in Edit mode.
- Select ON from the drop down menu in the Auto Create Payment Token on Record Creation field.
- Click Save.
- Upon creation of an Invoice, an external payment link will automatically be generated.
Configure Default Token Expiry Days:
- Navigate to Maintenance > API Configuration > Payment Processor > Settings tab. The Payment Processor form will open and display several options (including Token Payment Attempts) above the Company and Branch sub tabs.
- Place the form in Edit mode.
- Enter an integer value representing the number of days a payment link will remain valid for use by the cardholder before the link needs to be refreshed (see Refresh instruction below).
- Click Save.
- Setting will apply to all created Invoices.
Configure token payment attempts:
External payment links may expire if the maximum number of payment attempts is exceeded. When this occurs, the link must be refreshed on the Invoice record.
- Navigate to Maintenance > API Configuration > Payment Processor > Settings tab. The Payment Processor form will open and display several options (including Token Payment Attempts) above the Company and Branch sub tabs.
- Place the form in Edit mode.
- Enter the desired value in the Token Payment Attempts field.
- Click Save.
Billing Address Verification Level:
- Navigate to Maintenance > API Configuration > Payment Processor > Settings tab. The Payment Processor form will open and display several options (including Token Payment Attempts) above the Company and Branch sub tabs.
- Place the form in Edit mode.
- Select Verification level from the drop down menu in the Billing Address Verification Level field. Options are None, Low, Medium, High.
- Click Save.
| Verification Level | Failure Code | Definition |
|---|---|---|
| Low | 45 | Address Verification Failed |
| Low | 55 | Account Holder Name, billing address, and postal code are all incorrect |
| Medium | 44 | Address verification has failed |
| Medium | 46 | Provided street address does not match the information on file with the cardholder’s bank, but 5-digit ZIP code matches |
| Medium | 47 | Provided street address does not match the information on file with the cardholder’s bank, but 9-digit ZIP code matches |
| Medium | 4A | Street address or ZIP code provided does not match the information on file with the cardholder’s bank |
| High | 53 | Provided account holder name does not match the information on file with the cardholder’s bank, but billing postal code matches |
| High | 5C | Provided account holder name does not match the information on file with the cardholder’s bank, but billing address matches |
| High | 5F | Provided account holder name does not match the information on file with the cardholder’s bank, but both billing address and postal code match |
Set Up Payment Surcharging
Surcharge settings are configured at the company level. Final surcharge amounts applied during processing will automatically comply with applicable state and local regulations.
To configure surcharges:
- Open the Company record (search Main Toolbar for “Company” or Navigate to Accounting > Admin > Company Setup) and go to Asset tab.
- Place the form in Edit mode.
- Complete the following fields as needed:
- Credit Card Clearing Account (required)
- Credit Card Surcharge Percent (optional).
- Credit Card Fee Account (optional) – we recommend using a GL Account of type Expense
- ACH Surcharge Fee (optional) (requires both Credit Card Fee Account and ACH Fee Account)
- ACH Fee Account (optional) (may be the same as Credit Card Fee Account) – we recommend using a GL Account of type Expense
- Click Save.
Note:
- Surcharge and other fee limits may be impacted by state / locality laws.
- Individual Invoices may be flagged “Payment Fee Exempt.” This action will override any fees or surcharges configured.
- For additional information regarding surcharging (and example), see Q360 Payments and FAQs
Save a Payment Account On File
Payment accounts can be stored on the Customer record for reuse.
Edit an existing payment account:
- Open the Customer form.
- Go to the Payment Accounts sub-tab.
- With the form in EDIT mode, editable fields are displayed with a yellow pencil icon at the top of the column. Note: only Active flag and Email Address are editable after a payment account has been saved.
- Click in the grid and make changes directly in the field.
- Save the form.
Add a payment account:
- Open the Customer form.
- Go to the Payment Accounts sub-tab and click the Add icon in the grid.
- Enter payment account details in the Add Payment Account window including Account Type, Card Number, Card Expiration Date, CSC and Name on Card.
- Enter billing information manually or select a value from the Site Name dropdown and update as needed. The Billing Address MUST match the address on the credit card or bank account selected in the Payment Account section.
- If an email address is entered, payment receipts will be sent to that address when the account is used.
- Click OK.
Delete a payment account:
- Open the Customer form.
- Go to the Payment Accounts sub-tab
- Check the box to the left of the payment account row you wish to delete and then click the Delete icon. Note: in order to change information on an existing saved payment account (other than the Active flag or Email address), you must first delete the payment account and re-add it with the new details.
Notes:
- External Users will not see any payment accounts added internally (via the Customer Record or added to an Invoice). They will only be able to view / use payment accounts they have added /saved.
- Once saved, only the Active flag and Email Address are editable.
- The Merchant Account section of the Add Payment Account modal appears only in multi-company environments and must be completed if the same card will be used across multiple companies.
- A separate payment account must be created for each company.
- Payment accounts can also be created directly from an Invoice using the Add icon next to the Payment Account field.
Add a Payment Account and Process Payment on an Invoice
- Open an unposted or posted Invoice.
- In the Payment Account field, select an existing account from the drop down list, or add a new Payment Account using the Add Payment Account icon next to the Payment Account field. The Add Payment Account modal will open.
- Enter payment account details in this modal including Account Type, Card Number, Card Expiration Date, CSC and Name on Card.
- Enter billing information manually or select a value from the Site Name dropdown and update as needed. The Billing Address MUST match the address on the credit card or bank account selected in the Payment Account section.
- If an email address is entered, payment receipts will be sent to that address when the account is used.
- Click OK.
- From the Extended Menu on the Invoice, select Charge Payment Account.
- If the Invoice is unposted, a popup asks ‘Invoice will be posted prior to charging. Continue?’ Click OK to post.
- If applicable, the surcharge is pulled from the payment account and cannot be edited here.
- A payment confirmation popup displays the charge amount. Confirm and click OK. The Invoice will refresh and show the payment on both the Invoice and AR Journal tab.
Notes:
- Once an Invoice has been posted and payment processed against it, it cannot be unposted.
- Invoices that already have a payment account assigned can also be paid from the Invoices to Print Q Extended Menu.
- Partial payments cannot be processed via the Invoices to Print Queue or from an Individual Invoice Extended Menu.
- Payment Accounts may also be added to the Quote or Order level from the Quote > Details tab > Payment Account field or Order > Details tab > Payment Account field. These will carry through to an Invoice to be used if necessary.
Create an External Payment Link
External payment links allow customers to submit payment using a secure URL. Note: customers cannot pay until the Invoice is posted.
To create a payment link:
- Open an Invoice.
- Click the Create Payment URL icon next to the Token Expiry field.
- Posting or printing the Invoice will also generate a payment token automatically.
- Confirm the action in the popup window.
The expiration date is calculated as the current date plus the Default Token Expiry Days setting. If the Invoice Due Date is in the future, the expiry extends to the Due Date plus the configured days, whichever results in a later expiration.
Refresh an Expired External Payment Link
Only Q360 users can refresh expired links.
- Open the Invoice.
- Click the Refresh Token Expiry icon next to the Token Expiry field.
The expiration date will update automatically.
Revoke an External Payment Link
- Open the Invoice.
- Click the Revoke Token icon next to the Token Expiry field.
Note:
- The previously shared payment link will no longer function.
Manually Send an External Payment Link
- On the Invoice, click the Copy Payment URL icon next to Token Expiry.
- If the Invoice is unposted, you will be prompted to post it.
- The link may be copied before posting, but customers cannot pay until the Invoice is posted.
- Send the link to the customer via email or another communication method.
Note:
- This link opens an external payment page that displays limited information such as Invoice Number, Balance, Invoice Total, Processing Fee and Payment Amount. Charged amount may be less that full amount listed upon payment if state / locality surcharging laws dictate a lower surcharge / processing fee.
Customer Payments via External User Customer Portal
Customers can pay (or partially pay) invoices directly through the portal.
- Open the External User Portal and navigate to the Invoices section.
- Click on the Unpaid tab.
- Select one or more invoices and click Pay Selected.
- Multiple invoices can be paid together only if Company, Currency, and Branch are the same.
- Review payment details, estimated surcharges, and available payment accounts.
- Click Pay.
Note:
- Only payment accounts added by the portal user and accessible to them will be available.
- External Users cannot delete payment methods they have saved – they would need to contact their manager or their Q360 administrator and ask them to remove a payment method.
- If multiple Invoices are being paid in one transaction, ensure that all are fee exempt or not fee exempt. A mixture of fee exempt and not will result in fees being charged on the full amount processed.
Charge a Call Deposit
- Open a Call (Dispatch) record.
- From the Extended Menu, select Charge Call Deposit.
- Review the payment window showing Amount Due and Surcharges.
- Select an existing payment account or create a new one.
- Choose or enter a billing address.
- Click Pay.
Refund or Void a Payment
From an Invoice:
- Go to Invoice > AR Journal tab.
- In the Credits / Payments section, highlight a line item of type “Payment Processor.”
- Open the Extended Menu and select Refund/Void Payment.
- If the payment has not settled, it will be voided.
- If the payment has settled, it will be refunded.
From the Payment Transactions Report:
- Run Payment Transactions (Payment Report Q0395).
- Filter results as needed.
- Highlight a transaction (charge row with Status = Success) and select Refund/Void Payment from the Extended Menu.
Notes:
- Partial refunds are not allowed. Only full payment amount may be refunded.
Payment Visibility and Reporting
The following reports provide insight into payment activity:
- Q0395 Payment Transactions — All payment transactions processed in the system. This report has an Extended Menu that can be used to void / refund transactions. Failed transactions are also displayed in this report.
- Q0396 Payment Processor Transactions — Transaction data retrieved from the processor API for a given Account ID and Date range. The results are joined to the EXTENDVIEW_LDView_PaymentTransaction on PaymentTransactionNo and that extend view can be leveraged to pull data from the PaymentTransaction table (Q360 records for payments). Includes chargebacks and reversals not displayed in Q0395.
- Q0397 Payment Processor Deposits — Deposit data from the processor API for a given Account ID and Date range. By default the deposits are grouped by their Deposit ID. The results are joined to the EXTENDVIEW_LDView_PaymentTransaction on PaymentTransactionNo and that extend view can be leveraged to pull data from the PaymentTransaction table (Q360 records for payments).
- Q0398 Payment Processor Merchant Statements — Detailed fee and charge information for a given Account ID and Date range. Includes an Extended Menu option to download the PDF version of any Merchant Statement.
Download a Payment Processor Merchant Statement
- Run Q0398 Payment Processor Merchant Statements and apply filters as needed.
- Highlight an account statement.
- From the Extended Menu, select Merchant Statement PDF.
The PDF includes summary and activity details, including charges, rejects, returns or chargebacks, processing fees, and flat fees.
Reconcile Zift Payment Processor Deposits
- You will receive an email (with a PDF attached) from Zift advising you of the deposit amount for the outlined period. Note: you may also access this information within Q360 (Live Data > Accounting > Payment Processor Merchant Statements). If accessing via Q360, on the Merchant statement, highlight the statement you want to reconcile, and from the grid extended menu select Merchant Statement PDF. The PDF will automatically download. You will use this information to create manual journal entries.
- When funds are received, a manual journal entry is required. See help center content regarding creating manual journal entries if you are not familiar with this process.
- You will need the deposit amount and any fee amounts listed. The deposit date listed will be the date we use for the manual journal entry created. Create manual entries for
- Bank Account deposit (Account should be Bank Account)
- Summary of fees (Account should be Credit Card Fees Expense Account)
- Credit Card clearing amount (sum of deposit and fees). Account should be Credit Card Clearing Account.
- Click Save icon
- This deposit will now appear on the Bank Reconciliation form in Q360 and is available to reconcile.