Skip to main content

​
Payment Tools

These are the core money-moving tools in PIXA.

​
pay

pay signs an x402 payment authorization. Use it when:
  • a seller returns 402 Payment Required
  • an API needs a payment header before it will return content
  • the agent already knows the payment amount and network
The tool is designed to return the payment header value that the caller can attach to the seller request.

​
x402_fetch

x402_fetch fetches a URL and handles the payment-required round trip. Use it when:
  • the agent wants one call instead of manually fetching and retrying
  • the service is x402-enabled
  • the flow should stay inside PIXA instead of custom code

​
Practical rule

If the API is on a non-Algorand chain, PIXA may first need to route value through the hub or a hosted flow before the request can complete. That is why the docs should always describe the payment path clearly.