TWtwzrd
x402 Facilitator (Path B)

Verify an x402 payment payload

Changed on

Path B facilitator /verify: validate payment payload against requirements with no chain write (strict template + reservation lookup). Policy failures usually return HTTP 200 with isValid=false; malformed body is 400.

post/verify

Request

  • Base URL
    https://intel.twzrd.xyz
  • Auth
    none required

Request body

x402Versioninteger

x402 v2; may also appear only on paymentPayload.

paymentPayloadobject required

x402 PaymentPayload (includes partially-signed SVM tx).

paymentRequirementsobject required

Must equal payload.accepted under strict policy; extra.feePayer must be GWRLgRB6diC2zG9BaoGJsan9T8JvJCk7usFruiefnfMP.

Response

Verify result. isValid=true when policy+payload OK; isValid=false with invalidReason for policy/replay rejects (still HTTP 200 for scheme outcomes).

isValidboolean required
invalidReasonstring nullable

Set when isValid=false. Examples: policy:* reasons, duplicate_settlement, policy:reservation_unavailable, bad_request:…

invalidMessagestring nullable
payerstring nullable

Base58 payer pubkey when known.

extensionsunknown
extraunknown
detailstring

Example response

{
  "isValid": true,
  "invalidReason": null,
  "payer": "64NsKhbNGZCEj6sgTtjzscfuXSZSEpD1GoBXbT45yv4J"
}

Changes