---
title: "Settle a payment"
method: POST
path: "/v2/x402/credit_account"
tags: ["x402 Payment Transactions"]
---

# Settle a payment

`POST /v2/x402/credit_account`

Settles an x402 payment using the quote ID and a signed payment authorization. The payment signature can be provided via the `PAYMENT-SIGNATURE` header or the `payment_signature` body parameter. Settlement is idempotent — submitting the same quote ID multiple times returns the existing transaction.

## Headers

- `PAYMENT-SIGNATURE` string

## Request body

- X402SettleRequest
  - `id` string, required — The quote ID to settle.
  - `payment_signature` string — Base64-encoded signed payment authorization (x402 PaymentPayload). Can alternatively be provided via the PAYMENT-SIGNATURE header.

## Response `200`

Payment already settled (idempotent response)

- X402TransactionResponse
  - `data` object
    - `id` string — Unique transaction identifier.
    - `record_type` 'x402_transaction'
    - `amount` string — The transaction amount in the specified currency.
    - `currency` string — The currency of the transaction amount (e.g. USD).
    - `status` 'settled' — The settlement status of the transaction.
    - `quote_id` string — The original quote ID associated with this transaction.
    - `tx_hash` string, nullable — The on-chain transaction hash, if available.
    - `created_at` string, date-time — ISO 8601 timestamp when the transaction was created.

## Other responses

- `201` — Payment settled successfully
- `400` — Bad request — invalid signature, expired authorization, invalid nonce, or malformed payment payload
- `401` — Unauthorized
- `403` — Forbidden — x402 payments not enabled, account tier ineligible, or account suspended
- `422` — Unprocessable entity — missing required parameters or insufficient funds/allowance
- `500` — Internal server error — facilitator unavailable, transaction failed on-chain, or unknown error
- `502` — Bad gateway — upstream settlement service error
- `503` — Service unavailable — facilitator or settlement timeout

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)