---
title: "POST /payments/processPayment"
method: POST
path: "/payments/processPayment"
---

# POST /payments/processPayment

`POST /payments/processPayment`

Processes a payment using a payment instrument within a payment session.

## Headers

- `X-Amzn-Bedrock-AgentCore-Payments-User-Id` string
- `X-Amzn-Bedrock-AgentCore-Payments-Agent-Name` string — The agent name associated with the payment request.

## Request body

- object
  - `paymentManagerArn` string, required — The ARN of the payment manager.
  - `paymentSessionId` string, required — The ID of the payment session.
  - `paymentInstrumentId` string, required — The ID of the payment instrument to use.
  - `paymentType` 'CRYPTO_X402', required — Payment type enum.
  - `paymentInput` object, required — The payment input details, which vary by payment type.
    - `cryptoX402` object — Input for a crypto X402 payment.
      - `version` string, required — The version of the X402 protocol.
      - `payload` object, required — The X402 payment payload.
  - `clientToken` string — A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

## Response `200`

Success

- ProcessPaymentResponse — Response structure for processing a payment.
  - `processPaymentId` string, required — The unique identifier of the processed payment.
  - `paymentManagerArn` string, required — The ARN of the payment manager.
  - `paymentSessionId` string, required — The ID of the payment session used.
  - `paymentInstrumentId` string, required — The ID of the payment instrument used.
  - `paymentType` 'CRYPTO_X402', required — The type of payment processed.
  - `status` 'PROOF_GENERATED', required — The status of the payment.
  - `paymentOutput` object, required — The payment output details specific to the payment type.
    - `cryptoX402` object — Output from a crypto X402 payment.
      - `version` string, required — The version of the X402 protocol.
      - `payload` object, required — The X402 payment response payload.
  - `createdAt` string, date-time, required — The timestamp when the payment was created.
  - `updatedAt` string, date-time, required — The timestamp when the payment was last updated.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — AccessDeniedException
- `482` — ConflictException
- `483` — ValidationException
- `484` — ThrottlingException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore/versions/79623b33d495/schema)