Cryptomus Alternative — Migrate to NearPayments
NearPayments implements a Cryptomus-compatible REST API. Migrating is as simple as changing the base URL and updating your authentication headers.
Step 1: Create a Storefront
Section titled “Step 1: Create a Storefront”Open @NearPayments_bot on Telegram and create a storefront.
Step 2: Configure Wallets
Section titled “Step 2: Configure Wallets”Set up your settlement addresses. You can either:
- Enter addresses manually for each chain
- Use Import from HD Wallet to auto-configure all chains from a BIP-39 seed phrase
Step 3: Generate an API Key
Section titled “Step 3: Generate an API Key”Go to the API tab in your storefront and generate a new key. The IPN secret acts as your Cryptomus API key — use it to compute the sign header for request authentication.
Step 4: Update Your Code
Section titled “Step 4: Update Your Code”Change the base URL:
const BASE_URL = "https://api.cryptomus.com/v1";const BASE_URL = "https://api.nearpayments.io/cryptomus/v1";Use your storefront’s merchant UUID as the merchant header:
headers: { "merchant": "YOUR_CRYPTOMUS_MERCHANT_ID" }headers: { "merchant": "YOUR_NEARPAYMENTS_MERCHANT_UUID" }Use your IPN secret to compute the sign header (same signing algorithm as Cryptomus):
const sign = md5(base64_encode(JSON.stringify(body)) + YOUR_CRYPTOMUS_API_KEY);const sign = md5(base64_encode(JSON.stringify(body)) + YOUR_NEARPAYMENTS_IPN_SECRET);What’s Compatible
Section titled “What’s Compatible”| Endpoint | Method | Supported |
|---|---|---|
/payment | POST | Yes |
/payment/info | POST | Yes |
/payment/list | POST | Yes |
/payment/services | POST | Yes |
/payment/resend | POST | Yes |
/exchange-rate/{currency}/list | GET | Yes |
/test-webhook/payment | POST | Yes |
What’s Different
Section titled “What’s Different”- Zero platform fees — NearPayments doesn’t charge percentage-based fees
- NEAR Intents — cross-chain settlement is handled via NEAR Protocol’s intent system
- Telegram-first — storefront management is done through a Telegram Mini App
- Self-custody — payments go directly to your wallet addresses