Activator — การเปิดใช้งานที่อยู่

เปิดใช้งานที่อยู่ TRON ที่ไม่เคยถูกใช้งานบนเชนมาก่อน ที่อยู่ใหม่เอี่ยมจะยังไม่มีบันทึกบัญชี ทำให้ไม่สามารถรับการมอบหมาย Energy หรือ Bandwidth ได้จนกว่าจะได้รับการเปิดใช้งาน เอนด์พอยต์นี้ จะสร้างบัญชีให้คุณและส่งคืนแฮชธุรกรรมการเปิดใช้งาน

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

Base URL ของ Endpoint

https://netts.io/apiv2/activator

Headers ของคำขอ

ส่วนหัว	จำเป็น	คำอธิบาย
Content-Type	ใช่	application/json
X-API-KEY	ใช่	คีย์ API ของคุณจากแดชบอร์ด Netts

user_id ของคุณถูกรับมาจากคีย์ API — คุณไม่ต้องส่งค่านี้มา

---

เปิดใช้งาน — POST /apiv2/activator

เนื้อหาของคำขอ

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
targetAddress	string	ใช่	ที่อยู่ TRON ที่ต้องการเปิดใช้งาน ต้องตรงกับ ^T[A-Za-z0-9]{33}$ (34 ตัวอักษร, ขึ้นต้นด้วย T)

Response — เปิดใช้งานสำเร็จ (200, code 10000)

{
    "detail": {
        "code": 10000,
        "msg": "Address activated successfully, 1.1 TRX deducted",
        "data": {
            "orderId": "A123456",
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "activation_cost": 1.1,
            "user_balance_before": 500.00,
            "user_balance_after": 498.90,
            "hash": "0000000000000000000000000000000000000000000000000000000000000000"
        }
    }
}

ฟิลด์	ชนิด	คำอธิบาย
orderId	string	หมายเลขคำสั่งเปิดใช้งาน, ขึ้นต้นด้วย A + ตัวเลขเสมอ ใช้สำหรับการกระทบยอด
targetAddress	string	ที่อยู่ที่ได้รับการเปิดใช้งาน
activation_cost	float	จำนวนเงินที่หักจากยอดคงเหลือของคุณ ในหน่วย TRX
user_balance_before	float	ยอดคงเหลือก่อนการหักเงิน
user_balance_after	float	ยอดคงเหลือหลังการหักเงิน
hash	string	แฮชธุรกรรมการเปิดใช้งาน ตรวจสอบได้บน TRON explorer ใดๆ

Response — เปิดใช้งานอยู่แล้ว (200, code 2001)

ส่งคืนเมื่อที่อยู่นั้นมีอยู่แล้วบนเชน ไม่มีการเรียกเก็บเงิน

{
    "detail": {
        "code": 2001,
        "msg": "Address is already activated",
        "data": {
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "status": "already_activated",
            "user_balance": 500.00,
            "activation_cost": 0,
            "activation_required": false
        }
    }
}

ตรวจสอบ code ก่อนที่จะคิดว่ามีการหักเงิน: 10000 หมายถึงคุณชำระเงินแล้ว, 2001 หมายถึงไม่มีการหักเงิน

ตัวอย่าง

curl -X POST https://netts.io/apiv2/activator \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -d '{"targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"}'

---

ราคา

รายการ	จำนวน
การเปิดใช้งาน	1.1 TRX
ที่อยู่เปิดใช้งานอยู่แล้ว	0

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

ยอดคงเหลือของคุณต้องครอบคลุมค่าใช้จ่าย มิฉะนั้นคำขอจะถูกปฏิเสธด้วย 403 (1004) และไม่มี การสร้างคำสั่งซื้อ

---

เมื่อใดที่คุณจำเป็นต้องใช้สิ่งนี้

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

คุณไม่จำเป็นต้องเรียกใช้เอนด์พอยต์นี้สำหรับที่อยู่ที่เคยได้รับ TRX หรือโทเค็นมาก่อนแล้ว — ที่อยู่นั้น เปิดใช้งานอยู่แล้ว และการเรียกใช้งานจะส่งคืนค่า 2001

การสั่งซื้อ Energy สำหรับที่อยู่ใหม่

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

---

ระยะเวลา

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

ที่อยู่จะพร้อมใช้งานได้ก็ต่อเมื่อธุรกรรมได้รับการบรรจุลงในบล็อกแล้ว — ไม่เกินประมาณ 3 วินาที หลังจากได้รับคำตอบ เนื่องจากนั่นคือช่วงเวลาการสร้างบล็อกของ TRON หากขั้นตอนถัดไปของคุณขึ้นอยู่กับการที่ที่อยู่ เปิดใช้งานแล้ว (เช่น การสั่งซื้อ Bandwidth) ให้ยืนยันสถานะบนเชนด้วย hash ที่ส่งคืนมา แทนที่จะเรียกใช้งานทันที

---

รหัสข้อผิดพลาดที่ใช้อ้างอิง

รหัส	คำอธิบาย	สถานะ HTTP
10000	เปิดใช้งานที่อยู่แล้ว หักยอดคงเหลือแล้ว	200
2001	ที่อยู่ได้รับการเปิดใช้งานอยู่แล้ว ไม่มีการเรียกเก็บเงิน	200
-1	คีย์ API ไม่ถูกต้อง / IP ไม่อยู่ในไวต์ลิสต์	401
1004	ยอดเงินไม่เพียงพอ — ข้อความจะระบุจำนวนที่ต้องการและจำนวนที่คุณมี	403
-	รูปแบบ targetAddress ไม่ถูกต้อง (ต้องมี 34 ตัวอักษร, ขึ้นต้นด้วย T)	422
5003	การเปิดใช้งานล้มเหลวหรือบริการไม่พร้อมใช้งานชั่วคราว — ให้ลองใหม่ภายหลัง	503
5000	ข้อผิดพลาดภายในเซิร์ฟเวอร์	500

การได้รับ 503 หมายความว่าไม่มีการเรียกเก็บเงินและไม่มีที่อยู่ใดได้รับการเปิดใช้งาน: สามารถลองส่งคำขอใหม่ได้อย่างปลอดภัย

ขีดจำกัดอัตราการเรียกใช้

จำกัดต่อ IP ต้นทาง:

ช่วงเวลา	ขีดจำกัด
1 วินาที	5 คำขอ
1 นาที	60 คำขอ

เกินขีดจำกัดอัตราการเรียกใช้ (429)

{ "message": "API rate limit exceeded" }

บัญชีแบบชำระเงินภายหลัง (Postpaid)

บัญชีในระบบเรียกเก็บเงินภายหลังจะใช้เอนด์พอยต์ ส่วนหัว และ Request Body เดียวกัน ความแตกต่างอยู่ที่วิธีการชำระค่าเปิดใช้งาน:

• ไม่มีการหักเงินจากยอดเงินฝากของคุณ การเปิดใช้งานที่สำเร็จแต่ละครั้งจะถูกเพิ่มลงในยอดคงค้างของบัญชีในสกุลเงินการชำระบัญชีที่ตกลงไว้ในสัญญาของคุณ คุณชำระเงินตามใบแจ้งหนี้ ตามข้อตกลงของคุณ
• บัญชีของคุณมีวงเงินสินเชื่อ ตราบใดที่ยอดค้างชำระยังอยู่ภายในวงเงิน การเปิดใช้งานจะได้รับการยอมรับแม้ว่าจะมีเงินฝากเป็นศูนย์ก็ตาม
• มีการเรียกเก็บเงินเฉพาะการเปิดใช้งานที่เสร็จสมบูรณ์แล้วเท่านั้น ที่อยู่ที่เปิดใช้งานอยู่แล้ว (2001) และการเปิดใช้งานที่ล้มเหลวจะไม่มีค่าใช้จ่าย

การเรียกเก็บเงินภายหลังเปิดใช้งานโดย Netts ให้กับบัญชีตามที่มีการร้องขอ ทุกการตอบกลับจะแจ้งให้คุณทราบว่าการเปิดใช้งานได้รับการชำระเงินอย่างไร: paymentMode จะเป็น postpaid หรือ prepaid

ฟิลด์คำขอเพิ่มเติม

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
test	boolean	ไม่	true — คำนวณราคาและตรวจสอบที่อยู่เท่านั้น ไม่มีการเปิดใช้งานหรือเรียกเก็บเงิน
freezePrice	boolean	ไม่	true — ตรึงราคาตามสัญญาของคุณเป็นเวลา 60 วินาที ไม่มีการเปิดใช้งานหรือเรียกเก็บเงิน
quoteId	string	ไม่	เปิดใช้งานตามราคาของใบเสนอราคาที่ออกโดย freezePrice สำหรับที่อยู่เดียวกัน
priceCurrency	string	ไม่	TRX (ค่าเริ่มต้น) หรือสกุลเงินตามสัญญาของคุณ ดังเช่นใน settlement.asset สำหรับบัญชีแบบชำระเงินภายหลัง จำนวนเงินในสกุลเงินตามสัญญาของคุณจะรวมอยู่ด้วยเสมอ

ไม่สามารถใช้ quoteId ร่วมกับ test หรือ freezePrice ได้ ฟิลด์อื่นใดใน Request Body จะถูกปฏิเสธ

การตรวจสอบราคา (test: true)

{ "targetAddress": "TSMARToKjQGxroMnPKK6o6d4876VkQmHEH", "test": true }

{
    "detail": {
        "code": 10010,
        "msg": "Test calculation",
        "data": {
            "amount": 1,
            "unitPriceSun": null,
            "discount": null,
            "energyTRX": "0.000000",
            "activationTRX": "1.100000",
            "wouldCostTRX": "1.100000",
            "paidTRX": 0,
            "paymentMode": "postpaid",
            "activationCheck": "inactive",
            "alt": {"USDC": {"energy": "0.000000", "activation": "0.364333", "total": "0.364333"}},
            "fxAt": "2026-10-19T07:17:33.475335+00:00",
            "targetAddress": "TSMARToKjQGxroMnPKK6o6d4876VkQmHEH"
        }
    }
}

activationCheck: inactive — ที่อยู่จำเป็นต้องได้รับการเปิดใช้งานและจะถูกเรียกเก็บเงิน; active — ที่อยู่เปิดใช้งานอยู่แล้ว, wouldCostTRX คือ 0; unknown — ไม่สามารถตรวจสอบได้ในขณะนี้

alt.<currency> — จำนวนเงินเดียวกันในสกุลเงินตามสัญญาของคุณ fxAt — เวลาของอัตราแลกเปลี่ยนที่นำมาใช้

ใบเสนอราคาแบบตรึงราคา (freezePrice: true)

1. ส่งคำขอพร้อม "freezePrice": true การตอบกลับจะมีรหัส 10011 (Quote issued), มีฟิลด์เดียวกันกับการตรวจสอบราคา พร้อมด้วย quoteId และ expiresAt
2. ภายใน 60 วินาที ให้ส่งคำขอพร้อม "quoteId": "<quoteId>" และ targetAddress เดียวกัน
3. การเปิดใช้งานจะถูกเรียกเก็บเงินตามราคาที่เสนอ — ซึ่งเป็นราคาตามสัญญาของคุณ ณ เวลาที่ออกใบเสนอราคา

ใบเสนอราคาสามารถใช้ได้ครั้งเดียว ใบเสนอราคาที่หมดอายุหรือถูกใช้ไปแล้วจะถูกปฏิเสธและไม่มีการเปิดใช้งานใดๆ เกิดขึ้น

การเปิดใช้งานสำเร็จ

{
    "detail": {
        "code": 10000,
        "msg": "Address activated successfully, 1.1 TRX service cost, postpaid",
        "data": {
            "orderId": "A564125",
            "targetAddress": "TSMARToKjQGxroMnPKK6o6d4876VkQmHEH",
            "activation_cost": 1.1,
            "user_balance_before": 0.0,
            "user_balance_after": 0.0,
            "hash": "bd9ea6ef92ce4ba6553af3930a03abe874cdfcc2399b7fdd9abdb11570de2920",
            "paymentMode": "postpaid",
            "activationTRX": "1.100000",
            "totalTRX": "1.100000"
        }
    }
}

ฟิลด์	คำอธิบาย
activation_cost	ค่าใช้จ่ายในการเปิดใช้งานในหน่วย TRX สำหรับบัญชีแบบชำระเงินภายหลังจะไม่ถูกหักออกจากยอดเงินฝาก
user_balance_before / user_balance_after	ยอดเงินฝากของคุณ — ไม่เปลี่ยนแปลงสำหรับบัญชีแบบชำระเงินภายหลัง
paymentMode	postpaid
activationTRX / totalTRX	จำนวนเงินที่แน่นอน ทศนิยม 6 ตำแหน่ง
quoteId, alt	ปรากฏเมื่อมีการเปิดใช้งานผ่านใบเสนอราคา

วงเงินสินเชื่อเต็ม (402)

{
    "detail": {
        "code": 1004,
        "msg": "Postpaid credit limit reached.",
        "paymentMode": "postpaid",
        "reason": "limit_reached"
    }
}

ไม่มีการเปิดใช้งานและไม่มีการเรียกเก็บเงิน การเปิดใช้งานใหม่จะได้รับการยอมรับอีกครั้งเมื่อการชำระเงินของคุณได้รับการบันทึกหรือวงเงินของคุณได้รับการปรับเพิ่มขึ้น

รหัสข้อผิดพลาดสำหรับบัญชีชำระเงินภายหลัง

รหัส	HTTP	คำอธิบาย
10010	200	ผลลัพธ์การตรวจสอบราคา (test)
10011	200	ออกใบเสนอราคาแล้ว (freezePrice)
1004	402	วงเงินสินเชื่อของบัญชีชำระเงินภายหลังเต็ม
4100	400	คำขอไม่ถูกต้อง
4101	400	ไม่รองรับ priceCurrency
4102	400	มีการใช้ quoteId ร่วมกับ test หรือ freezePrice
4103	409	ใบเสนอราคาถูกใช้งานไปแล้ว
4104	409	ใบเสนอราคาหมดอายุ
4106	404	ไม่พบใบเสนอราคา
4107	409	พารามิเตอร์ของคำขอแตกต่างจากใบเสนอราคา
4108	400	รูปแบบ quoteId ไม่ถูกต้อง
4109	422	ไม่สามารถใช้ได้กับบัญชีย่อย
5032	503	ราคาไม่พร้อมใช้งานชั่วคราว
5033	503	อัตราแลกเปลี่ยนไม่พร้อมใช้งานชั่วคราว
5034	503	ระบบเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว — ไม่ยอมรับการเปิดใช้งาน
5036	503	การตรวจสอบสินเชื่อไม่พร้อมใช้งานชั่วคราว — ลองใหม่ภายหลัง

สำหรับการตอบกลับ 4xx และ 503 ทั้งหมดข้างต้น จะไม่มีการเปิดใช้งานและไม่มีการเรียกเก็บเงิน

---

หมายเหตุ

• การจัดการ Idempotency เป็นหน้าที่ของคุณ เอนด์พอยต์นี้ไม่มีคีย์ idempotency การส่งคำขอซ้ำสำหรับที่อยู่ ที่เปิดใช้งานอยู่แล้วมีความปลอดภัยและไม่มีค่าใช้จ่าย (2001) แต่คำขอพร้อมกันสองรายการสำหรับที่อยู่ใหม่เอี่ยม เดียวกันอาจดำเนินการไปพร้อมกันทั้งคู่ ควรจัดคิวการเปิดใช้งานตามที่อยู่ทีละรายการจากฝั่งของคุณ
• รูปแบบ orderId คือ A + ตัวเลข และมีค่าไม่ซ้ำกันในแต่ละการเปิดใช้งาน
• ไม่มีการส่งเว็บฮุกสำหรับการเปิดใช้งานในขณะนี้ — การตอบกลับและ hash คือการยืนยันผล ปัจจุบันเว็บฮุกครอบคลุมเฉพาะการมอบหมาย Energy ที่ได้รับการยืนยันแล้วเท่านั้น โปรดดูที่ Webhooks