> For the complete documentation index, see [llms.txt](https://docs.galaxypay.vn/upc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.galaxypay.vn/upc/payment-gateway/payment-solution/pay-with-qr.md).

# Pay with QR

A payment method where users utilize a banking app or e-wallet app that supported VietQR to scan the merchant's QR code (Quick Response code) to process the payment.

## Workflow

<figure><img src="https://2641250035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsgaBspD43q4t10IJ2CD8%2Fuploads%2FiDFpDFKFUkpxjcpWCAqz%2FQR%20Payment.png?alt=media&amp;token=87df4c80-b1eb-4092-9053-d66e1330e031" alt=""><figcaption></figcaption></figure>

## Customer journey

{% file src="/files/4CszaHheVNX3BIyMQYd9" %}

### Description

{% 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 Payment method = QR PAYMENT.
2. Customer clicks "Submit" to proceeds to complete  the payment.

<figure><img src="https://2641250035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsgaBspD43q4t10IJ2CD8%2Fuploads%2FDQgrb0w2XDzGtsyTZRj5%2Fimage.png?alt=media&amp;token=533ab9ab-a291-4fa6-93b3-ee2f1d046712" alt=""><figcaption></figcaption></figure>

3. The payment flow is launched, the user is navigated through a secured Galaxy Pay environment that reflects the transaction ID.

<figure><img src="https://2641250035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsgaBspD43q4t10IJ2CD8%2Fuploads%2FntXK5NG2QDvQkBtaB2CH%2Fimage.png?alt=media&amp;token=7ad859c8-1aaf-4dac-8885-ca8c0b4a1786" alt=""><figcaption></figcaption></figure>

4. Galaxy Pay Payment's page show QR code and Transaction information.

<figure><img src="https://2641250035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsgaBspD43q4t10IJ2CD8%2Fuploads%2FYn1GUXAmaYrZBteyo4Xq%2Fimage.png?alt=media&amp;token=0714e5a4-086c-4306-9c93-58e0945bdf37" alt=""><figcaption></figcaption></figure>

5. Customer scans the QR code and make payments with  a VietQR supported banking app or e-wallet.
6. The customer is shown (failed/successful) on merchant website based on the transaction status from Galaxy Pay.

<figure><img src="https://2641250035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsgaBspD43q4t10IJ2CD8%2Fuploads%2FrHpGU9b9L5Vd7XdZgikx%2Fimage.png?alt=media&amp;token=454f3218-df82-4ce6-9fda-a1a736d103ed" alt=""><figcaption></figcaption></figure>

## Benefits of Pay with QR

1. **Adaptable to All Business Sizes**: Whether it’s a large enterprise or a small business, QR payments can be tailored to meet diverse operational needs without requiring significant investment.
2. **High Security**: Transactions are encrypted and authenticated, ensuring customer data remains protected without requiring manual input or sensitive information disclosure.
3. **Faster Processing**: Enables quick payments by simply scanning a QR code, reducing checkout times and improving efficiency.
4. **Flexible Integration**: Can be seamlessly integrated into websites, mobile apps, in-store systems, and even billing platforms for a unified payment solution.

## Integration

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

## Test Integration

*<mark style="color:orange;">**If you test QR Pay Payment in the UAT environment of Galaxy Pay,**</mark>* *you can test on* [QR Pay Test page](https://uat-demo.galaxypay.vn/VietQr-Test). *This page simulates scanning the QR code using a banking app or e-wallet app supported VietQR.*

1. Get the transaction ID and transaction amount.

<figure><img src="https://2641250035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsgaBspD43q4t10IJ2CD8%2Fuploads%2FRXH6ZHDsw7iJ4jCGePFd%2Fimage.png?alt=media&amp;token=06dbaf03-3720-4e47-8e55-01a5ce191bc1" alt=""><figcaption></figcaption></figure>

2. Open [QR Pay Test page](https://uat-demo.galaxypay.vn/VietQr-Test) and enter the Transaction ID and transaction amount. Then click "Submit".

<figure><img src="https://2641250035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsgaBspD43q4t10IJ2CD8%2Fuploads%2FMaQhnNfWiXbdoN56fqPN%2FScreenshot%202025-01-08%20101748.png?alt=media&amp;token=9f7a7a78-7738-4745-9fde-41c7a74cec6d" alt=""><figcaption></figcaption></figure>

3. Back to merchant website, the customer is shown (failed/successful) on merchant website based on the transaction status from Galaxy Pay.