Settle

Validates a client's signed payment payload and, if valid, submits the payment transaction to the Casper Network. The facilitator's account pays the gas (motes) for the settlement deploy; the CEP-18 tokens are transferred from the payer to the payee via the transfer_with_authorization contract entry point.

POST /settle

Request body

The request body has the same shape as /verify.

Property	Type	Required	Description
paymentPayload	object	Yes	The signed payment payload submitted by the client.
paymentRequirements	object	Yes	The payment requirements declared by the resource server.

See Verify for the full schema of paymentPayload and paymentRequirements.

Response

The response always returns HTTP 200. The success field indicates whether settlement succeeded.

Property	Type	Description
success	boolean	true if the payment was settled on-chain, false otherwise.
transaction	string	Casper deploy hash of the settlement transaction (64 hex characters).
network	string	CAIP-2 network identifier where the payment was settled.
payer	string	Casper account hash of the payer.
errorReason	string	Machine-readable error code, present when success is false.
errorMessage	string	Human-readable error description, present when success is false.

Error codes

In addition to all verification error codes, the following codes may appear during settlement:

Code	Description
network_mismatch	The facilitator has no signing key configured for the requested network.
verification_failed	The payload failed pre-settlement verification.
build_deploy_failed	Failed to build the Casper TransactionV1.
sign_deploy_failed	Failed to sign the transaction with the facilitator's key.
put_deploy_failed	Failed to submit the transaction to the Casper Network.
wait_deploy_failed	The transaction was submitted but confirmation timed out or returned an execution error.

Example

curl -X 'POST' \
  'https://x402-facilitator.cspr.cloud/settle' \
  -H 'authorization: 55f79117-fc4d-4d60-9956-65423f39a06a' \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
    "paymentPayload": {
      "x402Version": 2,
      "resource": {
          "url": "http://127.0.0.1:3002/api/data"
      },
      "accepted": {
          "scheme": "exact",
          "network": "casper:casper-test",
          "asset": "9824d60dc3a5c44a20b9fd260a412437933835b52fc683d8ae36e4ec2114843e",
          "amount": "10000",
          "payTo": "0000000000000000000000000000000000000000000000000000000000000000",
          "maxTimeoutSeconds": 300
      },
      "payload": {
        "signature": "01a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f601",
        "publicKey": "0176197d7191ce519ed043221956a2227921abf30364d4362970229027ec828f04",
        "authorization": {
          "from":        "00048a54220799a48171743407c086668bdcc788e2a31e4185fe52d0682634f888",
          "to":          "009e5669b070545e2b32bc66363b9d3d4390fca56bf52a05f1411b7fa18ca311c7",
          "value":       "10000",
          "validAfter":  "1710000000",
          "validBefore": "1710000900",
          "nonce":       "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
        }
      }
    },
    "paymentRequirements": {
      "scheme": "exact",
      "network": "casper:casper-test",
      "payTo":  "009e5669b070545e2b32bc66363b9d3d4390fca56bf52a05f1411b7fa18ca311c7",
      "amount": "10000",
      "asset":  "9824d60dc3a5c44a20b9fd260a412437933835b52fc683d8ae36e4ec2114843e",
      "maxTimeoutSeconds": 900,
      "extra": {
        "name":     "Cep18x402",
        "version":  "1",
        "decimals": "2",
        "symbol":   "CSPR"
      }
    }
  }'

Successful settlement:

{
  "success": true,
  "transaction": "88461218a5e972fcda1d764d7cc4edb2e0c3a538123b97890d484f43c55935f5",
  "network": "casper:casper-test",
  "payer": "00048a54220799a48171743407c086668bdcc788e2a31e4185fe52d0682634f888"
}

Failed settlement:

{
  "success": false,
  "errorReason": "invalid_signature",
  "errorMessage": "signature verification failed",
  "transaction": "",
  "network": "casper:casper-test",
  "payer": ""
}