Skip to main content
POST
/
setup_requests
/
{setup_request_id}
/
confirm
Confirm a setup request
curl --request POST \
  --url https://api.withacclaim.com/v1/setup_requests/{setup_request_id}/confirm \
  --header 'Authorization: Bearer <token>'
{
  "id": "ta_AbC123XyZ",
  "setup_request_id": "trq_Def456UvW",
  "payer_id": "pyr_GhI789JkL",
  "status": "Succeeded",
  "external_id": "txn_processor_123",
  "failure_code": "validation_failed",
  "failure_message": "Payment method validation failed",
  "created_at": "2025-10-08T18:20:31Z",
  "updated_at": "2025-10-08T18:25:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.withacclaim.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
setup_request_id
string
required

ID of the setup request.

Response

Setup request completed successfully.

​
id
string
Example:

"ta_AbC123XyZ"

​
setup_request_id
string | null

ID of the setup request this attempt belongs to

Example:

"trq_Def456UvW"

​
payer_id
string | null

ID of the payer for this setup attempt

Example:

"pyr_GhI789JkL"

​
status
enum<string>

Current status of the setup attempt

Available options:
Pending,
Processing,
Succeeded,
Failed
Example:

"Succeeded"

​
external_id
string | null

External transaction ID from the payment processor

Example:

"txn_processor_123"

​
failure_code
string | null

Error code if the setup attempt failed

Example:

"validation_failed"

​
failure_message
string | null

Human-readable error message if the setup attempt failed

Example:

"Payment method validation failed"

​
created_at
string<date-time>
Example:

"2025-10-08T18:20:31Z"

​
updated_at
string<date-time>
Example:

"2025-10-08T18:25:00Z"

Last modified on May 24, 2026