Korean Hosted Payment Page (KHPP)

The Difference Between the Hosted Payment Page & the Korean Hosted Payment Page

Ezypay has built a new new hosted payment page - Korean Hosted Payment Page (KHPP) to cater for Korean payment methods. If a merchant requires collection from payment methods in Korea, then this Korean Hosted Payment Page (KHPP) can be used as part of the integration.

The existing Hosted Payment Page (HPP) supports the creation of payment methods for all countries except South Korea. Generally the integration for the existing Hosted Payment Page (HPP) will be like the diagram below:

The main difference between the 2 hosted payment pages are:

Getting to the hosted payment page is via a redirect, rather than via an embedded iframe.
Slight differences between the input and output parameters.
Returning to your web application from the Korean hosted payment page will be via a redirect back, instead of just a data field being available in your page’s DOM.

📘
If you require information on the Hosted Payment Page (HPP) for other countries, the details can be found in this section.
https://developer.ezypay.com/docs/hosted-payment-page

The Korean Hosted Payment Page (KHPP)

Below is a process flow on how the Korean Hosted Payment Page will work:

*Input Parameters

Parameter	Description	Type	Allowed Values	Required
token	Ezypay’s auth token (with hosted_payment scope).	String	N/A	Yes
successUrl	The URL to redirect to once an outcome is reached. We will redirect to this URL regardless of whether we have successfully / unsuccessfully created a payment method token.	String - URL	N/A	Yes
cancelUrl	The URL to redirect to if the user clicks on the ‘Cancel’ button. A payment method token would not have been created.	String - URL	N/A	Yes
merchant	The name of the merchant, to be displayed in the KHPP.	String	N/A	Yes

Output Parameters

Parameter	Description	Type	Example
paymentMethodToken	The newly created payment method token, if successfully created.	UUID	538d8e17-eda3-4227-b129-f6d3e2916fe2
errorCode	The error code provided from the HPP process if the status was FAILURE.	String	(see table below)
errorMessage	The human friendly description of the error code from the HPP process, if the status was FAILURE.	String	(see table below)
status	The status of the HPP process, whether it was successful or not.	String	SUCCESS / FAILURE

Expected Outcomes of the Korean Hosted Payment Page (KHHP)

If the KHHP successfully creates a payment method token, the KHPP would redirect to the successUrl like so:
redirect to https://integrator.com/result?paymentMethodToken=TOKEN&status=SUCCESS

If the KHHP fails to create a payment method token the KHPP would redirect to the successUrl like so:
redirect to https://integrator.com/result?status=FAILURE&errorCode=invalid_card_number&errorDescription=”Invalid card number provided"

If the user selected the ‘Cancel’ button on the page, the KHPP would redirect to the cancelUrl with no additional parameters. For example, if the cancelUrl was https://integrator.com/cancel, the KHPP would:
redirect to https://integrator.com/cancel

Error Codes/Responses in the Case of Failure

Code	Description
COMMUNICATION_ERROR	An error occurred connecting to our payment provider