Skip to main content

​
Prerequisites

  • A Myaza account — sign up here
  • An API key from your dashboard under Settings → API Keys

​
1. Authenticate

All blockchain operations use your API key in the X-API-Key header. 
curl https://myaza-blockchain-core.onrender.com/api/v1/health \
  -H "X-API-Key: YOUR_API_KEY"

​
2. Generate a Wallet

Generate a crypto wallet on any supported chain. 
curl -X POST https://myaza-blockchain-core.onrender.com/api/v1/crypto/wallets/generate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain": "polygon"}'
Response
{
  "address": "0x1A2B3C4D5E6F...",
  "privateKey": "0xabcdef...",
  "mnemonic": "word1 word2 word3 ..."
}
Store the privateKey and mnemonic securely — they cannot be recovered if lost. Never expose them client-side.

​
3. Check a Balance

curl "https://myaza-blockchain-core.onrender.com/api/v1/crypto/polygon/address/0x1A2B3C4D5E6F.../balance" \
  -H "X-API-Key: YOUR_API_KEY"

​
4. Create a POS Payment Session

Start a payment session so a customer can pay in crypto. 
curl -X POST https://myaza-blockchain-core.onrender.com/api/v1/pos/sessions \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "currency": "USD",
    "chain": "polygon",
    "token": "USDC",
    "metadata": {"orderId": "order_123"}
  }'

​
5. Listen for Webhooks

Configure a webhook URL in your dashboard and Myaza will POST to it when a transaction lands.
Webhook Payload Example
{
  "id": "wh_123...",
  "chain": "polygon",
  "address": "0x1A2B3C4D5E6F...",
  "symbol": "USDC",
  "amount": "100.0",
  "txId": "0xabcdef...",
  "status": "delivered",
  "createdAt": "2025-01-15T10:30:00.000Z"
}
See the full Webhook Integration Guide for verification, retry logic, and best practices.

​
Next Steps

Authentication

Learn about API keys, JWT tokens, and scopes

Blockchain API

Full wallet, transfer, and balance reference

Accepting Payments

End-to-end guide for crypto payment flows

Webhook Integration

Real-time notifications setup guide