Two fairness fixes for wallet-paid (x402) API calls landed this week.
Bad requests are now free. Your request body is parsed and validated
before the USDC payment settles. A malformed body gets a 400 with a
hint, an example of the expected shape, and links to the docs - and
no payment is taken. Fix the request and retry at no cost. Previously a
request that failed validation could still settle the payment.
Failed renders refund themselves. If a payment does settle and we then fail to deliver your PDF - a template error, a crash on our side, anything - the full settled amount is refunded to the paying wallet in USDC on the same network, automatically, usually within minutes. No support ticket needed. The refund transaction hash is recorded, so if you ever believe a refund is missing, contact support with your original payment's transaction hash.
This applies to every x402-priced endpoint: /api/v1/md,
/api/v1/render, and /api/v1/enhance. Credit-billed (API key)
callers are unaffected - failed renders have always deducted zero
credits on that path.