Skip to main content
POST /settle The facilitator revalidates the payment, submits the guarantee to 4Mica Core, and returns settlement evidence. V2 issuance includes the signed validation policy but does not itself prove the job outcome.

Request body

x402Version
number
1|2
paymentPayload
object
required
The decoded payment payload accepted by /verify.
paymentRequirements
object
required
The original requirements advertised to the buyer.
paymentRequirements.extra
object
V2 validation policy fields are supplied here.

Responses

success
boolean
required
error
string
txHash
string
networkId
string
certificate
object
certificate.claims
string
certificate.signature
string
curl -X POST "https://x402.4mica.xyz/settle" \
  -H "Content-Type: application/json" \
  -d '{
    "x402Version": 1,
    "paymentPayload": {
      "x402Version": 1,
      "scheme": "4mica-credit",
      "network": "eip155:84532",
      "payload": {
        "claims": {
          "user_address": "0x1111111111111111111111111111111111111111",
          "recipient_address": "0x2222222222222222222222222222222222222222",
          "req_id": "0x1",
          "amount": "0x186a0",
          "asset_address": "0x3333333333333333333333333333333333333333",
          "timestamp": 1782122400,
          "version": 1
        },
        "signature": "0xSignedPayment",
        "scheme": "eip712"
      }
    },
    "paymentRequirements": {
      "scheme": "4mica-credit",
      "network": "eip155:84532",
      "maxAmountRequired": "100000",
      "payTo": "0x2222222222222222222222222222222222222222",
      "asset": "0x3333333333333333333333333333333333333333"
    }
  }'
{
  "success": true,
  "error": null,
  "txHash": null,
  "networkId": "eip155:84532",
  "certificate": {
    "claims": "0xEncodedCertificateClaims",
    "signature": "0xBlsSignature"
  }
}

Status codes

CodeDescription
200The payment was accepted and settlement evidence was returned.
400The payload and requirements are malformed or inconsistent.
500The facilitator or Core could not issue the guarantee.
Persist the certificate with the request and delivery record. See transaction lifecycle.