Quickstart

1. Open the Telegram Bot

   Start a conversation with @NearPayments_bot on Telegram.

2. Create a Storefront

   Tap “Create Storefront” and give it a name. This represents your business or project.

3. Configure Wallets

   Go to Settings → Enabled Blockchains. Either:

   • Set addresses manually for each chain, or
   • Use Import from HD Wallet to auto-configure all 16 chains from a BIP-39 seed phrase

4. Generate an API Key

   Go to the API tab and generate a key. Copy it — it’s only shown once.

5. Create a Payment

   curl -X POST https://api.nearpayments.io/v1/payment \
     -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "price_amount": 10,
       "price_currency": "usd",
       "pay_currency": "btc",
       "order_id": "order-001"
     }'

6. Check Payment Status

   curl https://api.nearpayments.io/v1/payment/PAYMENT_ID \
     -H "x-api-key: YOUR_API_KEY"

Payment Flow

waiting → confirming → confirmed → sending → finished

Alternative statuses: partially_paid, failed, refunded, expired