Introduction
VietQR uses a redirect-based payment flow. When a customer selects VietQR at checkout, they are redirected to a hosted page displaying a QR code. The customer scans the QR code using their banking app to confirm payment, then returns to your website or app upon completion. VietQR is a single-use payment method. This guide explains the process of integrating VietQR into your app or website using Payrails.Pre-requisites
Before you start accepting VietQR payments with Payrails, there are a few requirements you must meet:Ways to integrate VietQR
Payrails SDK
Server-to-server integration
Parse VietQR from lookup response
Pass VietQR payment method in request to authorize payment with Payrails
Note on amountsVND uses 2 decimal places but is typically quoted as whole numbers. Amounts should be provided in the smallest currency unit.
VietQR is a redirect-based, single-use payment method. After calling the authorize endpoint, the customer will be redirected to a hosted page displaying a QR code. The customer scans this with their banking app to confirm payment. Once confirmed, the customer will be redirected back to the
returnInfo.success URL.Handle the redirect response
Supported currencies
VietQR via dLocal supports the following presentment currency:- VND — Vietnamese Dong