pay.shdocs
Pay For APIs

Call paid APIs

Wrap curl, fetch, or wget and let pay handle HTTP 402 challenges.

Use pay with the HTTP tool you already planned to use. pay forwards the request, detects supported 402 challenges, signs a proof after authorization, and retries.

Agent summary

  • Use pay --sandbox curl for examples and tests.
  • Preserve method, headers, body, and gateway URL.
  • Use pay fetch for simple JSON-friendly requests without an external client.
  • Use pay wget only for download-shaped tasks.

curl

pay --sandbox curl https://payment-debugger.vercel.app/mpp/quote/AAPL

Pass curl flags after curl:

pay --sandbox curl https://example.gateway/v1/search \
  -H 'content-type: application/json' \
  -d '{"query":"test"}'

fetch

pay --sandbox fetch https://payment-debugger.vercel.app/mpp/quote/AAPL
pay --sandbox fetch https://example.gateway/v1/search -H 'content-type: application/json'

wget

pay --sandbox wget https://example.gateway/v1/export.csv

On this page