nextX

Thanh toán

Chỉ đọc — payment intent, hoàn tiền, giao dịch, gói đăng ký và báo cáo thanh toán.

6 endpoint · base /api/v1/payment

GET/api/v1/payment/intents/{id}Thử ngay ▶

Chi tiết 1 payment intent.

Tool MCP: payment_get_intentScope: payment.intents.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
idGUIDpathcó—

Ví dụ

curl https://api.nextx.vn/api/v1/payment/intents/<id> \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "intentId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "status": "string",
  "providerCode": "string",
  "paymentUrl": "string",
  "qrCodeData": "string",
  "amount": 0,
  "currency": "string",
  "referenceType": "string",
  "referenceId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "payerType": "string",
  "payerId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "description": "string",
  "expiresAt": "2026-10-27T09:00:00+07:00",
  "completedAt": "2026-10-27T09:00:00+07:00",
  "transactionId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "createdAt": "2026-10-27T09:00:00+07:00"
}
GET/api/v1/payment/refundsThử ngay ▶

Liệt kê hoàn tiền.

Tool MCP: payment_list_refundsScope: payment.refunds.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
pageNumberintquerykhông—
pageSizeintquerykhông—
statusstringquerykhông—
fromdatequerykhôngYYYY-MM-DD
todatequerykhôngYYYY-MM-DD

Ví dụ

curl https://api.nextx.vn/api/v1/payment/refunds?pageNumber=1&pageSize=1&status=...&from=2026-06-01&to=2026-06-01 \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "items": [
    {
      "refundId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "transactionId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "amount": 0,
      "currency": "string",
      "refundMethod": "string",
      "status": "string",
      "reason": "string",
      "requestedBy": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "createdAt": "2026-10-27T09:00:00+07:00",
      "approvedBy": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "approvedAt": "2026-10-27T09:00:00+07:00",
      "rejectedBy": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "rejectedAt": "2026-10-27T09:00:00+07:00",
      "rejectionReason": "string",
      "processedAt": "2026-10-27T09:00:00+07:00",
      "providerRefundId": "string",
      "bankTransactionRef": "string",
      "providerCode": "string",
      "transactionAmount": 0,
      "referenceType": "string",
      "referenceId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "providerTransactionId": "string"
    }
  ],
  "pageNumber": 0,
  "pageSize": 0,
  "totalPages": 0,
  "totalCount": 0
}
GET/api/v1/payment/transactionsThử ngay ▶

Liệt kê giao dịch thanh toán.

Tool MCP: payment_list_transactionsScope: payment.transactions.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
pageNumberintquerykhông—
pageSizeintquerykhông—
providerCodestringquerykhông—
fromDatedatequerykhôngYYYY-MM-DD
toDatedatequerykhôngYYYY-MM-DD

Ví dụ

curl https://api.nextx.vn/api/v1/payment/transactions?pageNumber=1&pageSize=1&providerCode=...&fromDate=2026-06-01&toDate=2026-06-01 \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "items": [
    {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "intentId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "providerCode": "string",
      "referenceType": "string",
      "referenceId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "amount": 0,
      "netAmount": 0,
      "currency": "string",
      "providerTransactionId": "string",
      "paidAt": "2026-10-27T09:00:00+07:00",
      "createdAt": "2026-10-27T09:00:00+07:00",
      "providerApprovalCode": "string",
      "paymentInstrument": "string",
      "paymentInstrumentDetail": "string",
      "refundedAmount": 0,
      "refundCount": 0,
      "latestRefundStatus": "string"
    }
  ],
  "pageNumber": 0,
  "pageSize": 0,
  "totalPages": 0,
  "totalRecords": 0,
  "totalAmount": 0,
  "totalNetAmount": 0
}
GET/api/v1/payment/transactions/{id}Thử ngay ▶

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

Tool MCP: payment_get_transactionScope: payment.transactions.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
idGUIDpathcó—

Ví dụ

curl https://api.nextx.vn/api/v1/payment/transactions/<id> \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "transactionId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "intentId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "providerCode": "string",
  "providerTransactionId": "string",
  "referenceType": "string",
  "referenceId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "payerType": "string",
  "payerId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "amount": 0,
  "netAmount": 0,
  "currency": "string",
  "paidAt": "2026-10-27T09:00:00+07:00",
  "createdAt": "2026-10-27T09:00:00+07:00"
}
GET/api/v1/payment/subscriptionsThử ngay ▶

Liệt kê gói đăng ký định kỳ.

Tool MCP: payment_list_subscriptionsScope: payment.subscriptions.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
pageNumberintquerykhông—
pageSizeintquerykhông—
statusstringquerykhông—
providerCodestringquerykhông—

Ví dụ

curl https://api.nextx.vn/api/v1/payment/subscriptions?pageNumber=1&pageSize=1&status=...&providerCode=... \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "items": [
    {
      "subscriptionId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "referenceType": "string",
      "referenceId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "payerType": "string",
      "payerId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "providerCode": "string",
      "amount": 0,
      "currency": "string",
      "billingPeriod": "string",
      "renewalModel": "string",
      "status": "string",
      "currentPeriodStart": "2026-10-27T09:00:00+07:00",
      "currentPeriodEnd": "2026-10-27T09:00:00+07:00",
      "nextBillingDate": "2026-10-27T09:00:00+07:00",
      "reminderDaysBefore": 0,
      "gracePeriodDays": 0,
      "reminderSentAt": "2026-10-27T09:00:00+07:00",
      "suspendedAt": "2026-10-27T09:00:00+07:00",
      "cancelledAt": "2026-10-27T09:00:00+07:00",
      "createdAt": "2026-10-27T09:00:00+07:00"
    }
  ],
  "pageNumber": 0,
  "pageSize": 0,
  "totalPages": 0,
  "totalCount": 0
}
GET/api/v1/payment/reports/overviewThử ngay ▶

Tổng quan báo cáo thanh toán theo khoảng ngày.

Tool MCP: payment_get_report_overviewScope: payment.reports.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
fromdatequerykhôngYYYY-MM-DD
todatequerykhôngYYYY-MM-DD

Ví dụ

curl https://api.nextx.vn/api/v1/payment/reports/overview?from=2026-06-01&to=2026-06-01 \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "from": "2026-10-27",
  "to": "2026-10-27",
  "totalTransactions": 0,
  "totalAmount": 0,
  "totalNetAmount": 0,
  "totalFees": 0,
  "totalRefunds": 0,
  "activeSubscriptions": 0,
  "pendingRefunds": 0,
  "byProvider": [
    {
      "providerCode": "string",
      "transactionCount": 0,
      "totalAmount": 0,
      "successRate": 0,
      "avgFeeRate": 0
    }
  ],
  "byReferenceType": [
    {
      "referenceType": "string",
      "count": 0,
      "totalAmount": 0
    }
  ]
}