Link to Pay is an easy way to add ACH and card payment acceptance to any NetSuite invoice you send to your customers. It embeds a Link into your existing invoices or quotes to seamlessly direct cardholders to our Hosted Payment Page (HPP) on the secure MerchantE server. Once on our secure payment page, the cardholder enters their payment details and is provided a receipt after the payment is submitted and confirmed. The invoice record in NetSuite is immediately marked “paid.” The service is simple to deploy and easy to maintain.
This User Guide gives you the information you need to get started quickly. To get started, you need to:
Site Customization - Customize your new payments page through the HPP Admin Dashboard.
MerchantE for SuitePayments - Ensure you have the most recent version of MerchantE for SuitePayments (Payment Gateway API).
NetSuite Setup - Follow the enclosed step-by-step instructions to enable your NetSuite email template to incorporate the Link to Pay.
Admin Dashboard
The Admin Dashboard is the admin section of the HPP, shown below. It enables you to customize the payment page and view transaction history and handle minor exception processing such as unlocking accounts. Using the credentials emailed to you as part of setting up Link to Pay, you can access the merchant dashboard by visiting here: hostedpayments.merchante.com.
Link to Pay Site Customization
The HPP Customization tab is the area where you can apply your brand to the look of the Hosted Payment Page that your customer sees. You can select a theme color, upload a logo, and add links to your company’s Terms of Service and Policy. The background color dictates the color of the background on the checkout related screens. You can select a theme color by picking a color box or you can enter the hex code. The color box allows you to modify the color and the opacity of the background. You can upload your logo by clicking on the Upload Logo Files button. Your image must be PNG, JPG, or GIF format. The file size cannot exceed 256KB. The image size is limited to 200 by 65 pixels. Note: The actual image size is limited to 200 by 65 pixels. It is strongly recommended to have a company logo specified so that customers have the certainty they are still within your company’s checkout flow. The footer will appear at the bottom of your payment page. It will display your company name and all rights reserved. Additionally, you can upload your Terms of Service Policy and your Privacy Policy to your payment page. When one or both links are provided, we add the links to the footer. The theme color controls, links, transaction amount, buttons, and user icon of the payment page and the customer dashboard. You can select a theme color by picking a color box or you can enter the hex code. The Setting and Configuration tab changes are not required. Link to Pay is preconfigured to ensure your Invoice/Quote payment page can accept customer payments. Link to Pay will generate the necessary payment links. Caution: Custom Amount and Recurring Payments will be visible on the merchant dashboard but are disabled for Link to Pay transactions. Any changes to these settings will not apply. Customers will be required to pay their invoice in full. If you need recurring functionality, consider leveraging the NetSuite recurring billing feature. NetSuite provides you with robust reporting and reconciliation of invoiced transactions. Hosted Payments also includes a Transaction History tab on the merchant dashboard where you have the ability to search for transaction(s), resend receipts, and reset customer’s accounts. When you click on the tab, the page will display a list of your most recent transactions. Each transaction is listed with: Customer Name Email Address Transaction ID Payment Method Transaction Date Result Transaction Amount Action (actions that can be taken for a transaction) You can sort any of these columns except for the email address. It is important to note here that sorting on Payment Method sorts based on the entire card or account number. but we only display the last 4 digits for security purposes. When performing a searching on this value, the Admin will enter the last 4 digits of the card or account number. When you click on the More link, a dropdown menu will appear displaying a range of actions you can select for that transaction: Menu Option Function Resend Receipt The receipt for the selected transaction will be sent to the email address entered during checkout. Unlock Account This action unlocks a customer’s account if needed.Background Color
Company Logo
Footer
Theme Color
Settings and Configurations
Transaction History
MerchantE Reporting Portal
The Merchant Reporting Portal is provided to every merchant of Link to Pay. The website address and login credentials are identical to regular Link to Pay and are provided upon completion of the merchant application process.
The Merchant Reporting Portal adds the following functionality to Link to Pay:
View Unsettled Transactions - Merchants can view real-time transactions which have been processed since the last batch close.
View Rejected Transactions - Similar to Unsettled Transactions, a merchant can view rejected or declined transactions, including a description of why the transaction failed.
In addition, the administrative section allows for customization of settings to reject transaction due to a mismatch between the billing address provided and the address on file with the card issuer, and/or CVV mismatch.
MerchantE for SuitePayments
Navigate: NetSuite → Customization → SuiteBundler → Search & Install Bundles When the list comes up, search for MerchantE Payment Gateway API and click in the name of the bundle. The Bundle Details page will load, shown below: Click on the Install button to load the most recent version of MerchantE Payment Gateway API to your account.
Link to Pay NetSuite Setup
Link to Pay Configuration
Link to Pay utilizes its own configuration within NetSuite to ensure a payment link is generated for your Invoices and Quotes.
Setup a new user ID in Business Platform (BP)
Under 19. Users Pointed At This Merchant Number click on Create a new user for this Merchant Number.
Enter a User ID:
Use the Merchant ID (MID) with “IL” at the end to create the ID, for example 123456789IL.
Enter a User Name:
Use the DBA name listed in the Contact Nm field under 1. Merchant Information, ie. ACME.
Enter an Email Address:
Choose a User Email address listed in 1. Merchant Information.
Select MES Merchant User w/HPP from the User Type dropdown menu.
Click Submit.
Follow the steps required to create a password for that user and note the information to be used during the configuration setup process.
Set up a new payment method in NetSuite
Navigate: NetSuite → Setup → Accounting → Accounting Lists In the Filters section, under Type use the dropdown to select Payment Method then select New. On the Payment Method screen, name the payment method. Use a name that the merchant will recognize, for example “Link to Pay”. Under Type, use the dropdown to set the type to External Checkout. Under Associate Payment Processing Profiles, use the dropdown to highlight the associated processing profile for Link to Pay. Click Save. You can view the new method by applying the Payment Method filter in the Accounting Lists screen. Once the Payment Method and the new user ID have been created you are ready to set up Link to Pay. To do this, type in “MerchantE Link to Pay Config” in the search box. On the Global Search: Results you will see MerchantE Link to Pay Config. Click Edit. On the MerchantE Link to Pay Config List screen click New MerchantE Link to Pay Config. On the MerchantE Link to Pay Config, screen enter details in all required fields. Name - Enter a name for the configuration. For example, Link to Pay. Subsidiary - Select the subsidiary of the merchant. Merchant Tax ID - Enter the appropriate Tax ID. This is for L2/L3 data. NS Profile ID - Add internal ID associated to the NS payment profile. Merchant Profile ID - Enter the MerchantE Profile ID from the Business Portal. Is Default - Enable to make all invoices under this subsidiary have the same Link to Pay link. Test Mode - Enabled the endpoints used will be test endpoints. Payment Method - Choose the Link to Pay payment method you just set up. Allow Custom Payment Amount - Enable if you want to give your customers the flexibility to choose payment amount on future invoices. Do Not Auto-Apply Statement Payment - Enable to prevent payments from being automatically applied. MerchantE General Token Payment Method - Select a payment method. ME Payment Card Token Payment Method - Select a payment method. Click Save. Note: If disabled, payments must be manually applied to invoices.
Email Templates
MerchantE Link to Pay utilizes the Advanced PDF/HTML Templates feature in NetSuite. This feature supports more customization capabilities than other template options you might know, such as Transaction Form Layouts (also known as Basic Layouts and Legacy Layouts).
When the Advanced PDF/HTML Templates feature is enabled, you can associate advanced templates with custom transaction forms, using these templates to format printed and email versions of transactions. For more information on this topic, see Setting Custom Forms to Use Advanced Templates and Advanced PDF/HTML Templates. However, everything you need to set up your Link to Pay is described below.
Enable Advanced PDF/HTML Templates
When the Advanced PDF/HTML Templates feature is enabled, an Advanced PDF/HTML Templates option is available in the Forms menu of the Customization screen. You can click this option to view a list of the advanced templates in your account. Note: The Advanced PDF/HTML Templates menu option is only available to account administrators and other users who have the Advanced PDF/HTML Templates permission. This is a Setup type permission with only one level: Full. For details about permissions, see NetSuite Permissions Overview. Standard templates are provided for each supported print type. You can create your own customized templates in a Template Editor that supports current industry standards for HTML-based editing, including rich text editing and HTML markup source editing. You can preview your template as you make changes, and detailed error messages are shown if the template cannot be saved. The Advanced PDF/HTML Templates list page includes standard advanced templates and any customized advanced templates that have been created in the account. To update your email templates, you should find the installed forms that show either Invoice or Quote in the Type column. Note: Make sure to note the name of the template that was updated to be added as part of the invoice and quote creation processes.
Adding a Link to Pay Link
Navigate: NetSuite → Customization → Forms → Advanced PDF/HTML Templates From the Forms submenu of the Customization menu, select Advanced PDF/HTML Templates. The Advanced PDF/HTML Templates list appears. Select Edit to make changes to an Advanced PDF/HTML Template. From the Form Editor screen, add the example code snippet to insert Link to Pay into the template. In this example, the link will look like this: Click Here to Pay Now Click the Preview button to view a sample your template. Click Save.<#if record.custbody_mes_invl_end_customer_link?has_content>
<a href="${record.custbody_mes_invl_end_customer_link}" target="_BLANK">Click Here to Pay Now</a>
</#if>
Adding a Link to Pay QR Code
Navigate: NetSuite → Customization → Forms → Advanced PDF/HTML Templates From the Forms submenu of the Customization menu, select Advanced PDF/HTML Templates. Select Edit to make changes to an Advanced PDF/HTML Template. From the Form Editor screen: To add the QR code to statement links, after <a href=”${meURL}&meGo-t”>Pay Link Text</a> and inside the <#if meURL?has_content> statement add the following code snippet. To add the QR code to Link to Pay transaction links, after <a href=”${record.custbody_mes_invl_end_customer_link}”>Pay Link Text</a> add the following code snippet. Click the Preview button to view a sample your template. Click Save.<barcode codetype="qrcode" showtext="false" height="150" width="150" value="${meURL}&meGo=T" />
<barcode codetype="qrcode" showtext="false" height="150" width="150" value="${record.custbody_mes_invl_end_customer_link}" />
Invoices
Creating an Invoice or Quote
Use the following links to reference the comprehensive documentation provided by NetSuite related to invoices and quotes: Ensure your customer is set up properly. If the customer type is an individual, input the customer's First/Middle/Last Name and an email address in the customer record. If the customer type is a company, input the customer's First/Middle/Last name and an email address of the Primary Contact under the customer record. During the process of creating your invoice or quote make sure to select the following: Select the form you customized with the Link to Pay in previous steps. Select the Link to Pay Configuration. Ensure a billing address is selected for the Invoice or Quote being created.
Creating a Customer Deposit
Customer deposits allow you to request an initial payment on a purchase prior to fulfillment to ensure your costs are covered before delivering goods to a customer. Ensure your customer is setup properly. Make sure the customer does not have a card on file set as the default payment method. If card on file is set as the default payment method, that card will automatically be charged rather than allowing your customer to initiate the payment as intended. Create a quote with the customer conversion logic set to Sales Order - Customer Deposit. Select the Link to Pay configuration. Confirm that the email is set up to be sent. Note: Customer Deposits are normally posted in NetSuite within 15 minutes of customer payment. Once the customer deposit is processed, a sales order is created automatically and ready to be fulfilled. Once fulfilled the customer deposit will be applied to the invoice associated with this order. If there is a remaining balance, that amount may be collected by sending the invoice with Link to Pay to the customer.
Invoice Groups
You can use Invoice Groups in NetSuite with your MerchantE implementation. This provides you with additional flexibility to meet customer expectations for how and when they will receive invoices by combining multiple invoices into a single group. With grouped invoices, you can: Pay a specific group of invoices with a single payment using credit card, cash, or automated clearing house. Pay grouped invoices on a predefined schedule. Make full or partial payments of grouped invoices. Process refunds, credits, voids, chargebacks, and reconciliations using the normal workflow. View detailed line-item information for the grouped invoice. To do this, you will need to enable and configure Invoice Groups in NetSuite and submit the invoice group to MerchantE. This guide provides step-by-step instructions for using Invoice Groups. For more information, see NetSuite Invoice Groups Overview.
Enable Invoice Groups for the Account
Invoice Groups must be enabled for in your NetSuite account globally and for individual customers in order to create Invoice Groups and add invoices to the group. Caution: It is difficult to disable Invoice Groups after they have been enabled. Invoice Groups cannot be disabled if invoice group records are present. This includes any records generated for invoice groups. Navigate: NetSuite → Setup → Company → Enable Features → Transactions → Invoice Group From the NetSuite start page, open Enable Features in the Company submenu of the Setup dropdown menu. Open the Transactions tab. Enable Invoice Group and click Save. Group Invoices is now available for your customer accounts in NetSuite.
Enable Invoice Groups for the Customer
Navigate: NetSuite → Lists → Relationships → Customers → Financial → Group Invoices From the Lists dropdown menu, select Customers within the Relationships submenu. Select the customer by clicking the Edit link. In the Financial tab, check the Group Invoices box and click Save. The customer is now available to have their invoices added to Invoice Groups. To further customize Invoice Groups, see:
Removing an Invoice from and Invoice Group
Note: If a payment has been fully or partially applied to the Invoice Group, you must first remove the payment. For more information see Reversing or Deleting Customer Payments. Navigate: NetSuite → Transactions → Sales → Group Invoices → List → Invoice Group Display the Invoice Groups list by clicking List in the Group Invoices submenu. Select the Invoice Group by clicking the View or Edit link. Click Remove From Group. From the Remove Invoices From Group screen, check the box for the invoices to be removed. Click Remove From Group.
Deleting an Invoice Group
Navigate: NetSuite → Transactions → Sales → Group Invoices → List Display the Invoice Groups list by clicking List in the Group Invoices submenu. Select the Invoice Group by clicking the View or Edit link. From the Actions dropdown menu, click Delete. Note: To delete an Invoice Group, you must first remove all invoices from the group. Then you can delete the Invoice.
Submit Invoice Group to MerchantE
Navigate: NetSuite → Transactions → Sales → Group Invoices → Select Invoices → Submit Allow 15 minutes for processing or click Manually Send to MerchantE Link to Pay. Note: 15 minutes is the shortest interval available for scheduled scrips.
Add Comment