Banks
Decode VietQR
Decode a VietQR string or image URL into structured payment information.
POST
Overview
Partners can decode a VietQR string or QR image URL into structured payment information — bank BIN code, destination account number, amount, and purpose. Pass exactly one ofqr_string or qr_image_url per request.
Authentication
Your partner app key.
Base64-encoded Ed25519 signature of the sign data.
Unix timestamp (seconds) of the request. Must be within 60 seconds of server time.
Body Parameters
Raw VietQR string. Mutually exclusive with
qr_image_url.HTTPS URL pointing to a QR code image. Mutually exclusive with
qr_string.Error Codes
When decoding fails, the response includes a non-zeroerror_code: