Define limits before delegating payment access.
Review how payment limits are evaluated and which paths are covered by enforcement. Set an allowance per period and a per-transaction cap on each agent in the dashboard.
ตัวแทนอิสระทำผิดพลาด. พวกเขาลองใหม่. พวกเขาทำซ้ำ. พวกเขาถูกฉีดคำสั่ง. พวกเขาบางครั้งพยายามใช้จ่ายเงินที่คุณไม่ได้อนุญาต.
An AgentCredia spend permission is owner-set in the dashboard and enforced by the backend, not by the agent's code. Every outbound payment is checked against the active permission before the API accepts it, so a payment above the limit is rejected even if the agent's logic tries to send it. Your code can read the permission over the API to display it or plan around it, but it cannot raise it.
สี่มิติ. ตั้งค่าเพียงครั้งเดียว. บังคับใช้ทุกที่.
การอนุญาตตามช่วงเวลา
allowance_wei คือ USDC รวม (หน่วยพื้นฐาน) ที่เอเจนต์สามารถส่งได้ในช่วงเวลา period_seconds หนึ่งช่วง เวลาเป็นวัน (86400), สัปดาห์ (604800), หรือ 30 วัน (2592000)
ขีดจำกัดต่อการทำธุรกรรม
per_tx_wei คือการชำระเงินขาออกครั้งเดียวที่ใหญ่ที่สุดที่อนุญาต มันหยุดการโทรที่ผิดพลาดไม่ให้เคลื่อนย้ายมากกว่าที่คุณตั้งใจไว้ โดยไม่คำนึงถึงการอนุญาตในช่วงเวลา
หน้าต่างความถูกต้อง
start_at และ end_at จะถูกผูกเมื่อสิทธิ์ใช้งานอยู่ นอกเหนือจากหน้าต่างจะไม่อนุญาตให้ใช้จ่าย ดังนั้นคุณสามารถเตรียมงบประมาณล่วงหน้าหรือปล่อยให้หมดอายุเอง.
การเพิกถอน
revoked_at บันทึกเมื่อสิทธิ์ถูกปิดจากแดชบอร์ด การเพิกถอนจะทำให้การอนุญาตเป็นศูนย์ทันทีสำหรับการชำระเงินใด ๆ ที่ประเมินหลังจากนั้น.
กุญแจของตัวแทนไม่สามารถเพิ่มขีดจำกัดของตนเองได้
คุณสร้าง เปลี่ยนแปลง และเพิกถอนสิทธิ์การใช้จ่ายในแดชบอร์ด API เปิดเผยให้เห็นเฉพาะการอ่าน - ไม่มีจุดสิ้นสุดและไม่มีวิธีการ SDK ที่เปลี่ยนแปลงสิทธิ์ นั่นคือจุดประสงค์ทั้งหมด: หากเอเจนต์ถูกฉีดคำสั่งหรือถูกติดอยู่ในลูป มันไม่สามารถขยายการอนุญาตของตนเองได้ เพราะข้อมูลประจำตัวที่ถืออยู่ไม่เคยได้รับอนุญาตให้มีอำนาจนั้น
เมื่อการชำระเงินเกินสิทธิ์ที่ใช้งานอยู่ ระบบแบ็กเอนด์จะปฏิเสธก่อนที่สิ่งใดจะสัมผัสกับเครือข่าย ไม่มีเงินเคลื่อนย้าย ตัวแทนของคุณจัดการการปฏิเสธนั้นเหมือนกับการโทรที่ล้มเหลวอื่น ๆ และคุณจะเห็นความพยายามในแดชบอร์ดเพื่อให้คุณสามารถขยายสิทธิ์ได้หากมันถูกต้อง
ดึงสิทธิ์ปัจจุบันเพื่อแสดงหรือวางแผนรอบมัน.
GET /v1/agents/{id}/spend-permissions คืนค่าค่าที่ใช้งานอยู่. ใช้เพื่อแสดงงบประมาณใน UI ของคุณ, หรือให้เอเจนต์ตรวจสอบว่ามีพื้นที่เหลือเท่าไหร่ก่อนที่จะลองชำระเงิน.
curl https://api.agentcredia.com/v1/agents/agt_123/spend-permissions \
-H "Authorization: Bearer $AGENTCREDIA_API_KEY"{
"allowance_wei": "5000000",
"per_tx_wei": "1000000",
"period_seconds": 86400,
"start_at": "2026-05-15T00:00:00Z",
"end_at": null,
"revoked_at": null
}allowance_weiTotal spend allowed per period, in USDC base units (6 decimals). "5000000" is 5 USDC.
per_tx_weiLargest single payment allowed, in base units. "1000000" is 1 USDC. A payment over this is rejected even if the period allowance has room.
period_secondsหน้าต่างที่การอนุญาตใช้ได้: 86400 (วัน), 604800 (สัปดาห์) หรือ 2592000 (30 วัน).
start_at / end_atเมื่อสิทธิ์ใช้งานอยู่ end_at เป็น null สำหรับสิทธิ์ที่ไม่มีวันสิ้นสุด
revoked_atเป็น Null ขณะทำงาน; แทนที่ด้วยเวลาที่ถูกเพิกถอนจากแดชบอร์ด การอนุญาตที่ถูกเพิกถอนไม่อนุญาตอะไรเลย
วัน สัปดาห์ หรือ 30 วัน.
period_seconds ใช้ค่าหนึ่งจากสามค่า การอนุญาตจะรีเซ็ตเมื่อช่วงเวลาหมุน; per_tx_wei ใช้กับการชำระเงินแต่ละครั้งโดยไม่คำนึงถึงช่วงเวลา
864001 วัน
6048001 สัปดาห์
259200030 วัน
การอนุญาตการใช้จ่ายเป็นขีดจำกัดที่เข้มงวด ตั้งค่าเพียงครั้งเดียว บังคับใช้ทุกที่ - ไม่ใช่กระบวนการอนุมัติแบบชำระเงินและไม่ใช่การยืนยันที่มีมนุษย์อยู่ในกระบวนการ หากคุณต้องการการอนุมัติหรือหลายลายเซ็น นั่นคือรูปแบบที่แยกต่างหากและหนักกว่า; การอนุญาตคือพื้นฐานที่เปิดอยู่เสมอ.