POSTMới/api/v2/sandbox/lookup

Môi trường thử nghiệm Sandbox

Môi trường giả lập tích hợp không trừ tiền, cho phép lập trình viên mô phỏng mọi tình huống phản hồi (Thành công, Sai số tài khoản, Hết tiền, Ngân hàng bảo trì).

Endpoint

POSThttps://api.tracuubank.net/api/v2/sandbox/lookup

Các kịch bản giả lập (mock_scenario)

Truyền trường mock_scenario trong body request để nhận kết quả giả lập tương ứng.

Kịch bản (mock_scenario)	Mã HTTP	Kết quả mô phỏng
SUCCESS	200 OK	Trả về tên tài khoản thụ hưởng thành công
ACCOUNT_NOT_FOUND	422 NOT_FOUND	Mô phỏng số tài khoản không tồn tại tại ngân hàng
OUT_OF_CREDIT	402 Payment	Mô phỏng tài khoản hết số dư khả dụng
BANK_MAINTENANCE	500 Error	Mô phỏng Napas hoặc ngân hàng đích bảo trì hệ thống

Mẫu cURL tham khảo

bash

curl -X POST "https://api.tracuubank.net/api/v2/sandbox/lookup" \
  -H "x-api-key: SANDBOX_KEY_DEMO" \
  -H "x-api-secret: SANDBOX_SECRET_DEMO" \
  -H "Content-Type: application/json" \
  -d '{
    "bank": "VCB",
    "account": "8888888888",
    "mock_scenario": "SUCCESS"
  }'

Header (Bắt buộc)

Các giá trị Header khi thực hiện Request Sandbox.

Header	Required	Data type	Description
x-api-key	Bắt buộc	string	API Key Sandbox (hoặc Live Key)
x-api-secret	Bắt buộc	string	API Secret Sandbox (hoặc Live Secret)

Body (JSON) (Bắt buộc)

Payload	Required	Data type	Description
bank	Bắt buộc	string	Mã ngân hàng (VD: `VCB`, `MB`)
account	Bắt buộc	string	Số tài khoản cần tra cứu thử nghiệm
mock_scenario	Tùy chọn	string	Mã kịch bản (mặc định là `SUCCESS`)

Example Payload (JSON)

json

{
    "bank": "VCB",
    "account": "8888888888",
    "mock_scenario": "SUCCESS"
}