LinkPay Integration Step

Get a Payment Link

Follow the steps below to build your API request and obtain a payment link (LinkUrl).

Once you receive the payment link, you can redirect the user to the LinkPay Payment Page. On the LinkPay Payment Page, the user can select a payment method and complete the payment.

📘

Note

If you have built your own checkout page and want the user to select the payment method within your checkout, simply pass the enumerated value of the selected payment method into the merchantOrderInfo.enabledPaymentMethod field when calling the POST interaction API. For example:

JSON

"enabledPaymentMethod": ["Boost"]

The name and logo of each payment method should be displayed on your checkout page. You can download them here: Payment Method Names & Logos

For more parameter details, please refer to the POST interaction API.

Receive the Payment Result

Via Webhook

If you include a webhook URL in the POST interaction request, you will receive a payment result notification via Webhook when the payment succeeds.

For parameters, see the API Explorer: interaction Notification

Via returnURL

If you include a returnURL in the POST interaction request, Evonet will append the payment result to the returnURL and redirect the user back to the merchant site once the payment succeeds.

📘

Example

If your returnURL is:

https://www.merchant.com

After the payment is completed successfully, Evonet will redirect the user to:

https://www.merchant.com?merchantOrderID=123123123123&result=success

Retrieve the Payment Result

Follow the steps below to retrieve the payment result of a LinkPay order you created.

Use GET and append merchantOrderID to the request URL to obtain the payment result.

How to determine if the payment was successful: In the Retrieve the Payment Result API response or in an asynchronous notification, check the following fields:

"result.code": "S0000"
"merchantOrderInfo.status": "Paid"
"transactionInfo.status": "Capture"

For more parameter details, see the GET interaction API

Refund the LinkPay Order

Use POST /payment/{merchantTransID}/refund to initiate a full or partial refund for an order that has already been successfully paid.

📘

merchantTransID must be obtained from transactionInfo.merchantTransInfo.merchantTransID in the retrieval response or in an asynchronous notification.

Retrieve the Refund Result

Use GET /payment/{merchantTransID} to query the refund status.