Skip to main content
POST
/
v1
/
x402
/
settle
Settle payment
curl --request POST \
  --url https://api.swiftpay.finance/v1/x402/settle \
  --header 'Content-Type: application/json' \
  --data '
{
  "x402Version": 2,
  "paymentPayload": "eyJ4NDAyVmVyc2lvbiI6Miwi...",
  "paymentRequirements": {
    "scheme": "exact",
    "network": "eip155:8453",
    "amount": "100000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0xForwarderAddress...",
    "maxTimeoutSeconds": 300,
    "extra": {
      "name": "USDC",
      "version": "2",
      "merchantId": "m1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "endpointId": "e1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
  }
}
'
{
  "success": true,
  "transaction": "0xabc123def456...",
  "network": "eip155:8453",
  "payer": "0xpayeraddress...",
  "amount": "100000",
  "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "paymentId": "p1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "settledAt": "2026-04-27T12:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.swiftpay.finance/llms.txt

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

Body

application/json
​
x402Version
integer
required
Example:

1

​
paymentPayload
string
required

Base64-encoded EIP-3009 payment payload from the X-PAYMENT header

Example:

"eyJ4NDAyVmVyc2lvbiI6MSwi..."

​
paymentRequirements
object
required

One accepted payment option, returned inside a 402 response body and passed back unchanged when calling settle.

Response

Settlement succeeded. Encode the response body as JSON in the X-PAYMENT-RESPONSE header.

Returned by POST /v1/x402/settle. Encode as JSON in the X-PAYMENT-RESPONSE header.

​
success
boolean
​
transaction
string

On-chain transaction hash

Example:

"0xabc123def456..."

​
network
string

CAIP-2 network where settlement occurred

Example:

"eip155:8453"

​
payer
string

Payer wallet address (lowercase)

Example:

"0xpayeraddress..."

​
amount
string

Token base units transferred

Example:

"100000"

​
asset
string

Token contract address

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

​
paymentId
string<uuid>

SwiftPay payment record ID

​
settledAt
string<date-time> | null
​
error
string

Machine-readable error description when success=false