Bạn là developer và muốn tạo mã QR VietQR một cách nhanh chóng và dễ dàng? API VietQR.IO chính là "cứu cánh" của bạn! Bài viết này sẽ cung cấp thông tin chi tiết về API, từ cách thức hoạt động, các thông số "vàng" cần thiết đến cách tạo link ảnh QR và nhúng vào website. Liệu API này có giúp bạn tăng 80% tỷ lệ chuyển đổi? Hãy cùng khám phá ngay! 🚀
Key Takeaways:
Tuyệt vời! Hãy cùng tôi hoàn thiện các phần heading này theo yêu cầu.
Bạn là một developer và đang muốn tích hợp thanh toán VietQR vào ứng dụng của mình? 🚀 API tạo mã QR VietQR.IO chính là "công cụ" không thể thiếu! Hãy cùng tôi "mổ xẻ" chi tiết về API này để bạn có thể sử dụng nó một cách hiệu quả nhất.
API này cho phép bạn tạo mã QR dựa vào thông tin tài khoản nhận tiền. Để sử dụng API, bạn cần phải có Client ID và API Key để xác thực. Bạn có thể lấy thông tin này tại trang My VietQR.
Để tạo mã QR thành công, bạn cần phải cung cấp đầy đủ và chính xác các thông số trong Request Body. Hãy cùng tôi "giải mã" ý nghĩa của từng thông số:
| Thông số | Bắt buộc | Mô tả | Định dạng | ||
|---|---|---|---|---|---|
| `accountNo` | Có | Số tài khoản ngân hàng thụ hưởng. | String (6-19 ký tự, chỉ số) | ||
| `accountName` | Không | Tên tài khoản ngân hàng. | String (5-50 ký tự, tiếng Việt không dấu, viết hoa) | ||
| `acqId` | Có | Mã định danh ngân hàng (BIN) 6 chữ số. | Integer | ||
| `amount` | Không | Số tiền chuyển. | Integer (tối đa 13 ký tự) | ||
| `addInfo` | Không | Nội dung chuyển tiền. | String (tối đa 25 ký tự, tiếng Việt không dấu) | ||
| `format` | Không | Định dạng VietQR trả về. | String | ||
| `template` | Không | Mẫu VietQR trả về. | String |
template: Tạo Mã QR Theo Phong Cách RiêngTrường template cho phép bạn tùy chỉnh giao diện của mã QR. Bạn có thể lựa chọn một trong các giá trị sau:
compact: Mã QR, logo, thông tin chuyển khoản (2540x640).compact540x540: QR kèm logo VietQR, Napas, ngân hàng.qr_only: Ảnh QR đơn giản (480x480).print: Mã QR, logo, đầy đủ thông tin chuyển khoản (600x776).Tôi thường sử dụng qr_only để tạo những mã QR đơn giản và dễ quét. Còn bạn, bạn thích mẫu nào nhất? 🤔
Sau khi tạo mã QR thành công, API sẽ trả về một JSON object chứa các thông tin quan trọng. Hãy cùng tôi "giải mã" ý nghĩa của từng trường dữ liệu:
qrCode: Mã QR dạng văn bản. Bạn có thể sử dụng mã này để hiển thị mã QR trên website hoặc ứng dụng của mình.qrDataURL: Ảnh QR dưới định dạng Data URI. Bạn có thể sử dụng Data URI để nhúng hình ảnh vào website hoặc hiển thị lên trình duyệt mà không cần phải tải ảnh lên server.Tuyệt vời! Chúng ta sẽ hoàn thành nốt hai phần heading cuối cùng này để có một bài viết hoàn chỉnh.
Bạn muốn tạo link ảnh QR để chia sẻ cho bạn bè, người thân hoặc khách hàng của mình? Thật đơn giản! Hãy sử dụng cấu trúc link sau:
https://qr.sepay.vn/img?acc=SO_TAI_KHOAN&bank=NGAN_HANG&amount=SO_TIEN&des=NOI_DUNG
Trong đó:
SO_TAI_KHOAN: Số tài khoản ngân hàng (bắt buộc).NGAN_HANG: Code ngân hàng hoặc Short_name (bắt buộc). Bạn có thể tham khảo danh sách tại đây.SO_TIEN: Số tiền cần chuyển.NOI_DUNG: Nội dung chuyển khoản.TEMPLATE: Template cho ảnh QR (để trống, compact hoặc qronly).DOWNLOAD: Tải QR về máy (true để tải về).Bạn muốn nhúng ảnh QR vào website của mình để khách hàng có thể thanh toán một cách dễ dàng? Hãy sử dụng thẻ <img> với thuộc tính src là link ảnh QR đã tạo:
html<img src='https://qr.sepay.vn/img?acc=SO_TAI_KHOAN&bank=NGAN_HANG&amount=SO_TIEN&des=NOI_DUNG'/>
Khi nhúng ảnh QR vào website, bạn nên chú ý đến kích thước và vị trí của ảnh để đảm bảo tính thẩm mỹ và dễ sử dụng. Tôi thường đặt ảnh QR ở vị trí dễ thấy, gần nút thanh toán hoặc thông tin tài khoản ngân hàng. 👍
Bình luận
.jpg)
