Skip to main content

Introduction

Napas uses a redirect-based payment flow. When a customer selects Napas at checkout, they are redirected to their bank’s authentication interface to confirm the payment, then redirected back to your website or app upon completion. Napas is a single-use payment method where customers must authenticate each payment. This guide explains the process of integrating Napas into your app or website using Payrails.

Pre-requisites

Before you start accepting Napas payments with Payrails, there are a few requirements you must meet:

Ways to integrate Napas

Payrails SDK

Server-to-server integration

Parse Napas from lookup response

Pass Napas 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—for example, 700000 for ₫7,000.
Napas is a redirect-based, single-use payment method. After calling the authorize endpoint, the customer will be redirected to their bank’s authentication interface to confirm the payment. Once confirmed, the customer will be redirected back to the returnInfo.success URL. Make sure to provide valid returnInfo URLs in your authorization request.

Handle the redirect response

Supported currencies

Napas via dLocal supports the following presentment currency:
  • VND — Vietnamese Dong

Supported regions / countries

Customer regions

Napas is available to customers based in:
  • Vietnam 🇻🇳

Merchant regions

Merchants enabled for Vietnam can accept Napas payments via dLocal.

Supported workflows and services

Last modified on September 28, 2026