How to Integrate with LinkPay
How to Integrate with LinkPay#
There are two options for merchants to initiate an online payment process:Option 1: Merchant can integrate with LinkPay via API defined in this document to get the LinkPay Payment Link (URL) for user to access LinkPay Payment Page for payment.
Option 2: Merchant can create LinkPay Payment Link manually on EVO Cloud Portal and send over to the user to access LinkPay Payment Page for payment.
LinkPay API#
The merchant can integrate with LinkPay through LinkPay API, then user can initiate the transaction via merchant’s Order Page, then process the payment by redirecting to LinkPay Payment Page.
A basic processing is as belowInitiate LinkPay#
A sample merchant Order Page to initiate LinkPay is as below:

User confirms the transaction, and clicks the button of Check Out, to initiate LinkPay Payment Page for the payment.Process Flow#
The process flow for LinkPay API call is as shown below, between the merchant Order Page and LinkPay:Step 9 is applicable only if the merchant sends the webhook while calling the LinkPay API (step 3). After the payment has been proceeded successfully, EVO Cloud will send the notification to the webhook URL.
Steps 10 and 11 are applicable only when the merchant wants to retrieve the status and detail of the payment transaction.
For detailed API definition, please refer to Retreive LinkPay in this document. Create LinkPay Payment Link via Portal#
Description#
The merchant can also create Payment Link via EVO Cloud Portal, which can enable the merchant and user to complete online payment without any merchant system and technology involved.
Once received the transaction order from the user, the merchant can then log on EVO Cloud Portal with ID and Password assigned by EVO Cloud to initiate the payment transaction.
After the transaction information is input in EVO Cloud Portal, with an email address or phone number entered, EVO Cloud can send an email or an SMS to the user with the Payment Link EVO Cloud generated.
After receiving the email or SMS, the user can click the Payment Link to go to LinkPay Payment Page to complete the payment.
The merchant can access EVO Cloud Portal to inquiry the transaction status and detail, and receive the related transaction report from EVO Cloud.Process Flow#
A basic process flow for LinkPay initiated via EVO Cloud Portal is as shown below, among the merchant, user, EVO Cloud Portal and LinkPay:Portal Process Flow#
Enter the everonet platform homepage, under the LinkPay menu there are two modules: LinkPay Orders and LinkPay Templates

LinkPay Templates#
Under the LinkPay Templates module, you can see LinkPay payment templates, where you can perform filtering, searching, and adding new template operations at the top.

On the right side of the template, you can perform disable, enable, delete operations. The delete operation can only be performed when the template is in disabled status.

Click on Templates ID to view template details. Then, click the edit button in the upper right corner to modify template content.

In the add new interface, we need to fill in template information, including name, scope, type, and who will fill in the user-related information.

After completing and saving the template information, you can select this template when creating LinkPay orders for this store.
LinkPay Orders#
In the LinkPay Order list, you can export orders to CSV or Excel.

Click on the order ID to view order details. The order status is shown in the upper right corner. If the status is "Paid", you can view related transactions below.

If the order type is multiple payments, there may be multiple transactions in the related transactions.

When viewing transaction details in case of payment failure, you can see the payment failure return code, and you can query the failure reason through the return code.

If the order status is "Unpaid", you can resend email notifications to customers for payment.

When adding a new LinkPay order, you must select a store.

If templates are configured in the store, after selecting the store, you will choose the template to be used.

After selecting the template, you need to fill in the order information and provide the required user information according to the template requirements.

According to LinkPay template requirements, if customer information needs to be filled by employees, this field is mandatory when creating an order; if it doesn't need to be filled or is to be filled by customers, this field will not be displayed; if it's optional for employees, then this field is not mandatory.



At the bottom of the order creation page, after entering the user's name and email, you can choose to send an order creation reminder email. This email will remind the user to click the link in the email to make the payment.

When creating an order, after entering the customer's name, email, and selecting email notification, the customer will receive a payment reminder email. If email notification is not selected, the customer will not receive this email.
LinkPay Refund#
In transaction details interface, you can perform refund operations in the upper right corner.

You can fill in the refund amount and refund description.

Option to Integrate with LinkPay#
With the selected API, merchants can integrate with LinkPay in different ways. | Option 1 | Option 2 | Option 3 | Option 4 |
---|
Selected API(s) | - N/A | - LinkPay API | - LinkPay API - Retrieve LinkPay API - Notification | - LinkPay API - Retrieve LinkPay API - Notification - Refund API |
How to create Payment order | - EVO Cloud Portal | - API "LinkPay" | - API "LinkPay" | - API "LinkPay" |
How to get the payment result | - EVO Cloud Portal | - Notification - EVO Cloud Portal | - Notification - Retrieve LinkPay API - EVO Cloud Portal | - Notification - Retrieve LinkPay API - EVO Cloud Portal |
How to refund | - EVO Cloud Portal | - EVO Cloud Portal | - EVO Cloud Portal | - Refund API - EVO Cloud Portal |
If the merchant wants to receive the payment result by a notification, the merchant needs to send the webhook address when creating the LinkPay Order and requesting the LinkPay Payment Link.
The merchant can obtain the payment result and related transaction information using either Retrieve LinkPay API or notification.
Modified at 2025-07-18 02:09:29