Skip to main content

Online payments

Create a Payment Link

Last updated: 13-Dec-2023

Use Pay by Link in Verifone Central

Generate a payment link

  1. Navigate to Commerce > Payment Tools > Pay by Link.

    pay by link

  2. In the Payment Links page, click on the Create Payment Link button at the top of the page.

    payment links page

  3. The Create Payment Link page will be displayed.

    Payment settings screen

    PBL Payment settings screen

    • Select the Organization to which the transaction belongs. If your account is associated with only one organization, this field will pre-populate, otherwise, if it is associated with multiple organizations, you will need to select one organization from the list.
         A compatible Payment Provider Contract (PPC) with an e-commerce sales channel is required to use the Pay by Link tool.
    • Choose the Cart information type and set the Transaction Amount that you want to request from the customer. Based on the currency selection, the available payment methods are displayed. If a contract is configured to process multiple currencies, select the currency code needed from the list.
         If the Amount & product option is selected, the product information should be entered and the amount per unit should be filled in. The total price will be calculated based on quantity. Use the Add Product button for additional product lines.

      Amount & product option

    • If the selected organization has Woodforest and Worldpay US as acquirers, the following fields will be displayed: 
      • Amount is taxable: A checkbox you need to click on if the amount is to be taxed. 
      • Tax Amount: The amount of tax to be paid on the purchase. Only displayed if the Amount is taxable checkbox is checked.
      • PO Number: The number of the purchase as assigned by you (the merchant). 
    • (optional) Add the Merchant Reference to identify the transaction or link this transaction to an order ID generated by your own inventory system.
         The Merchant Reference field for Pay by Link is restricted to 50 characters.
    • (optional) Add the Invoice number to identify the invoice created for the transaction.
    • (optional) The Sales Identifier is the dynamic descriptor of the payment link transaction added to identify the transaction.
    • Select the Payment Method allowed for this particular transaction. If there is only one payment method, this field will pre-select. If available, you can select multiple payment methods.
         Depending on the settings in your Payment Provider Contract (PPC) you will be prompted with different fields.
      • (if applicable) The Payment Contract field will be displayed only if there will be more than one available for the selected organization and currency. If there is only one payment contract, this field will pre-populate.
        PBL Payment methods
      • (if applicable) Select Authorization or PreAuthorization as Authorization Type.
        • Authorization - An authorization transaction puts funds on hold, which cannot be adjusted.
        • Preauthorization – A preauthorization is used as a validation process. The card can be verified if is valid and if it has the necessary amount for completing the payment for the needed service. Funds are put on hold for future payment transaction, but these can be adjusted.
      • (if applicable) Choose between Sale and Standard installment in the Credit term field.
        • Sale - The sale transaction implies authorization and capture are done in one single step.
        • Installments (Israel and Mexico)– For this option select the maximum number of payments needed. ​​​​​​ 
      • (if applicable) Choose the SCA Compliance Type.
        • None - Transactions will be sent to Nets and Verifone Acquiring. If the transaction results in a soft decline, then it is declined, we will update Vipps as payment result: fail. No 3DS will take place.
        • Wallet - Transactions will be sent to Nets and Verifone Acquiring. If the transaction results in a soft decline, we will update Vipps as soft_decline and provide a 3DS URL to perform 3DS.
        • Force_3DS - Transactions will not be sent to Nets and Verifone Acquiring initially. We will update Vipps as soft_decline and provide a 3DS URL to perform 3DS.
          PBL Alternative payment methods
    • Enable 3-D Secure Authentication, if required. If you enable 3-D Secure Authentication, you will be required to select the 3-D Secure Authentication contract and provide customer details.
    • If you want to perform a sale transaction (authorization + capture), check the Automatically send transaction for capture checkbox. If you leave the Automatically send transaction for capture checkbox unchecked, you have to manually perform the authorization and the capture. 
    • The Customer address details fields are optional, unless 3DS is enabled.

    Once the payment settings have been completed, click on the Continue to link settings button to proceed.

    Link settings screen

    Link settings screen

    • Set the Link Expiration time to choose for how long a payment link should remain valid. The maximum is 30 days from the time you created the link. Once expired, the customer cannot access the payment link.
    • Choose the Preselected language to be used in the checkout interface.
    • Set a Checkout theme of your choice to personalize the Pay by Link checkout page. You can choose the Default theme (the default template theme provided by Verifone) or a customized theme created via the Checkout Themes editor.
    • (optional) If you want to send the link directly to the customer using one of the methods provided, you can check Send link by email or Send link by phone number or both.

    Once the configuration has been completed, click on the Create payment link button to proceed.

       You can always edit the previous payment configuration, by selecting the Back to payment settings button.

    Done screen

    Done screen

    A confirmation screen will be displayed.

    The payment link can be copied to clipboard, by pressing the Copy link button or can be sent by email or SMS by pressing the Send payment link button.

  4. Click on Return to payment links to be redirected to the Payment Links page. To share the link with your customer, follow the steps from the Sharing the Payment Link section.

Share the Payment Link

After creating the Payment Link, you will need to share it with your customer, if not already shared. You can share it through any channel, the Payment Link is mobile friendly.

  1. In the Payment links page, you can recognize your Payment Link by the Amount, Merchant Reference, Email or by using the search filters. Click on your payment link to view more details.

    share payment link

  2. Confirm the details of the Payment Link.

  3. Once the Payment Link is selected, its details are displayed. Select the Actions tab, for sharing options.

    • Click on the Copy link button to copy the Payment Link to your clipboard. You can now share the link with your customer through a channel of your choosing.
    • Select the Send email or Send SMS options to forward the Payment Link to any specific email address/SMS.
      Actions tab
   An expired or disabled link should not be sent to a customer as it cannot be used to place a transaction.

If a payment link has expired, it can be reactivated, and the expiration date can be set at 30 days limit. To reactivate an expired link, you will have to access the link in Verifone Central, set the new expiration date value, and then re-enable the link.

Re-enable payment link

Confirmation of payment

The Payment Link history allows you to view if your customer has visited the link and initiated a payment, and the outcome of the transaction.

   If a payment was placed using 3DS validation, you will be able to access the enrollment and validation steps in the history.

Payment link history

If the payment has been completed successfully, you can View Transaction Details.

View transaction details button

Using Pay by Link via the API

Required fields

To configure Checkout for accepting Pay by Link, the following fields are required: 

  • entity_id - This value can be found in the portal or provided to you by a Verifone employee. The Entity ID can be found in Verifone Central under Administration → Organizations. The 'Organization ID' listed is the Entity ID.


  • currency_code - Currency code
  • amount - Transaction amount. Transaction with zero amount value will be considered as account verification and by default implicitly capture will be set to false for an account validation transaction.
  • configurations - Object with one or more payment method configurations
  • interaction type - Type of checkout. Allows for distinguishing payments accepted via different channels.

If the link will be sent via email or SMS, then an additional field is required.

  • notification_methods - The link can be sent automatically using one of the two options (email or SMS) or both of them in conjunction

Here is an example body for creating a Pay by Link:

    "amount": 100,
    "currency_code": "NZD",
    "entity_id": "entity_id",
    "customer_details": {
        "billing": {
            "address_1": "Your_Address",
            "first_name": "First_Name",
            "last_name": "Last_Name",
            "country_code": "NZ",
            "city": "Your_City"
        "entity_id": "entity_id",

"email_address": ""

    "configurations": {
        "card": {
            "payment_contract_id": "payment_contract_id",
            "threed_secure": {
                "enabled": true,
                "threeds_contract_id": "threeds_contract_id",
                "total_items": "01",
                "transaction_mode": "S"
    "interaction_type": "PAYMENT_LINK",
    "notification_methods": {
        "email": {
            "email_address": ""
        "sms": {
            "phone_number": "+64111111111"


The response for creating the Payment Link will look like this:

{ "id": "string", "url": "string"}

APIs used to update the transaction status

  • Actions that can be performed on a transaction after it was initiated are listed in the Verifone eCommerce API.

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo