# Merchant Hosted Checkout

Merchant Hosted Checkout integration is used to process payment method page on merchant website using Galaxy Pay. You can control your transactions, manage your payment pages, and collect payment details. After collecting payment information on your website, the transaction is redirected to Galaxy Pay via API for processing, ensuring a seamless and secure payment experience. 

## Workflow

<figure><img src="/files/HIcOgUCXyyJpBxOyeoOb" alt=""><figcaption></figcaption></figure>

1. The payer purchases and provides the card details directly to the merchant's application or website.
2. The application or website creates the transaction request and sends it to GalaxyPay's gateway through an API call.
3. The gateway passes the transaction to the bank or Service provider for processing.
4. The Service provider returns a response to GalaxyPay's gateway.
5. GalaxyPay's gateway generates a transaction response and passes it to merchant's application or website, in response to your API call. The transaction response indicates whether the transaction was successful and includes other response data.

   Based on the result of the transaction, the application or website displays a receipt, other confirmation, or an error page to the payer.

## Customer journey

The follow sample customer journey is for payment method = INTERNATIONAL CARD:

{% hint style="info" %}
View information about terms/definitions in [Glossary](/upc/payment-gateway/appendix/glossary.md)
{% endhint %}

1. Customer completes order information and initiates a transaction with a payment method (for example, INTERNATIONAL Card)
2. Customer enters card information: Card number, Card holder name, card issue date/expired date and CVV. Then clicks "Submit" to proceeds to complete  the payment.

<figure><img src="/files/cIDPsQYX9kLlmItL3Px3" alt=""><figcaption></figcaption></figure>

3. After the credentials are entered, and the payment flow is launched, the user is navigated through a secured Galaxy Pay environment that reflects the transaction ID.

<figure><img src="/files/kEStzgoVIZIuxKrXaarr" alt=""><figcaption></figcaption></figure>

4. The flow takes the user to the login ACS page of the bank, where the user needs to complete the transaction by using the OTP sent by the bank to the registered mobile number.

<figure><img src="/files/zjFnHHXjxoy03kWWPyqf" alt=""><figcaption></figcaption></figure>

5. The customer is shown (failed/successful) on merchant website based on the transaction status from Galaxy Pay

<figure><img src="/files/hsNiZTMFPJSi4rgpsNXg" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ZFPGSDAsVd6zZ27iKO2X" alt=""><figcaption></figcaption></figure>

## Benefits of Merchant Hosted Checkout

* Control over the payment experience. It also provides flexibility to customize your payment solution.
* Integration with any application, website, call center, billing system, or Interactive Voice Response (IVR) system.
* Communicate directly with the gateway and then, receive a real-time response to the API call. This is a synchronous connection where a payer does not leave your application, which means your session with the payer is not interrupted.
* Support for advanced gateway operations, such as captures, refunds, voids, and queries, where the payer is not directly involved.

## Prerequisites

The prerequisites for integrating with Merchant Hosted Checkout are:

* Develop a business application or website to collect the complete payment details of the customers.
* Merchant must have already registered for PCI compliance, which is mandatory for all entities seeking to store, process, and transmit cardholder data.
* You must have an understanding of the following concepts:
  * workflows
  * various payment processes
  * website designing fundamentals
  * Usability (UX) management principles necessary to build the complete online payments infrastructure on your website.
* Sufficient technical bandwidth dedicated to managing the end-to-end web checkout processes in-house consistently.

## Integration

See integration detail in [General integration steps](/upc/payment-gateway/payment-solution/general-integration-steps.md) and API fields in [here](/upc/payment-gateway/api-specification/payment/pay.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.galaxypay.vn/upc/payment-gateway/payment-solution/merchant-hosted-checkout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.