Update an intent
Updates an existing intent associated with an enrolled account. This API supports a multi-step flow when additional authentication is required:
- The initial request submits updated intent details for validation and risk assessment.
- If step-up authentication is required, a follow-up request must be made with the intent identifier and step-up verification details.
Intent updates are limited to supported parameters such as maximum amount and expiration. To modify other attributes, the existing intent must be cancelled and a new intent created.
Authentication
AuthorizationBearer
OAuth 2.0 client credentials. Exchange your API key and secret for a bearer token, then send it as Authorization: Bearer <token>.
Path parameters
intentId
Intent identifier
Headers
Authorization
The OAuth authorization header generated as prescribed in the Oauth 2.0 guide
trackingId
A unique identifier for request tracking.
agentId
Agent's unique identifier.
Request
Request to update an existing intent associated with an enrolled account. The request payload is JWE-encrypted on the wire.
The initial request for update (before step-up verification)
OR
The follow-up request after completing step-up verification.
Response
Successful response
The response returned when additional authentication is required to proceed with the intent.
The response returned when additional authentication is required to proceed with the intent.
OR
The response returned after successful step-up authentication for the intent.
The response returned after successful step-up authentication for the intent.
Errors
400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error