---
title: "Settle a payment"
method: POST
path: "/payments/settle"
tags: ["Payments"]
---

# Settle a payment

`POST /payments/settle`

Settles a verified x402 payment on-chain (broadcasts the transfer, confirms it, and records a ledger entry), returning the settlement result with an on-chain transaction reference.

## Request body

- object
  - `feeQuoteId` string
  - `payment` PaymentPayload, required
    - `amount` string, required
    - `asset` string, required
    - `expiresAt` string, date-time
    - `from` string
    - `metadata` object
    - `network` string, required
    - `nonce` string, required
    - `payee` string
    - `payer` string
    - `scheme` 'exact' | 'upto' | 'batch-settlement', required
    - `signature` string, required
    - `to` string
  - `reference` object
  - `shielded` boolean

## Response `200`

OK

- SettleResponse
  - `batchId` string
  - `error` string
  - `ledgerTxId` string
  - `onChainTx` string
  - `settled` boolean, required

## Other responses

- `402` — x402 payment required

---

[API](https://skmtc.net/tiny/apis/tiny-place-network-api.md) · [All operations](https://skmtc.net/tiny/apis/tiny-place-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiny/tiny-place-network-api/revisions/fb85a82845ac/schema)