ਮੁੱਖ ਸਮੱਗਰੀ 'ਤੇ ਜਾਓ
ਖਰਚ ਨਿਯੰਤਰਣ

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.

ਇੱਕ SPEND PERMISSION ਵਿੱਚ ਕੀ ਹੁੰਦਾ ਹੈ

ਚਾਰ ਮਾਪ। ਇੱਕ ਵਾਰੀ ਸੈੱਟ ਕਰੋ। ਹਰ ਥਾਂ ਲਾਗੂ ਕੀਤਾ ਗਿਆ।

ਇੱਕ ਸਮੇਂ ਦੇ ਦੌਰਾਨ ਭੁਗਤਾਨ

allowance_wei ਕੁੱਲ USDC (ਬੇਸ ਯੂਨਿਟ) ਹੈ ਜੋ ਏਜੰਟ ਇੱਕ period_seconds ਵਿੰਡੋ ਵਿੱਚ ਭੇਜ ਸਕਦਾ ਹੈ। ਪੀਰੀਅਡ ਇੱਕ ਦਿਨ (86400), ਇੱਕ ਹਫਤਾ (604800), ਜਾਂ 30 ਦਿਨ (2592000) ਹੈ।

ਪ੍ਰਤੀ-ਲੈਣ-ਦੇਣ ਸੀਮਾ

per_tx_wei ਸਭ ਤੋਂ ਵੱਡਾ ਇਕਲ ਬਾਹਰੀ ਭੁਗਤਾਨ ਹੈ ਜੋ ਆਗਿਆਤ ਹੈ। ਇਹ ਇੱਕ ਗਲਤ ਕਾਲ ਨੂੰ ਰੋਕਦਾ ਹੈ ਜੋ ਤੁਹਾਡੇ ਇਰਾਦੇ ਤੋਂ ਵੱਧ ਨਹੀਂ ਚੱਲਦਾ, ਸਮੇਂ ਦੀ ਆਗਿਆ ਤੋਂ ਅਜ਼ਾਦ।

ਵੈਧਤਾ ਵਿੰਡੋ

start_at ਅਤੇ end_at ਉਸ ਵੇਲੇ ਬੰਨ੍ਹੇ ਹੁੰਦੇ ਹਨ ਜਦੋਂ ਆਗਿਆ ਜੀਵੰਤ ਹੁੰਦੀ ਹੈ। ਇਸ ਖਿੜਕੀ ਦੇ ਬਾਹਰ ਇਹ ਖਰਚ ਦੀ ਆਗਿਆ ਨਹੀਂ ਦਿੰਦਾ, ਇਸ ਲਈ ਤੁਸੀਂ ਇੱਕ ਬਜਟ ਨੂੰ ਪਹਿਲਾਂ ਹੀ ਸਟੇਜ ਕਰ ਸਕਦੇ ਹੋ ਜਾਂ ਇੱਕ ਨੂੰ ਆਪਣੇ ਆਪ ਮਿਆਦ ਪੂਰੀ ਕਰਨ ਦੇ ਸਕਦੇ ਹੋ।

ਰੱਦ

revoked_at ਦਰਸਾਉਂਦਾ ਹੈ ਕਿ ਕਦੋਂ ਇੱਕ ਆਗਿਆ ਡੈਸ਼ਬੋਰਡ ਤੋਂ ਬੰਦ ਕੀਤੀ ਗਈ ਸੀ। ਆਗਿਆ ਨੂੰ ਰੱਦ ਕਰਨਾ ਕਿਸੇ ਵੀ ਭੁਗਤਾਨ ਲਈ ਤੁਰੰਤ ਆਗਿਆ ਨੂੰ ਜ਼ੀਰੋ 'ਤੇ ਲੈ ਜਾਂਦਾ ਹੈ ਜੋ ਇਸ ਤੋਂ ਬਾਅਦ ਮੁਲਾਂਕਣ ਕੀਤਾ ਗਿਆ।

ਡੈਸ਼ਬੋਰਡ-ਪ੍ਰਬੰਧਿਤ, API ਰਾਹੀਂ ਪੜ੍ਹਨ-ਯੋਗ

Agent ਦੀ key ਆਪਣੀ limit ਖੁਦ ਨਹੀਂ ਵਧਾ ਸਕਦੀ।

ਤੁਸੀਂ ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਖਰਚ ਕਰਨ ਦੀ ਆਗਿਆ ਬਣਾਉਂਦੇ, ਬਦਲਦੇ, ਅਤੇ ਰੱਦ ਕਰਦੇ ਹੋ। API ਉਨ੍ਹਾਂ ਨੂੰ ਪੜ੍ਹਨ ਲਈ ਹੀ ਖੋਲ੍ਹਦਾ ਹੈ - ਕੋਈ ਐਂਡਪੋਇੰਟ ਨਹੀਂ ਹੈ ਅਤੇ ਕੋਈ SDK ਵਿਧੀ ਨਹੀਂ ਹੈ ਜੋ ਆਗਿਆ ਨੂੰ ਬਦਲਦੀ ਹੈ। ਇਹ ਸਾਰੀ ਗੱਲ ਹੈ: ਜੇ ਏਜੰਟ ਪ੍ਰੰਪਟ-ਇੰਜੈਕਟ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਜਾਂ ਇੱਕ ਲੂਪ ਵਿੱਚ ਫਸ ਜਾਂਦਾ ਹੈ, ਤਾਂ ਇਹ ਆਪਣੀ ਖਰਚ ਕਰਨ ਦੀ ਆਗਿਆ ਨੂੰ ਵਿਆਪਕ ਨਹੀਂ ਕਰ ਸਕਦਾ, ਕਿਉਂਕਿ ਜਿਸ ਪ੍ਰਮਾਣ ਪੱਤਰ ਨੂੰ ਇਹ ਰੱਖਦਾ ਹੈ ਉਹ ਕਦੇ ਵੀ ਉਹ ਸ਼ਕਤੀ ਨਹੀਂ ਦਿੱਤੀ ਗਈ।

ਜਦੋਂ ਕੋਈ payment active permission ਤੋਂ ਵੱਧ ਹੋਵੇ, backend chain ਨੂੰ ਕੁਝ ਵੀ ਛੂਹਣ ਤੋਂ ਪਹਿਲਾਂ ਹੀ ਇਸਨੂੰ reject ਕਰ ਦਿੰਦਾ ਹੈ। ਕੋਈ funds ਨਹੀਂ ਹਿਲਦੇ। ਤੁਹਾਡਾ agent ਉਸ rejection ਨੂੰ ਕਿਸੇ ਹੋਰ failed call ਵਾਂਗ handle ਕਰਦਾ ਹੈ, ਅਤੇ ਤੁਸੀਂ attempt dashboard ਵਿੱਚ ਵੇਖਦੇ ਹੋ ਤਾਂ ਜੋ ਜੇ ਇਹ legitimate ਸੀ ਤਾਂ permission ਨੂੰ ਵਧਾ ਸਕੋ।

ਇਹ API ਰਾਹੀਂ ਪੜ੍ਹੋ

ਇਸਨੂੰ ਪ੍ਰਗਟ ਕਰਨ ਜਾਂ ਇਸਦੇ ਆਸ-ਪਾਸ ਯੋਜਨਾ ਬਣਾਉਣ ਲਈ ਮੌਜੂਦਾ ਅਨੁਮਤੀ ਫੈਚ ਕਰੋ।

GET /v1/agents/{id}/spend-permissions ਜੀਵੰਤ ਮੁੱਲਾਂ ਨੂੰ ਵਾਪਸ ਕਰਦਾ ਹੈ। ਇਸਨੂੰ ਆਪਣੇ UI ਵਿੱਚ ਬਜਟ ਦਿਖਾਉਣ ਲਈ ਵਰਤੋਂ ਕਰੋ, ਜਾਂ ਏਜੰਟ ਨੂੰ ਇਹ ਜਾਂਚਣ ਦਿਓ ਕਿ ਭੁਗਤਾਨ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਕਿੰਨਾ ਕਮਰਾ ਬਾਕੀ ਹੈ।

ਪੜ੍ਹੋ (CURL)
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_wei

Total spend allowed per period, in USDC base units (6 decimals). "5000000" is 5 USDC.

per_tx_wei

Largest 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

ਉਹ window ਜਿਸ 'ਤੇ allowance ਲਾਗੂ ਹੁੰਦੀ ਹੈ: 86400 (day), 604800 (week), ਜਾਂ 2592000 (30 days)।

start_at / end_at

ਜਦੋਂ permission active ਹੋਵੇ। open-ended permission ਲਈ end_at null ਹੁੰਦਾ ਹੈ।

revoked_at

ਸਰਗਰਮ ਹੋਣ ਦੇ ਦੌਰਾਨ ਨੱਲ; ਡੈਸ਼ਬੋਰਡ ਤੋਂ ਰੱਦ ਕੀਤੇ ਜਾਣ 'ਤੇ ਇੱਕ ਟਾਈਮਸਟੈਂਪ। ਇੱਕ ਰੱਦ ਕੀਤਾ ਗਿਆ ਅਧਿਕਾਰ ਕੁਝ ਵੀ ਅਧਿਕਾਰਤ ਨਹੀਂ ਕਰਦਾ।

ਅਵਧੀ

ਦਿਨ, ਹਫ਼ਤਾ, ਜਾਂ 30 ਦਿਨ।

period_seconds ਤਿੰਨ ਮੁੱਲਾਂ ਵਿੱਚੋਂ ਇੱਕ ਲੈਂਦਾ ਹੈ। ਆਗਿਆ ਉਸ ਸਮੇਂ ਦੁਬਾਰਾ ਸੈਟ ਹੁੰਦੀ ਹੈ ਜਦੋਂ ਸਮਾਂ ਚਲਦਾ ਹੈ; per_tx_wei ਹਰ ਇਕ ਭੁਗਤਾਨ 'ਤੇ ਲਾਗੂ ਹੁੰਦਾ ਹੈ ਚਾਹੇ ਸਮਾਂ ਕਿਸੇ ਵੀ ਹੋਵੇ।

86400

1 ਦਿਨ

604800

1 ਹਫਤਾ

2592000

30 ਦਿਨ

ਇੱਕ ਖਰਚ ਕਰਨ ਦੀ ਆਗਿਆ ਇੱਕ ਸਖਤ ਸੀਮਾ ਹੈ, ਇੱਕ ਵਾਰੀ ਸੈੱਟ ਕੀਤੀ ਜਾਂਦੀ ਹੈ, ਹਰ ਜਗ੍ਹਾ ਲਾਗੂ ਕੀਤੀ ਜਾਂਦੀ ਹੈ - ਨਾ ਕਿ ਪ੍ਰਤੀ-ਭੁਗਤਾਨ ਮਨਜ਼ੂਰੀ ਕਾਰਵਾਈ ਅਤੇ ਨਾ ਹੀ ਮਨੁੱਖ-ਇਨ-ਲੂਪ ਪੁਸ਼ਟੀ. ਜੇਕਰ ਤੁਹਾਨੂੰ ਮਨਜ਼ੂਰੀਆਂ ਜਾਂ ਬਹੁ-ਦਸਤਖਤ ਦੀ ਲੋੜ ਹੈ, ਤਾਂ ਇਹ ਇੱਕ ਵੱਖਰਾ, ਭਾਰੀ ਪੈਟਰਨ ਹੈ; ਆਗਿਆ ਹਮੇਸ਼ਾਂ-ਚਾਲੂ ਫਲੋਰ ਹੈ.

ਅਕਸਰ ਪੁੱਛੇ ਜਾਂਦੇ

ਪੰਜ ਖਰਚ ਕਰਨ ਦੀ ਅਨੁਮਤੀ ਦੇ ਸਵਾਲ ਜੋ ਓਪਰੇਟਰ ਪੁੱਛਦੇ ਹਨ।

ਕੀ ਮੈਂ API ਰਾਹੀਂ ਖਰਚ ਕਰਨ ਦੀ ਅਨੁਮਤੀ ਸੈੱਟ ਜਾਂ ਬਦਲ ਸਕਦਾ ਹਾਂ?

ਨਹੀਂ। ਖਰਚ ਅਧਿਕਾਰ API 'ਤੇ ਪੜ੍ਹਨ-ਕੇਵਲ ਹਨ। ਤੁਸੀਂ AgentCredia ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਉਨ੍ਹਾਂ ਨੂੰ ਬਣਾਉਂਦੇ, ਬਦਲਦੇ ਅਤੇ ਰੱਦ ਕਰਦੇ ਹੋ, ਅਤੇ GET /v1/agents/{id}/spend-permissions ਤੁਹਾਡੇ ਕੋਡ ਨੂੰ ਮੌਜੂਦਾ ਮੁੱਲਾਂ ਨੂੰ ਪੜ੍ਹਨ ਦੀ ਆਗਿਆ ਦਿੰਦਾ ਹੈ ਤਾਂ ਜੋ ਉਨ੍ਹਾਂ ਨੂੰ ਦਿਖਾਇਆ ਜਾ ਸਕੇ ਜਾਂ ਜਾਂਚਿਆ ਜਾ ਸਕੇ। ਇਹ ਜਾਨਬੂਝ ਕੇ ਕੀਤਾ ਗਿਆ ਹੈ: ਏਜੰਟ ਦੀ ਆਪਣੀ API ਕੁੰਜੀ ਆਪਣੇ ਹੀ ਸੀਮਾਵਾਂ ਨੂੰ ਢੀਲਾ ਨਹੀਂ ਕਰ ਸਕਦੀ, ਜੋ ਕਿ ਤੁਹਾਨੂੰ ਚਾਹੀਦਾ ਹੈ ਜੇਕਰ ਏਜੰਟ ਕਦੇ ਵੀ ਪ੍ਰੰਪਟ-ਇੰਜੈਕਟ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਜਾਂ ਲੂਪ ਕਰਦਾ ਹੈ। ਇੱਕ ਭੁਗਤਾਨ ਵਧਾਉਣ ਲਈ ਤੁਹਾਨੂੰ ਡੈਸ਼ਬੋਰਡ ਦੀ ਲੋੜ ਹੈ।

ਜਦੋਂ payment permission ਤੋਂ ਵੱਧ ਹੋਣ ਵਾਲੀ ਹੋਵੇ ਤਾਂ ਕੀ ਹੁੰਦਾ ਹੈ?

Backend ਇਸਨੂੰ chain ਨੂੰ ਛੂਹਣ ਤੋਂ ਪਹਿਲਾਂ ਹੀ reject ਕਰ ਦਿੰਦਾ ਹੈ - ਕੋਈ funds ਨਹੀਂ ਹਿਲਦੇ। Enforcement backend 'ਤੇ ਰਹਿੰਦੀ ਹੈ, agent ਦੇ code ਵਿੱਚ ਨਹੀਂ, ਇਸ ਲਈ agent ਇਸਨੂੰ bypass ਨਹੀਂ ਕਰ ਸਕਦਾ ਭਾਵੇਂ ਉਸਦੀ logic ਕੋਸ਼ਿਸ਼ ਕਰੇ। Permission ਨੂੰ GET route ਨਾਲ read ਕਰੋ ਤਾਂ ਜੋ agent ਨੂੰ ਦਿਖਾ ਸਕੋ ਕਿ ਕਿੰਨੀ room ਬਾਕੀ ਹੈ, ਅਤੇ payments.create ਤੋਂ ਆਈ rejection ਨੂੰ ਕਿਸੇ ਹੋਰ failed call ਵਾਂਗ handle ਕਰੋ।

Amounts dollars ਦੀ ਥਾਂ wei ਵਿੱਚ ਕਿਉਂ ਹਨ?

Consistency with the rest of the API: every amount is a base-unit string. USDC has 6 decimals, so allowance_wei "5000000" is 5 USDC and per_tx_wei "1000000" is 1 USDC. Strings, not floats - large integers lose precision as JSON numbers, and a base-unit string is unambiguous across languages.

ਕੀ ਖਰਚ ਕਰਨ ਦੀਆਂ ਅਨੁਮਤੀਆਂ ਆਉਣ ਵਾਲੇ ਭੁਗਤਾਨਾਂ ਨੂੰ ਸੀਮਿਤ ਕਰਦੀਆਂ ਹਨ?

ਨਹੀਂ। ਇੱਕ ਅਧਿਕਾਰ ਸਿਰਫ ਵੈਲਿਟ ਤੋਂ ਪੈਸਾ ਜਾ ਰਿਹਾ ਹੈ। ਆਉਣ ਵਾਲਾ USDC ਇਸ ਨਾਲ ਕਦੇ ਵੀ ਰੋਕਿਆ ਨਹੀਂ ਜਾਂਦਾ - ਕੋਈ ਵੀ ਤੁਹਾਡੇ ਏਜੰਟ ਨੂੰ ਕਿਸੇ ਵੀ ਸਮੇਂ ਭੁਗਤਾਨ ਕਰ ਸਕਦਾ ਹੈ। ਅਧਿਕਾਰ ਨੂੰ ਬਾਹਰੀ ਖਰਚ 'ਤੇ ਇੱਕ-ਤਰਫਾ ਵਾਲਵ ਵਜੋਂ ਸੋਚੋ; ਆਉਣ ਵਾਲੀ ਸੈਟਲਮੈਂਟ ਨੂੰ ਭੁਗਤਾਨ.received webhook ਦੁਆਰਾ ਵੱਖਰੇ ਤੌਰ 'ਤੇ ਪੁਸ਼ਟੀ ਕੀਤੀ ਜਾਂਦੀ ਹੈ।

ਜੇ ਕੁਝ ਗਲਤ ਲੱਗਦਾ ਹੈ ਤਾਂ ਮੈਂ ਖਰਚ ਕਰਨ ਨੂੰ ਤੇਜ਼ੀ ਨਾਲ ਕਿਵੇਂ ਰੱਦ ਕਰਾਂ?

ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਆਗਿਆ ਨੂੰ ਰੱਦ ਕਰੋ - ਇਹ revoked_at ਨੂੰ ਸੈਟ ਕਰਦਾ ਹੈ ਅਤੇ ਕਿਸੇ ਵੀ ਭੁਗਤਾਨ ਲਈ ਆਗਿਆ ਨੂੰ ਜ਼ੀਰੋ ਕਰਦਾ ਹੈ ਜੋ ਬਾਅਦ ਵਿੱਚ ਮੁਲਾਂਕਣ ਕੀਤਾ ਗਿਆ। ਇੱਕ ਕਠੋਰ ਰੋਕਣ ਲਈ ਤੁਸੀਂ ਏਜੰਟ ਦੀ API ਕੁੰਜੀ ਨੂੰ ਰੋਟੇਟ ਜਾਂ ਰੱਦ ਵੀ ਕਰ ਸਕਦੇ ਹੋ (apiKeys.rotate / apiKeys.revoke), ਜੋ ਪਛਾਣ ਪੱਤਰ ਨੂੰ ਪੂਰੀ ਤਰ੍ਹਾਂ ਕੱਟ ਦਿੰਦਾ ਹੈ। ਦੋਹਾਂ ਤੁਰੰਤ ਹਨ; ਆਗਿਆ ਰੱਦ ਕਰਨਾ ਸਰਜੀਕਲ ਹੈ, ਕੁੰਜੀ ਰੱਦ ਕਰਨਾ ਕਿਲ ਸਵਿੱਚ ਹੈ।

ਸੀਮਾਵਾਂ ਨਾਲ ਖਰਚ ਕਰੋ, ਨਾ ਕਿ ਅਚਾਨਕ।

ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਇੱਕ ਆਗਿਆ ਅਤੇ ਪ੍ਰਤੀ ਲੈਨ ਕੈਪ ਸੈਟ ਕਰੋ। ਬੈਕਐਂਡ ਬਾਕੀ ਕਰਦਾ ਹੈ।