Developers
Build on the Payaries API, by hand or with an AI agent
A REST API, a published OpenAPI contract and guides that start from a working request. Everything here is also available as markdown, so a coding assistant can read it as easily as you can.
Build it with an AI agent
Give this to your AI agent
Paste it into Claude Code, Cursor or any agent that can read a URL. It reads the OpenAPI contract and the signing recipe, and follows the rules for handling real funds.
Read https://www.payaries.com/ai-agents.md and integrate Payaries crypto payments into this project. Follow its rules for handling real funds.Never paste your API secret into an agent. Keep it in an environment variable.
Start here
From a new account to your first confirmed payment.
- 01Crypto payment API quickstart: from signup to your first payoutTake your first crypto payment through the Payaries API: create a key, submit the business profile, create an invoice, handle the webhook and withdraw. Real requests and responses.
- 02How to sign crypto payment API requests (HMAC-SHA256)How to sign Payaries API requests with HMAC-SHA256, with working Node.js, Python, Go and shell code and published test vectors to check your implementation against.
- 03A crypto payment API that behaves like the rest of your stackA REST crypto payment API: create an invoice, get a one-time deposit address, receive signed webhooks and withdraw on demand. HMAC-signed and idempotent.
Go deeper
The parts of an integration that fail in production if you skip them.
- 01How to verify crypto payment webhook signaturesVerify a crypto payment webhook's HMAC-SHA256 signature against the raw body, guard against replays, dedupe retries and acknowledge fast — with working Node.js code.
- 02Crypto payment API errors, rate limits and safe retriesEvery status code and error code the Payaries API returns, what each means, whether to retry it, the rate limits, and a retry loop that never double-pays.
- 03Withdrawing crypto through the API: quote, idempotency and approvalHow to withdraw crypto through the Payaries API: check the balance, quote the fees, create an idempotent withdrawal, follow its status and understand auto-approval.
- 04Handling underpaid, late and unmatched crypto paymentsWhat to do when a customer underpays, pays after an invoice expires or sends money that matches no invoice — and how to build order logic for each.
- 05Crypto payment confirmations, explained for merchantsHow blockchain confirmations work for merchants: what each invoice status means, when a payment counts as paid, and credited vs withdrawable.
Build with AI
Let a coding assistant do the typing, with the safety rules built in.
Machine-readable resources
Next
Create a test key and run a real invoice.
Test keys work immediately, with no approval step. Payaries runs on real mainnet networks, so use a small real payment to test.