intent_register
Records a Consumer-approved Intent with the Intent Service and returns a stable reference usable across the payment lifecycle. WHAT THIS IS NOT: registration does not approve a payment, does not execute a transaction, does not accept risk, and does NOT capture Consumer consent. Consent lives in the signed credential (the mandate chain), not here. Register an Intent that already exists because the Consumer approved it. WHEN TO CALL: - After a mandate has been activated, to obtain a stable reference for the orders that will be fulfilled under it - Before a deferred or multi-merchant fulfilment, so each order can be tracked under one Intent Input: (optional) mandate_id, open_mandate_hash, vi_l2_fingerprint to correlate the Intent with the delegation it derives from; (optional) prompt_summary, correlation_id, expires_at Output: intent_id, intent_status (REGISTERED), created_at The calling agent is taken from the verified request signature, never from the arguments.
Input Schema
{
"type": "object",
"properties": {
"expires_at": {
"type": "string",
"description": "ISO8601 expiry of the Intent"
},
"mandate_id": {
"type": "string",
"description": "The credential this Intent derives from"
},
"service_id": {
"type": "string",
"description": "Context identifier"
},
"src_client_id": {
"type": "string",
"description": "Context identifier"
},
"correlation_id": {
"type": "string",
"description": "Context identifier for correlation and tracing"
},
"prompt_summary": {
"type": "string",
"description": "Concise natural-language summary of what the Consumer asked for. Carried for pre/post processing, audit and disputes; never rendered on a consent surface"
},
"open_mandate_hash": {
"type": "string",
"description": "Hash of the AP2 Open Mandate, to correlate the Intent with its delegation"
},
"vi_l2_fingerprint": {
"type": "string",
"description": "Fingerprint of the Verifiable Intent L2 credential, same purpose"
}
}
}
Stores exposing the intent_register tool
Get the agentic commerce digest every Monday
Real adoption data, ecosystem trends, new spec versions, and the stores that broke or recovered this week. Read by founders and engineers building the next generation of commerce.
