Công cụ AI — Thanh toán

6 công cụ. Schema luôn mới nhất ở payment_tool_catalog khi đã kết nối.

Chi tiết yêu cầu thanh toán

ĐọcScope: payment:read

payment_intents_get

Chi tiết một yêu cầu thanh toán: số tiền, kênh thanh toán, trạng thái và chứng từ tham chiếu.

Tham số	Kiểu	Bắt buộc	Mô tả
`id`	string	có	Id yêu cầu thanh toán

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/payment/payment_intents_get/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"id":"0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "payment_intents_get",
  "arguments": {
    "args": {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Khoản hoàn tiền

ĐọcScope: payment:read

payment_refunds_search

Danh sách khoản hoàn tiền, lọc theo trạng thái, khoảng ngày và từ khoá; có phân trang.

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	Trạng thái hoàn tiền
`from`	string	không	Từ ngày (yyyy-MM-dd)
`to`	string	không	Đến ngày (yyyy-MM-dd)
`search`	string	không	Từ khoá
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/payment/payment_refunds_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"from":"2026-10-01","to":"2026-10-27","pageSize":20}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "payment_refunds_search",
  "arguments": {
    "args": {
      "from": "2026-10-01",
      "to": "2026-10-27",
      "pageSize": 20
    }
  }
}

Tổng quan thanh toán

ĐọcScope: payment:read

payment_reports_overview

Tổng quan thanh toán trong một khoảng ngày: số giao dịch và số tiền theo kênh, theo trạng thái. Bỏ trống ngày thì lấy một tháng gần nhất.

Tham số	Kiểu	Bắt buộc	Mô tả
`from`	string	không	Từ ngày (yyyy-MM-dd)
`to`	string	không	Đến ngày (yyyy-MM-dd)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/payment/payment_reports_overview/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"from":"2026-10-01","to":"2026-10-27"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "payment_reports_overview",
  "arguments": {
    "args": {
      "from": "2026-10-01",
      "to": "2026-10-27"
    }
  }
}

Thuê bao thanh toán định kỳ

ĐọcScope: payment:read

payment_subscriptions_search

Danh sách thuê bao thanh toán định kỳ, lọc theo trạng thái, loại chứng từ và kênh; có phân trang.

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	Trạng thái thuê bao
`referenceType`	string	không	Loại chứng từ nguồn
`providerCode`	string	không	Mã kênh thanh toán
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/payment/payment_subscriptions_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"status":"ACTIVE"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "payment_subscriptions_search",
  "arguments": {
    "args": {
      "status": "ACTIVE"
    }
  }
}

Chi tiết giao dịch thanh toán

ĐọcScope: payment:read

payment_transactions_get

Chi tiết một giao dịch thanh toán.

Tham số	Kiểu	Bắt buộc	Mô tả
`id`	string	có	Id giao dịch (lấy từ payment_transactions_search)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/payment/payment_transactions_get/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"id":"0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "payment_transactions_get",
  "arguments": {
    "args": {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Giao dịch thanh toán

ĐọcScope: payment:read

payment_transactions_search

Danh sách giao dịch thanh toán, lọc theo kênh, loại chứng từ, khoảng ngày và từ khoá; có phân trang.

Tham số	Kiểu	Bắt buộc	Mô tả
`providerCode`	string	không	Mã kênh thanh toán (vd VIETQR, VNPAY)
`referenceType`	string	không	Loại chứng từ nguồn (vd đơn bán, hợp đồng)
`fromDate`	string	không	Từ ngày (yyyy-MM-dd)
`toDate`	string	không	Đến ngày (yyyy-MM-dd)
`search`	string	không	Từ khoá
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/payment/payment_transactions_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"providerCode":"VIETQR","fromDate":"2026-10-01","toDate":"2026-10-27"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "payment_transactions_search",
  "arguments": {
    "args": {
      "providerCode": "VIETQR",
      "fromDate": "2026-10-01",
      "toDate": "2026-10-27"
    }
  }
}