การเรียกเก็บเงินแบบบริการรายเดือน (Postpaid)

ด้วยการเรียกเก็บเงินแบบบริการรายเดือน (Postpaid) คุณสามารถสั่งซื้อ Energy, Bandwidth, การเปิดใช้งาน และการตรวจสอบ AML ได้โดยไม่ต้องเติมเงินมัดจำล่วงหน้า บริการต่างๆ จะคิดราคาตามอัตราค่าบริการเฉพาะของลูกค้าที่เกี่ยวข้อง รวมถึงส่วนลดที่เกี่ยวข้อง ค่าบริการ การชำระเงิน และการปรับปรุงยอดจะแสดงในใบแจ้งหนี้ของคุณภายใต้เงื่อนไขการเรียกเก็บเงินและการชำระเงินตามสัญญาของคุณ

Netts จะเปิดใช้งานบริการรายเดือนตามคำขอสำหรับบัญชีธุรกิจ เอ็นด์พอยต์ในส่วนนี้จะตอบกลับสำหรับบัญชีที่มีการเรียกเก็บเงินแบบบริการรายเดือนเท่านั้น บัญชีอื่นจะได้รับ 403 postpaid_required

วิธีการทำงาน

1. คุณสั่งซื้อตามปกติ ใช้เอ็นด์พอยต์การสั่งซื้อเดิม และ API key เดียวกัน บัญชีบริการรายเดือนไม่จำเป็นต้องมียอดเงินมัดจำสำหรับการสั่งซื้อเหล่านี้ ราคาจะเป็นไปตามสัญญาของคุณ รวมถึงส่วนลดของคุณด้วย
2. บริการที่จัดส่งจะถูกบันทึกเป็นค่าบริการ คำสั่งซื้อที่ได้รับการยอมรับแล้วไม่ได้ถือเป็นบริการที่จัดส่งแล้วโดยอัตโนมัติ ค่าบริการจะปรากฏใน usage เมื่อบริการหรือส่วนของคำสั่งซื้อที่คิดค่าบริการแยกต่างหากได้รับการจัดส่งแล้ว — ซึ่งอาจเกิดขึ้นช้ากว่าการตอบกลับคำสั่งซื้อ
3. ราคาและอัตราแลกเปลี่ยนจะถูกตรึงและคงไว้ ใบเสนอราคาที่ยังไม่หมดอายุจะตรึงราคาตามสัญญาของคุณสำหรับคำสั่งซื้อนั้น หากไม่มีใบเสนอราคา จะใช้ราคาตามสัญญาของคุณ ณ เวลาที่ทำการสั่งซื้อ และจำนวนเงินในสกุลเงินตามสัญญาของคุณจะถูกคำนวณตามอัตราแลกเปลี่ยน ณ เวลาที่ส่งมอบบริการ จำนวนเงินที่บันทึกไว้จะไม่ถูกคำนวณใหม่เมื่อคุณดูการใช้งาน รับใบแจ้งหนี้ หรือชำระเงิน
4. คุณได้รับและชำระใบแจ้งหนี้ของคุณ รอบการเรียกเก็บเงินและเงื่อนไขการชำระเงินจะเป็นไปตามที่ตกลงไว้ในสัญญาของคุณ ใบแจ้งหนี้จะแสดงบริการของรอบบิลนั้นๆ การชำระเงินและการปรับปรุงยอดที่นำมาใช้ รวมถึงจำนวนเงินที่ยังต้องชำระ การชำระเงินจะไม่ลบประวัติการใช้บริการ ดูที่ invoices และ payments สกุลเงินที่ใช้ชำระ เครือข่าย และเงื่อนไขการชำระเงินจะแสดงใน settlement ใน account การชำระเงินเกินจะคงอยู่ในบัญชีของคุณในรูปแบบเครดิตและจะถูกนำไปใช้สำหรับค่าบริการครั้งถัดไป

อัตราค่าบริการ ใบเสนอราคา และอัตราแลกเปลี่ยนที่บันทึกไว้

ใบเสนอราคา (freezePrice) จะตรึงราคาตามสัญญาของคุณไว้เป็นเวลาหนึ่งนาที ทำการสั่งซื้อพร้อม quoteId และพารามิเตอร์เดิมภายในหนึ่งนาทีนั้น และระบบจะคิดค่าบริการตามราคาที่เสนอ แม้ว่าราคาจะเปลี่ยนแปลงหรือบริการจะถูกจัดส่งในภายหลังก็ตาม ใบเสนอราคาเป็นทางเลือกเสริม ดูฟิลด์ของคำขอได้ที่ Energy 1 ชั่วโมง และ Energy 5 นาที

หากไม่มีใบเสนอราคา จำนวนเงินในสกุลเงินตามสัญญาของคุณจะถูกคำนวณตามอัตราแลกเปลี่ยน ณ เวลาที่ส่งมอบบริการ ไม่ใช่เวลาที่คุณดูราคาหรือดูบัญชีของคุณ อัตราปัจจุบัน ได้แก่ อัตรา ของคุณและอัตราที่แสดงในการตอบกลับของบัญชี มีไว้สำหรับการเปรียบเทียบเท่านั้น ไม่ใช่ข้อผูกมัดสำหรับอัตราแลกเปลี่ยนของคำสั่งซื้อในอนาคต

การตรวจสอบ AML จะคิดราคาเป็นดอลลาร์สหรัฐและบันทึกในสกุลเงินตามสัญญาของคุณ จำนวนที่เทียบเท่า TRX จะถูกคำนวณตามอัตราแลกเปลี่ยนเมื่อการตรวจสอบเสร็จสมบูรณ์ ห้ามคำนวณค่าบริการ AML ใหม่จากจำนวน TRX ที่ปัดเศษแล้ว

จำนวนเงินจะแสดงเป็น TRX และในสกุลเงินตามสัญญาของคุณ ขีดจำกัดของคุณจะถูกนับในสกุลเงินตามสัญญาของคุณ usdPerTrx คืออัตราแลกเปลี่ยนของ TRX ต่อสกุลเงินตามสัญญาของคุณ คุณต้องชำระเงินในสกุลเงินและเครือข่ายตามสัญญาของคุณ ซึ่งแสดงอยู่ใน settlement

คำสั่งซื้อหนึ่งรายการสามารถมีค่าบริการได้มากกว่าหนึ่งรายการ เช่น Energy และการเปิดใช้งานที่คิดค่าบริการแยกต่างหาก ค่าบริการแต่ละรายการจะมีเวลาและอัตราแลกเปลี่ยนของตนเอง จำนวนเงินจะถูกปัดเศษหนึ่งครั้งเป็นทศนิยมหกตำแหน่งแบบ half-even ส่วนใบเสนอราคาจะคงจำนวนเงินตามที่เสนอไว้ กระทบยอดคำสั่งซื้อตามรายการค่าบริการ ไม่ใช่การนำอัตราแลกเปลี่ยนปัจจุบันมาคำนวณกับยอดรวมทั้งหมด

เวลาทั้งหมดเป็น UTC จำนวนเงินทั้งหมดเป็นสตริงทศนิยม เช่น "30000.000000" — ให้แปลงค่าด้วยชนิดข้อมูล decimal ไม่ใช่ float

ขีดจำกัดวงเงินเครดิต

Netts จะกำหนด ขีดจำกัดวงเงินเครดิต ของบัญชีคุณ ซึ่งเป็นยอดหนี้สูงสุดที่คุณสามารถค้างชำระได้ในทุกช่วงเวลา ข้อมูลนี้จะแสดงใน account และ limits โดยมี "origin": "netts" คุณสามารถดูได้แต่ไม่สามารถเปลี่ยนแปลงหรือปิดการใช้งานได้ — โปรดติดต่อผู้จัดการ Netts ของคุณหากต้องการขีดจำกัดอื่น

ผลิตภัณฑ์และ API key ต่างๆ จะใช้วงเงินเครดิตระดับบัญชีร่วมกันนี้ ทุกคำสั่งซื้อใหม่จะได้รับการตรวจสอบเทียบกับขีดจำกัดที่เกี่ยวข้องทั้งหมด เมื่อการตรวจสอบพบว่าวงเงินเครดิตที่ใช้ได้ไม่เพียงพอ คำสั่งซื้อจะถูกปฏิเสธก่อนดำเนินการ:

{
  "detail": {
    "code": 1004,
    "msg": "Postpaid credit limit reached.",
    "paymentMode": "postpaid",
    "reason": "limit_reached",
    "product": "*",
    "period": "outstanding",
    "limitId": 1
  }
}

เอ็นด์พอยต์คำสั่งซื้อจะตอบกลับ 402 การชำระเงินจะช่วยคืนวงเงินเครดิตกลับมา หากระบบตรวจสอบไม่พร้อมใช้งานชั่วคราว เอ็นด์พอยต์คำสั่งซื้อจะตอบกลับ 503 พร้อมรหัส 5036 — ให้ลองใหม่ในภายหลัง จะไม่มีการคิดค่าบริการจากความพยายามที่ถูกปฏิเสธ จำนวนเงินที่ใช้ได้ซึ่งแสดงโดยคำขอดูข้อมูลเป็นตัวเลขปัจจุบัน ไม่ใช่การจองไว้สำหรับคำสั่งซื้อในภายหลัง คำสั่งซื้ออื่นที่ได้รับการยอมรับสามารถทำให้ค่านั้นเปลี่ยนแปลงได้

ขีดจำกัดของคุณเอง

ภายใต้ขีดจำกัดของ Netts คุณสามารถตั้งค่าขีดจำกัดของคุณเองที่ต่ำกว่าได้ — เพื่อควบคุมการใช้จ่ายหรือจำกัดเฉพาะผลิตภัณฑ์แต่ละรายการ:

• ขีดจำกัดโดยรวมของคุณเอง — ยอดรวมที่คุณอนุญาตให้ตนเองค้างชำระได้ ซึ่งต่ำกว่าขีดจำกัดของ Netts
• ขีดจำกัดของผลิตภัณฑ์ — จำนวนเงินที่ผลิตภัณฑ์หนึ่งๆ สามารถใช้ได้ เช่น energy_5m

ขีดจำกัดของคุณจะไม่เป็นการเพิ่มเครดิต ขีดจำกัดของผลิตภัณฑ์ไม่สามารถนำมารวมกันได้: หากขีดจำกัดของ Netts คือ 50 USD การตั้งขีดจำกัดผลิตภัณฑ์ที่ 50 USD สำหรับ energy_1h และ 50 USD สำหรับ energy_5m จะยังคงใช้วงเงินเครดิตระดับบัญชีร่วมกันที่ 50 USD การตรวจสอบคำสั่งซื้อจะมีผลกับ ทุก ขีดจำกัดที่เกี่ยวข้อง และ limits จะแสดงจำนวนเงินที่สามารถใช้ได้ในปัจจุบันสำหรับแต่ละผลิตภัณฑ์

ขีดจำกัดสามารถนับตาม:

period	สิ่งที่ถูกนับ
outstanding	ค่าบริการที่ยังไม่ได้ชำระ บวกกับคำสั่งซื้อที่ยอมรับแล้วแต่ยังไม่ได้บันทึก
day	ค่าบริการของวันปัจจุบันตามเวลา UTC รวมถึงรายการที่ชำระแล้ว บวกกับคำสั่งซื้อที่ยอมรับแล้วแต่ยังไม่ได้บันทึก
week	ค่าบริการของสัปดาห์ปัจจุบันตามเวลา UTC ตั้งแต่วันจันทร์ 00:00 UTC รวมถึงรายการที่ชำระแล้ว บวกกับคำสั่งซื้อที่ยอมรับแล้วแต่ยังไม่ได้บันทึก
order	จำนวนเงินของคำสั่งซื้อใหม่รายการเดียว

การชำระเงินจะช่วยลดยอดหนี้ของคุณ แต่จะไม่รีเซ็ตการใช้งานของวันหรือสัปดาห์ เครดิตจากการชำระเงินเกินจะแสดงเป็น creditApplied และจะนับหนึ่งครั้งเพื่อหักลบกับยอดหนี้โดยรวมของคุณ โดยจะไม่เพิ่มเข้าไปในขีดจำกัดของแต่ละผลิตภัณฑ์

ขีดจำกัดของคุณจะอยู่ในสกุลเงินเดียวกับขีดจำกัดของ Netts และไม่สามารถสูงกว่าขีดจำกัดดังกล่าวได้ หาก Netts ปรับลดขีดจำกัดลงต่ำกว่าขีดจำกัดของคุณ ข้อกำหนดที่ต่ำกว่าและมีผลบังคับใช้จะยังคงมีผล

ผลิตภัณฑ์: energy_1h, energy_5m, bandwidth, activation, aml_check

สิทธิ์ของ API key

API key แต่ละรายการจำเป็นต้องมีสิทธิ์สำหรับส่วนนี้ ผู้จัดการ Netts ของคุณจะเป็นผู้ให้สิทธิ์สำหรับแต่ละคีย์:

สิทธิ์	อนุญาตให้
billing.read	บัญชี, อัตรา, ขีดจำกัด, การใช้งาน, ใบแจ้งหนี้ และการชำระเงิน
limits.write	การสร้าง, การแก้ไข, การปิดและเปิดใช้งานขีดจำกัดของคุณเอง

หากไม่มีสิทธิ์ เอ็นด์พอยต์จะตอบกลับ 403 พร้อม billing_read_required หรือ forbidden ไวท์ลิสต์ IP ของคีย์จะมีผลบังคับใช้เหมือนกับเอ็นด์พอยต์อื่นๆ เอ็นด์พอยต์เหล่านี้ยังคงใช้งานได้เมื่อยอดเงินมัดจำคงเหลือเป็นศูนย์

เอ็นด์พอยต์

เอ็นด์พอยต์	การทำงาน
GET /apiv2/billing/account	ขีดจำกัดวงเงินเครดิต, ยอดหนี้ และยอดที่ใช้ได้ในปัจจุบัน
GET /apiv2/billing/rate	อัตราปัจจุบันของ TRX เทียบกับสกุลเงินตามสัญญาของคุณ
GET /apiv2/billing/limits	ขีดจำกัดทั้งหมดพร้อมจำนวนเงินที่ใช้ไปและที่ใช้ได้, ยอดที่ใช้ได้ต่อผลิตภัณฑ์
POST /apiv2/billing/limits	สร้าง, แก้ไข, ปิดและเปิดใช้งานขีดจำกัดของคุณเอง
GET /apiv2/billing/usage	ส่วนประกอบของค่าบริการ ซึ่งเชื่อมโยงกับคำสั่งซื้อ
GET /apiv2/billing/invoices	ใบแจ้งหนี้, ใบแจ้งหนี้หนึ่งรายการพร้อมรายการค่าบริการ
GET /apiv2/billing/payments	การชำระเงินและเครดิต

รูปแบบการตอบกลับ

{ "success": true, "data": { }, "timestamp": "2026-10-19T20:12:30+00:00" }

ข้อผิดพลาดจากบริการ:

{
  "success": false,
  "error": { "code": "postpaid_required", "message": "this account has no postpaid billing" },
  "timestamp": "2026-10-19T20:12:30+00:00"
}

คีย์ที่หายไปหรือไม่ถูกต้อง หรือคำขอจาก IP ที่อยู่นอกไวท์ลิสต์ของคีย์ จะถูกปฏิเสธโดย API gateway ก่อนที่จะส่งไปถึงบริการ ด้วยรหัส 401:

{ "detail": { "code": -1, "msg": "Invalid or missing API key" } }

รหัส -2 พร้อม "Invalid API key or IP not in whitelist" หมายถึง IP ไม่อยู่ในไวท์ลิสต์ของคีย์ คำขอมากกว่า 10 รายการต่อวินาที หรือ 300 รายการต่อนาทีจาก IP เดียวกันจะถูกปฏิเสธด้วย 429 และ {"message": "API rate limit exceeded"}

HTTP	code	ความหมาย
400	invalid_request, invalid_amount, idempotency_key_required, invalid_idempotency_key	พารามิเตอร์หายไปหรือมีรูปแบบไม่ถูกต้อง
403	postpaid_required	บัญชีไม่มีการเรียกเก็บเงินแบบบริการรายเดือน
403	postpaid_disabled	การเรียกเก็บเงินแบบบริการรายเดือนถูกระงับชั่วคราว: คุณสามารถดูข้อมูลได้ แต่ไม่สามารถเปลี่ยนขีดจำกัดได้
403	billing_read_required, forbidden	คีย์ไม่มีสิทธิ์ billing.read หรือ limits.write
403	netts_limit_readonly	ขีดจำกัดถูกกำหนดโดย Netts และไม่สามารถเปลี่ยนแปลงได้
404	not_found	ไม่พบขีดจำกัดหรือใบแจ้งหนี้ดังกล่าวในบัญชีของคุณ
409	revision_conflict	ขีดจำกัดมีการเปลี่ยนแปลงในระหว่างนั้น — โปรดอ่านข้อมูลใหม่อีกครั้ง
409	limit_exists	คุณมีขีดจำกัดสำหรับผลิตภัณฑ์และช่วงเวลานี้อยู่แล้ว
409	idempotency_conflict	Idempotency-Key ถูกใช้กับคำขออื่นไปแล้ว
409	no_account_limit	บัญชียังไม่มีการกำหนดขีดจำกัดวงเงินเครดิตโดย Netts
422	above_account_limit	ค่าดังกล่าวสูงกว่าขีดจำกัดของ Netts
422	product_not_postpaid	ผลิตภัณฑ์นี้ไม่สามารถใช้งานในรูปแบบบริการรายเดือนได้
422	unit_mismatch	สกุลเงินของขีดจำกัด Netts มีการเปลี่ยนแปลง — ให้ตั้งค่าใหม่ก่อนเปิดใช้งานขีดจำกัดของคุณ
503	unavailable	ไม่พร้อมใช้งานชั่วคราว — โปรดลองใหม่ในภายหลัง
503	rate_unavailable	อัตราของคุณไม่พร้อมใช้งานชั่วคราว — โปรดลองใหม่ในภายหลัง