Update a setup intent

Updates a setup intent. If successfully updated, it returns a setup intent object that contains information related to the setup intent.

SecurityOAuth2
Request
path Parameters
id
required
string <uuid>

The identifier of the setup intent.

Request Body schema: application/json
customerId
string <uuid>

The unique identifier for the customer record.

usage
string (Usage)
Default: "ON_SESSION"

The usage of the setup intent. Use ON_SESSION for payments made when customer are present and OFF_SESSION for payments made when customer are not present.

Enum: "ON_SESSION" "OFF_SESSION"
Responses
200

Successful operation. Setup intent updated.

400

Bad Request / Missing required fields.

403

Forbidden.

404

Not found / Intent Expired / Intent does not exist.

409

Conflict.

500

Internal server error.

post/v1/setup-intents/{id}
Request samples
application/json
{
  • "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
  • "usage": "ON_SESSION"
}
Response samples
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
  • "sessionSecret": "string",
  • "paymentMethodId": "b6df8625-cd25-4123-b345-638aa7b5d011",
  • "status": "REQUIRES_PAYMENT_METHOD",
  • "usage": "ON_SESSION"
}