> AI của bạn tự tạo mã VietQR nạp ví MONA Cloud và in ngay trong terminal Claude Code, Codex hay Gemini; bạn chỉ quét bằng app ngân hàng, tiền vào tự cộng ví.

Nguồn: https://monacloud.vn/docs/vi-va-nap-tien · Cập nhật: 2026-09-19

# Ví VND và nạp tiền bằng VietQR

Ví VND giữ số tiền để trả phí hạ tầng MONA Cloud. Bạn không cần mở console để nạp: AI của bạn (Claude Code, Codex, Gemini CLI) gọi `cloud_topup`, MONA Cloud trả mã VietQR in ngay trong terminal, bạn mở app ngân hàng quét và chuyển. Tiền vào tự cộng ví, AI đọc lại số dư rồi làm tiếp. Sandbox vẫn thử được miễn phí.

## AI nạp ví giúp bạn theo những bước nào?

1. AI thấy ví thiếu (`cloud_balance` thấp hoặc lỗi `insufficient_funds`) thì gọi `cloud_topup` với số tiền cần nạp, tối thiểu 10.000đ.
2. MCP trả `qr_ascii` (QR bằng ký tự khối, in thẳng trong terminal), `qr_file` (ảnh PNG lưu tại `~/.config/monacloud/`) và `qr_url` (ảnh VietQR). AI in nguyên khối QR kèm ngân hàng, số tài khoản, số tiền và nội dung chuyển khoản.
3. Bạn mở app ngân hàng, quét QR trên màn hình (terminal hiển thị mờ thì mở file hoặc link ảnh), kiểm tra người nhận, số tiền, nội dung rồi chuyển. Giữ đúng nội dung để hệ thống khớp yêu cầu nạp của tài khoản bạn.
4. Tiền vào tự cộng ví trong vài giây. AI gọi `cloud_topup_status(topup_id)` hoặc `cloud_balance` để xác nhận rồi tiếp tục việc đang làm. Không tạo lại yêu cầu nạp khi chưa thấy tiền vào.

Mỗi QR gắn với một yêu cầu nạp của chính tài khoản bạn. Chỉ quét QR do AI của bạn vừa tạo trong phiên làm việc, không quét QR người khác gửi. Console vẫn có trang ví để nạp tay và xem lịch sử nếu bạn muốn.

## QR hiện trong terminal thế nào?

Claude Code, Codex và Gemini CLI không vẽ ảnh PNG từ kết quả tool, nên MCP tự dựng chuỗi VietQR chuẩn EMVCo (NAPAS) rồi in bằng ký tự khối; app ngân hàng quét được trực tiếp trên màn hình. Kèm theo là file PNG và link ảnh để bạn chọn cách quét tiện nhất.

**Kiểm thử 17/09/2026:** yêu cầu nạp tạo qua API compute, chuyển khoản thật, tiền cộng ví tự động (webhook báo có trả 200, số dư cập nhật đúng).

Nếu gặp lỗi, giữ mã yêu cầu không chứa bí mật và gọi [1900 636 648](tel:1900636648); không chuyển tiền khi thông tin nhận chưa rõ.

## API tạo yêu cầu nạp thế nào?

`cloud_topup` gọi endpoint này bằng token MONA Pass hoặc API token của bạn. Đường ví chung `billing.monacloud.vn/v1/topups` sẽ thay thế khi cấu hình merchant MONA Pay xong; MCP tự chọn đường đang hoạt động, bạn không cần đổi gì.

Tạo yêu cầu nạp VietQR qua API compute

```
curl -sS -X POST "$MONACLOUD_API/api/payments/vietqr" \
  -H "Authorization: Bearer $MONACLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount":50000}'
```

Đọc `payment_id`, `amount`, `description` (nội dung chuyển khoản), `qr_url`, `status`; dùng `GET /api/payments/{payment_id}` để xem trạng thái `pending` → `paid`. Schema nhận từ 10.000đ đến 500.000.000đ.

## Tiền bị trừ và dừng máy thế nào?

Giá theo giờ: CPU 250đ/core/giờ · RAM 150đ/GB/giờ · Disk 15đ/GB/giờ. Đọc ngân sách và số dư trước việc tốn tiền; gặp 402 thì xử lý nguyên nhân, không tự bỏ hạn mức.

**Stop vẫn còn phí:** máy dừng vẫn giữ disk/IP. Lịch nhắc trước và thời gian giữ dữ liệu khi hết ví cần đối chiếu theo chính sách của tài khoản hiện tại.

## Credit đăng ký và mã credit đã có chưa?

Credit tặng **100.000đ khi đăng ký** đã LIVE. Console đã có đổi mã credit bằng `POST /api/credit-codes/redeem` hoặc MCP `cloud_credit_redeem`. Gói tháng và hoá đơn VAT 10% mỗi tháng đã LIVE; xem [gói tháng và hoá đơn](https://monacloud.vn/docs/goi-thang-va-hoa-don).

## Prompt mẫu cho AI

Prompt kiểm tra số dư và nạp VietQR · không chứa secret

```
Kiểm tra số dư và ngân sách trước khi tạo máy. Nếu ví thiếu, gọi cloud_topup đúng số tiền cần, in nguyên khối qr_ascii kèm ngân hàng, số tài khoản, số tiền và nội dung để tôi quét bằng app ngân hàng; không bảo tôi mở console, không lấy token qua chat. Sau khi tôi báo đã chuyển, gọi cloud_topup_status tới khi paid rồi làm tiếp; chưa có số dư xác nhận thì chỉ dùng sandbox.
```