Skip to main content
POST
/
payment_requests
/
{payment_request_id}
/
process
Process a payment request
curl --request POST \
  --url https://api.withacclaim.com/v1/payment_requests/{payment_request_id}/process \
  --header 'Authorization: Bearer <token>'
{
  "id": "pay_AbC123XyZ",
  "payment_request_id": "prq_Def456UvW",
  "payer_id": "pyr_GhI789JkL",
  "status": "Succeeded",
  "amount": 125000,
  "currency": "USD",
  "order_id": "ORD-2025-001",
  "description": "Premium payment for policy #POL-2025-001",
  "external_id": "txn_processor_123",
  "failure_code": "card_declined",
  "failure_message": "Card was declined",
  "created_at": "2025-10-08T18:20:31Z",
  "updated_at": "2025-10-08T18:25:00Z"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
payment_request_id
string
required

ID of the payment request.

Response

Payment processed successfully.

​
id
string
Example:

"pay_AbC123XyZ"

​
payment_request_id
string | null

ID of the payment request this payment belongs to

Example:

"prq_Def456UvW"

​
payer_id
string | null

ID of the payer making the payment

Example:

"pyr_GhI789JkL"

​
status
enum<string>

Current status of the payment

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

"Succeeded"

​
amount
integer

Amount in smallest currency unit

Example:

125000

​
currency
string

ISO 4217 currency code

Example:

"USD"

​
order_id
string

Client-supplied order identifier

Example:

"ORD-2025-001"

​
description
string | null

Description of the payment

Example:

"Premium payment for policy #POL-2025-001"

​
external_id
string | null

External transaction ID from the payment processor

Example:

"txn_processor_123"

​
failure_code
string | null

Error code if the payment failed

Example:

"card_declined"

​
failure_message
string | null

Human-readable error message if the payment failed

Example:

"Card was declined"

​
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 April 14, 2026