VNPAY Demo Portal

Integrate and test VNPAY Sandbox payment flows in your browser.

VI EN

Sandbox

— flow groups — features 9/9 flows ready

Operations

Management & Lookup

Track transactions, query results, and process refunds — for all merchant connections.

Transaction management Full list: status, amount, VNPAY code, per-flow details. View list Query result (QueryDR) Check transaction status via API. Select flow and TMN — Secret Key handled on server. Open query form Refund Full or partial refund. Credentials per flow, Secret Key on server. Open refund form Audit log INBOUND callback and OUTBOUND API call history — filter by flow, paginated. View log

Recent transactions

View all

The transaction list requires the demo login.

Show transactions

Payment gateway

Direct payment

Standard PAY flow — redirect customer to VNPAY gateway.

PAY

Create payment URL, handle Return & IPN

Ready

2

Create payment transaction Build the payment URL and redirect to VNPAYvpcpay.html Payment API v2.0.0 (SHA256) SHA256(hashSecret + hashData) signaturev2.0.0

Card token & Recurring

Token & Recurring

Manage card tokens and register automatic periodic payments.

Token

Create, pay with, and remove card tokens

Ready

4

Create token Save a card for later payments Pay + save token Pay and save the card in one step Pay with token Charge a saved token Remove token Unlink a saved card

Recurring

Register, charge, update, and cancel

Ready

5

Register recurring payment Create a recurring payment contract Recurring payment Charge recurring via token Update card Change the card used by the contract Update cycles Adjust cycles and total amount Cancel registration Stop the recurring contract

Extended products

Installment, PreAuth & Merchant

ISP, PreAuthorize, Payment Link, Merchant Hosted, VCB Merchant, and BIDV corporate IB flows.

Installment

Info → Init → Pay

Ready

3

Query installment config Banks, card types and terms by amount Initialize installment Create an installment transaction Installment payment Go to the VNPAY installment gateway

PreAuth

Token → Authorize → Capture

Ready

5

Initialize pre-authorization Link a card and create a token/payment/create-token Authorize with token Hold funds with the token/payment/authorize Capture transaction Capture the held amount/payment/capture Reversal (cancel) Release the held amount/payment/reversal Remove token Delete the saved card token/payment/remove-token

Payment Link

Create → Pay → IPN → Cancel

Ready

2

Create Payment Link Create a link to send to customers/create-payment-link Cancel Payment Link Disable an existing link/cancel-payment-link

Merchant Hosted

Execute, OTP, QR gen

Ready

3

Query payment configuration Banks and payment methods per terminal/category/payment-info Create Merchant Hosted payment Enter the card at the merchant, confirm OTP/payment/execute VNPAY-QR (genqr) QR code, IPN and banking app deep-linkgenqr

VCB Merchant

Vietcombank gateway (Ngan Luong)

Ready

2

Pay via VCB gateway Redirect to the VCB checkout pageCreateOrder v1.0 VCB QR on merchant page Show the QR right on the merchant pageCreateOrder v2.0

BIDV Corporate IB

Init → Create order on IB → Approve → IPN

Ready

3

Initiate business payment OAuth + /payment/init, redirect to VNPAY/payment/init Pay with bpId + dataKey POST form /payment/pay/payment/pay Cancel transaction /payment/cancel/payment/cancel