The two windows
Approvals run on two separate clocks:Human decision window — 72 hours (configurable)
The owner (or an operator with approval rights) has up to 72 hours to approve or deny the
request. Requests not acted on in time expire, and the agent must re-request.
Denials teach the agent
A denial isn’t a dead end — the human can attach feedback text, which the agent retrieves via theget_denial_feedback MCP tool. Well-built agents read the feedback, adjust (different amount, different merchant, better justification), and re-request.
How agents track a pending approval
After a request returns thepending_approval verdict, the agent polls check_approval_status with the returned requestId (passed as the request_id parameter):
- Poll roughly every 30 seconds, honoring the
retry_after_secondshint in each response. - For wallet payments,
approvedmeans the transfer is in flight — Reinx executes it on approval. Keep polling until the status is terminal:used(settled) orfailed. - Terminal statuses:
used,failed,denied,expired.