7.1 Overview

The Payment Links section allows the card owner to place payment destinations, payment instructions, UPI payment links, or payment-related images on the public digital card.

Payment Links is a dedicated section within the VCard editor. The system provides separate operations for adding, viewing, editing, updating, and deleting each entry.

A payment-link entry contains:

  1. An identifying icon
  2. A label
  3. A display type
  4. A description, payment address, or instruction
  5. A content image when the Image display type is selected

Payment Links are separate from product orders, appointment payments, subscription payments, and the payment-provider configuration located in Settings.

7.2 Opening the Payment Links Section

From the dashboard:

  1. Select VCards.
  2. Locate the digital card you want to update.
  3. Select the card name or the Edit icon.
  4. Select Payment Links from the VCard editor menu.

On a phone or smaller screen, select the menu icon within the editor to display the available sections.

The Payment Links page displays all payment-link entries connected to the selected digital card. The editor loads this section through its dedicated Payment Links interface.

7.3 Understanding the Payment Links List

Each saved payment link appears in a management table.

The table can display the following information:

Icon

The image associated with the payment option.

Examples may include:

  1. A payment-service logo
  2. A bank symbol
  3. A card-payment icon
  4. A company logo
  5. A QR-payment symbol
  6. A general payment image

When an icon has not been stored successfully, the system uses a default image.

Label

The name visitors use to identify the payment option.

Examples include:

Pay My Invoice
Make a Deposit
Pay with PayPal
Pay with UPI
Pay Registration Fee
Support Our Organization
Purchase Consultation

Long labels may appear shortened in the dashboard table. Use a clear and concise label so visitors understand the payment’s purpose.

Display Type

The selected format used to present the payment content.

The system treats image-based payment entries differently from description-based entries. UPI entries also receive special formatting instructions.

Actions

Each payment-link row provides controls to:

View
Edit
Delete

Adding a Payment Link

7.4 Opening the New Payment Link Form

Select Add Payment Link at the top of the Payment Links section.

The New Payment Link window opens.

The form contains:

Icon
Label
Display Type
Description or Content Image
Save
Discard

Complete every required field before saving.

7.5 Uploading the Payment Icon

The Icon is required when creating a payment link.

Select the edit icon within the image area and choose an image from your device.

Supported icon formats include:

JPEG
JPG
PNG
GIF
WEBP

The maximum icon size is:

2 MB

Use a simple, recognizable image that remains clear when displayed at a small size.

Good examples include:

  1. A payment-provider logo
  2. A bank logo
  3. A dollar or payment symbol
  4. A company mark
  5. A branded checkout icon

Avoid uploading an image containing large amounts of small text because the icon is displayed as a thumbnail.

The payment icon is different from an image used as the actual payment content. Image-based payment content is configured separately after selecting the appropriate Display Type.

7.6 Entering the Label

Enter the payment option’s name in the Label field.

The Label is required.

Use wording that explains both the action and its purpose.

Clear examples include:

Pay Your Invoice
Pay Consultation Deposit
Pay Event Registration
Make a Donation
Pay with UPI
Submit Membership Payment

Less effective labels include:

Click Here
Payment
Link
Option 1

A visitor should be able to understand what will happen before selecting the payment option.

7.7 Selecting the Display Type

Select the appropriate option from the Display Type dropdown.

The selected type determines whether the form requests written content or an image.

The interface specifically provides special handling for:

  1. UPI payment links
  2. Image-based payment entries
  3. Other description-based payment entries

Choose the type that matches the information you intend to present.

Description-Based Payment Entries

7.8 Using the Description Field

For description-based Display Types, the form shows a required Description field.

The Description can contain up to:

1,000 characters

Enter the information appropriate to the selected type. Depending on the option selected, this may be:

  1. A complete hosted payment address
  2. A payment instruction
  3. A payment-provider checkout link
  4. An invoice-payment address
  5. Bank-payment instructions
  6. A UPI payment URI
  7. Explanatory information for the visitor

When entering a web payment address, use the complete secure URL.

Example:

https://payments.example.com/invoice/12345

Do not enter only:

payments.example.com

The complete address reduces the risk of the public card opening an incomplete or incorrect destination.

7.9 Writing Payment Instructions

When the selected Display Type is intended to show written instructions, enter only the information visitors need to complete the payment.

Example:

Select Pay to open our secure payment page. Enter your invoice number in the payment-note field before submitting your payment.

Another example:

Use this payment option for consultation deposits only. Your appointment is confirmed after the payment has been received and verified.

Do not place account passwords, private access codes, administrative credentials, secret API keys, or other confidential information in the Description field.

Anything displayed through a public digital card should be treated as public information.

UPI Payment Links

7.10 Selecting UPI

When UPI is selected as the Display Type, the interface displays a note explaining the required UPI link format.

The programmed format is:

upi://pay?pa=VPA@bank&am=Amount&cu=INR

Example:

upi://pay?pa=9876543210@ybl&am=100&cu=INR

Enter the complete UPI link in the Description field.

7.11 Understanding the UPI Parameters

The UPI format uses several parameters.

pa

The payee’s UPI address or virtual payment address.

Example:

pa=9876543210@ybl

am

The requested payment amount.

Example:

am=100

The amount may also contain decimals when appropriate:

am=100.50

cu

The currency code.

The system’s displayed example uses:

cu=INR

A complete example is:

upi://pay?pa=9876543210@ybl&am=100&cu=INR

Do not insert spaces into the UPI URI.

7.12 Allowing the Customer to Enter the UPI Amount

When you want to request a fixed amount, include the am parameter.

Example:

upi://pay?pa=9876543210@ybl&am=100&cu=INR

When you want the customer to enter the amount manually, remove the amount parameter.

Example:

upi://pay?pa=9876543210@ybl&cu=INR

Test both versions on a compatible mobile device before publishing the payment option.

7.13 UPI Mobile Availability

The Payment Links interface states that the UPI Pay button will be visible only on mobile devices.

This means a visitor viewing the card on a desktop computer may not receive the same UPI payment-button experience as someone viewing it on a phone.

After creating the entry:

  1. Open the public digital card on a phone.
  2. Locate the payment link.
  3. Select Pay.
  4. Confirm that the intended payment application opens.
  5. Verify the payee and amount before completing any test transaction.

Image-Based Payment Entries

7.14 Selecting the Image Display Type

When the image-based Display Type is selected, the Description field is replaced by an image-upload control.

The content image is required when creating a new image-based payment entry.

This image can be used for:

  1. A payment QR code
  2. A bank-payment instruction graphic
  3. A payment-service code
  4. A donation-payment image
  5. A branded checkout instruction card
  6. Other visual payment information

The content image is separate from the smaller payment icon.

7.15 Understanding the Two Payment Images

An image-based payment link may contain two different images.

Payment Icon

The small identifying image displayed with the payment entry.

Example:

UPI logo
Bank logo
Payment-service logo
Company logo

Content Image

The larger image visitors view as the payment information.

Example:

Scannable payment QR code
Bank-transfer instruction graphic
Donation code
Payment account card

Do not upload the same low-resolution thumbnail for both purposes unless it remains readable and scannable in both locations.

7.16 Uploading the Payment Content Image

After selecting the image-based Display Type:

  1. Select the edit icon in the new image area.
  2. Choose the payment image from your device.
  3. Review the preview.
  4. Adjust the crop when requested.
  5. Confirm that no important part of the image was removed.
  6. Select Save.

When uploading a QR payment image, make sure all four sides of the QR code remain visible and that clear space remains around the code.

Test the final public image with a separate mobile device before distributing the card.

7.17 Changing to the Image Display Type

When editing an existing payment link and changing it from a non-image type to the image-based type, the system requires a content image.

When the entry was already image-based, the existing image can remain in place unless you choose to replace it.

This prevents an image-based payment entry from being saved without payment content.

Saving and Reviewing Payment Links

7.18 Saving a New Payment Link

After completing the required fields, select Save.

The system validates the entry.

Common validation issues include:

  1. Missing icon
  2. Unsupported icon format
  3. Icon larger than 2 MB
  4. Missing Label
  5. Missing Display Type
  6. Missing Description
  7. Description longer than 1,000 characters
  8. Missing content image for an image-based entry
  9. Invalid image upload

When the payment link is accepted:

  1. A success message appears.
  2. The New Payment Link window closes.
  3. The Payment Links table refreshes.
  4. The new entry appears in the list.

7.19 Using Discard

Select Discard to close the New Payment Link window without saving the current entry.

Discard does not affect previously saved payment links.

Information entered into the unsaved form is cleared when the form is closed or reopened.

7.20 Viewing Payment Link Details

Select the View icon beside a payment link.

The Payment Link Details window displays:

Icon
Label
Display Type
Description or Content Image

For a description-based entry, the window displays the saved Description.

For an image-based entry, the Description area is hidden and the saved content image is shown instead.

Use the View option to confirm the saved information without opening the editing form.

Editing Payment Links

7.21 Opening the Edit Form

Select the Edit icon beside the payment link you want to change.

The Edit Payment Link window opens with the saved information.

You can update:

  1. Icon
  2. Label
  3. Display Type
  4. Description
  5. UPI link
  6. Content image

7.22 Replacing the Icon

Select the edit control on the current icon and choose a replacement image.

When editing, uploading a new icon is optional. The existing icon remains when no replacement is selected.

The replacement must still be a supported image and must not exceed 2 MB.

7.23 Changing the Display Type

Select a different option from the Display Type dropdown.

The form changes according to the selected type.

When switching to the image-based type, the Description field is replaced by an image upload.

When switching from an image-based type to a description-based type, the image control is replaced by the Description field.

Review the content carefully after changing types because the previous content may not be appropriate for the new format.

7.24 Updating a UPI Link

To update a UPI payment entry:

  1. Select Edit.
  2. Confirm that UPI is selected.
  3. Update the UPI URI in the Description field.
  4. Review the payee, amount, and currency parameters.
  5. Select Save.
  6. Test the public Pay button on a mobile device.

Do not assume the new link works merely because the system saved it. The system validates the required field but cannot guarantee that the external payment destination is correct.

7.25 Saving Changes

Select Save after editing the entry.

A success message confirms that the Payment Link was updated.

The management table refreshes and displays the revised label, icon, or Display Type.

Select Discard to close the editing window without saving the current changes.

Deleting Payment Links

7.26 Deleting a Payment Link

Select the Delete icon beside the payment link.

Review the confirmation message and approve the deletion.

Deleting the entry removes:

  1. The payment-link record
  2. Its stored icon
  3. Its stored content image

Deletion is different from temporarily hiding an entry. The Payment Links interface does not provide a separate active/inactive switch for each payment-link row.

Only delete an entry when it is no longer needed.

7.27 Replacing an Outdated Payment Link

When a payment address has changed, editing is normally safer than deleting and recreating the entry.

Use Edit when you only need to change:

  1. The payment URL
  2. The UPI address
  3. The requested amount
  4. The label
  5. The icon
  6. The content image
  7. The instructions

Use Delete when the payment option should be completely removed from the card.

Reviewing Payment Links on the Public Card

7.28 Previewing the Payment Section

After adding or editing a payment link:

  1. Return to the VCards page.
  2. Open the card’s preview or public URL.
  3. Locate the Payment Links section.
  4. Confirm that the icon appears.
  5. Confirm that the Label is correct.
  6. Test the payment action.
  7. Review the section on desktop and mobile.
  8. Test UPI specifically on a mobile device.
  9. Scan image-based payment codes from a separate device.

The exact position and visual style of Payment Links can vary according to the selected VCard template.

7.29 Confirming External Payments

The Payment Links feature primarily presents payment information or sends visitors to a payment destination.

As an operational practice, confirm completed payments within the connected payment service, bank, UPI application, invoice system, or other payment provider.

Do not treat a visitor selecting the VCard’s Pay button as proof that payment was completed.

7.30 Payment Link Safety

Before publishing a payment link, confirm that:

  1. The destination belongs to the correct business or recipient.
  2. The address uses the intended secure payment page.
  3. The requested amount is correct.
  4. The currency is correct.
  5. The UPI payee address is correct.
  6. The content image is current.
  7. The QR code opens the intended payment destination.
  8. No private credentials are displayed.
  9. The public card is using the final approved payment information.

Review payment entries regularly and remove outdated links.

7.31 Common Payment Link Problems

The Icon Will Not Upload

Confirm that the file is a JPEG, JPG, PNG, GIF, or WEBP image and is no larger than 2 MB.

The Form Requires a Description

The selected Display Type uses description-based content. Enter the appropriate payment address or instructions.

The Form Requires an Image

The image-based Display Type is selected. Upload the required content image.

The UPI Note Does Not Appear

Confirm that UPI is selected in the Display Type dropdown.

The UPI Pay Button Is Missing on Desktop

The programmed UPI Pay button is intended for mobile-device display. Test it on a compatible phone.

The Payment Destination Does Not Open

Review the complete address or UPI URI for missing characters, spaces, or incorrect parameters.

The Image-Based Code Does Not Scan

Upload a clearer image with stronger contrast and sufficient blank space around the code.

The Updated Entry Still Shows Old Information

Refresh the public card, clear the browser cache, and confirm that the edit form was saved successfully.

The Payment Link Was Deleted Accidentally

Deletion removes the entry and its associated media. Create a new payment link and re-enter the information.

7.32 Payment Link Checklist

Before completing the Payment Links section, confirm that:

  1. The correct icon is uploaded.
  2. The Label clearly explains the payment purpose.
  3. The correct Display Type is selected.
  4. The Description contains the correct destination or instructions.
  5. UPI formatting is complete when applicable.
  6. The content image is uploaded for an image-based entry.
  7. Payment QR codes scan successfully.
  8. No confidential information is displayed.
  9. The entry has been saved.
  10. The public card has been tested.
  11. The external payment destination has been verified.

Chapter Completion

At the end of this chapter, the user should understand how to add, view, edit, test, and delete VCard Payment Links; upload identifying icons and content images; configure UPI links; and verify payment options on the public digital card.

Write Your Comment