Quick Start

From zero to your first live payment in under 5 minutes.

1
Create an Account
Sign up at griffnode.com/signup and verify your email address.
2
Add a Wallet
In your Dashboard, go to Wallet Management and add the extended public key (xpub) for each crypto you want to accept.
HD Wallets only. GriffNode derives a fresh deposit address per transaction from your xpub. Your funds go directly to your wallet — GriffNode never holds them.
3
Get Your API Key
Navigate to API Integration in your Dashboard. Use sk_test_... while building, switch to sk_live_... when you go live.
4
Create a Transaction
POST to /transactions/create with the crypto, amount in USD, and currency:
POST  /transactions/create
curl -X POST https://api.griffnode.com/v1/transactions/create \
  -H "Authorization: Bearer sk_test_a1b2c3d4e5f6..." \
  -H "Content-Type: application/json" \
  -d '{
    "crypto": "BTC",
    "amount": 25.00,
    "currency_fiat": "USD"
  }'
5
Read the Response
A successful request returns HTTP 201. Use the payment_url to redirect your customer:
Response — 201 Created
{
  "success": true,
  "data": {
    "transaction_id": "MTX-A1B2C3D4",
    "status": "pending",
    "crypto": "BTC",
    "deposit_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "amount_crypto": 0.00025431,
    "amount_fiat": 25.00,
    "amount_usd": 25.00,
    "currency_fiat": "USD",
    "fiat_to_usd_rate": 1.0,
    "exchange_rate": 98300.00,
    "expires_at": "2026-03-08T11:30:00Z",
    "payment_url": "https://griffnode.com/transaction/MTX-A1B2C3D4"
  }
}
6
Get Notified on Completion
Set up a webhook in your Dashboard to receive a payment.completed event the moment payment confirms on-chain. See Webhook Setup →
Ready to go live?
Replace sk_test_ with your sk_live_ key and you're done. For SDK examples in Node.js, Python, PHP, Go and more, visit the GriffNode GitHub →