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 एक खुली अनुमति के लिए शून्य है।
revoked_atसक्रिय रहते हुए शून्य; डैशबोर्ड से रद्द होने पर एक टाइमस्टैम्प। एक रद्द की गई अनुमति कुछ भी अधिकृत नहीं करती।
दिन, सप्ताह, या 30 दिन।
period_seconds तीन में से एक मान लेता है। अनुमति तब रीसेट होती है जब अवधि बदलती है; per_tx_wei हर एकल भुगतान पर लागू होता है चाहे अवधि कोई भी हो।
864001 दिन
6048001 सप्ताह
259200030 दिन
एक व्यय अनुमति एक कठोर सीमा है, जो एक बार सेट की जाती है, हर जगह लागू होती है - यह प्रति-भुगतान अनुमोदन कार्यप्रवाह नहीं है और न ही मानव-इन-द-लूप पुष्टि है। यदि आपको अनुमोदनों या बहु-हस्ताक्षर की आवश्यकता है, तो वह एक अलग, भारी पैटर्न है; अनुमति इसके नीचे हमेशा-ऑन फर्श है।