---
title: "Tạo giao dịch tiền vào giả"
method: POST
path: "/api/v1/sandbox/transactions"
tags: ["Sandbox"]
---

# Tạo giao dịch tiền vào giả

`POST /api/v1/sandbox/transactions`

## Request

- Base URL: `https://api.monapay.vn`
- URL: `https://api.monapay.vn/api/v1/sandbox/transactions`
- Auth: HTTP bearer and API key in header `X-Client-Secret`

Chạy được trước khi nối ngân hàng: MONA Pay tự tạo hoặc dùng lại VA sandbox SBX. Nếu truyền VA thật đã nối thì dùng VA đó. Giao dịch đi qua webhook, Telegram, email và checkout matcher nhưng không chuyển tiền thật, không tính hạn mức.

## Request body

- SandboxTransactionCreate: Tạo giao dịch tiền vào giả. Bỏ trống số tài khoản để MONA Pay tự tạo hoặc dùng lại VA sandbox SBX của client.
  - `virtual_account_number` string: VA thật đã nối hoặc VA sandbox SBX; không bắt buộc.
  - `account_number` string: Tài khoản thật đã nối; không bắt buộc.
  - `amount` integer, required: Số tiền giả, đơn vị VND.
  - `description` string, required: Nội dung chuyển khoản giả.
  - `transaction_code` string: Mã tuỳ chọn để thử chống trùng; hệ thống tự sinh SANDBOX-… khi bỏ trống.

## Response `200`

Giao dịch sandbox đã được chấp nhận để xử lý.

- object
  - `success` boolean, required
  - `message` string, required
  - `data` SandboxTransaction, required
    - `transaction_code` string, required
    - `virtual_account_number` string, nullable, required: VA chỉ định hoặc VA sandbox tự cấp, bắt đầu bằng SBX khi client chưa nối ngân hàng; null khi chỉ định tài khoản thật.
    - `account_number` string, required
    - `amount` integer, required
    - `is_sandbox` true, required

## Other responses

- `401`: Bearer token không hợp lệ hoặc hết hạn.
- `403`: Thiếu hoặc sai X-Client-Secret.
- `422`: Body không hợp lệ hoặc tài khoản được chỉ định không thuộc client.

---

[API](https://skmtc.dev/monapay/apis/mona-pay-api-v1.md) · [All operations](https://skmtc.dev/monapay/apis/mona-pay-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/monapay/apis/mona-pay-api-v1/revisions/ed3fbd821dce?raw)