# Building on BlindPay, explained.

API keys, environments, webhooks, SDKs and AI agents: what developers ask before and during a BlindPay integration.

Last updated: 2026-11-19

- 5: official SDKs: Node.js, Python, Go, PHP and Swift
- 1: API host for development and production
- 25: webhook endpoints per instance
- 24 h: idempotency window for safe retries

## Install the client for your stack.
Every SDK wraps the same REST API. For any other language, generate a client from the OpenAPI spec or call the API directly.

| Language | Install |
| --- | --- |
| Node.js and TypeScript | npm install @blindpay/node |
| Python | pip install blindpay |
| Go | go get github.com/blindpaylabs/blindpay-go |
| PHP | composer require blindpay/php |
| Swift | Swift Package Manager, blindpaylabs/blindpay-swift |

## Access

### How do I authenticate API calls?
To authenticate BlindPay API calls, send your API key as a bearer token. Keys belong to one instance, are created in the dashboard, and are shown once.

### Is the sandbox on a different URL?
BlindPay development and production share api.blindpay.com. The instance behind your API key decides which environment the call runs in.

### Can I restrict a key to my servers?
Yes, BlindPay lets you restrict a key to your servers. Set an IP allowlist of IPv4 addresses when you create the key through the API.

## Testing

### How do I test without real money?
To test BlindPay without real money, use a development instance. It runs on the USDB test token, approves KYC automatically, settles payins in about 30 seconds, and treats request_amount 66600 as a failure and 77700 as a refund.

### Are there rate limits?
BlindPay development instances allow 40 requests per minute. Production has no per-instance cap, except the indicative FX endpoints at 300 requests per minute.

## Webhooks and retries

### How do webhooks work?
BlindPay webhooks let you register up to 25 HTTPS endpoints per instance and subscribe to all events or a list. Each delivery is signed with svix-id, svix-timestamp and svix-signature headers that you verify with your whsec_ secret.

### Which events can I subscribe to?
BlindPay webhooks cover customers, bank accounts, payins, payouts, payables, transfers, wallets, virtual accounts, terms acceptance and limit increases. Events fire when an object is created and as it changes, so you never poll for status.

### How do I retry a call safely?
To retry a BlindPay call safely, send an Idempotency-Key header of up to 255 characters with the exact same body. A retry within 24 hours replays the original response instead of creating a second payout.

## SDKs and AI agents

### Which SDKs are there?
BlindPay offers official SDKs for Node.js, Python, Go, PHP and Swift. A few endpoints, such as yield and card payments, are called over plain HTTP alongside the SDK.

### Can an AI agent use the BlindPay API?
Yes, an AI agent can use the BlindPay API. Connect it to the hosted MCP server at mcp.blindpay.com/mcp with OAuth, or run npx -y @blindpay/mcp locally with an API key. Coding agents can add Agent Skills with npx skills add blindpaylabs/skills.

## More FAQs
- [All FAQs](https://blindpay.com/faq): every product's questions on one page
- [Payouts](https://blindpay.com/faq/payouts): Stablecoins out to 12 bank rails.
- [Payins](https://blindpay.com/faq/payins): Bank transfers and cards in, stablecoins out.
- [Card payins](https://blindpay.com/faq/card-payins): Accept cards and settle in stablecoins.
- [Transfers](https://blindpay.com/faq/transfers): Move USDC across chains, swap to USDT or EURC.
- [Payables](https://blindpay.com/faq/payables): Pay boletos, Pix codes and invoices from stablecoins.
- [SWIFT, POBO and COBO](https://blindpay.com/faq/swift): International wires in your customer's name.
- [Virtual accounts](https://blindpay.com/faq/virtual-accounts): Account details in the US, Mexico and Colombia.
- [Wallets](https://blindpay.com/faq/wallets): Managed wallets and customer-owned addresses.
- [Offramp wallets](https://blindpay.com/faq/offramp-wallets): Every deposit becomes a bank payout.
- [Yield](https://blindpay.com/faq/yield): Earn on idle USDC in managed wallets.
- [Compliance](https://blindpay.com/faq/compliance): KYC, KYB, limits and information requests.
- [AI agents](https://blindpay.com/faq/ai-agents): MCP server, Agent Skills and the CLI.
- [Partner fees](https://blindpay.com/faq/partner-fees): Add your own fee to every transaction.

## Links
- Developer docs: https://blindpay.com/docs/sdks
- Sign up: https://app.blindpay.com/sign-up
- Book a demo: https://blindpay.com/contact
