Creating new Crypto payment

⚡ Rate Limit Information

By default, the Zelling API has a rate limit of 35 requests per minute.
If you need higher limits (or want them removed), please contact us on Discord and we will adjust it for your project.

💬 Join here: https://discord.gg/zelling

Supported Cryptocurrencies

When creating a payment, the crypto_coin field must be one of the following supported cryptocurrencies:

Symbol	Name
BTC	Bitcoin
ETH	Ethereum
LTC	Litecoin
BCH	Bitcoin Cash
DOGE	Dogecoin
BNB	Binance Coin
TRX	Tron
ERC20/USDT	Tether (USDT on Ethereum)
SOL/SOL	Solana

Note: You must also provide a valid payout_address corresponding to the selected cryptocurrency. This is the wallet address where the funds will be sent.

Important: The amount of cryptocurrency sent must be equal to or greater than the minimum_transaction_coin for the selected crypto, which you can retrieve from the Get information about a given cryptocurrency endpoint (/v1/crypto-info).
If the amount is smaller than minimum_transaction_coin, the payment will remain unconfirmed permanently and no webhook notification will be sent.

Payout Address vs Split Addresses

payout_address:
When using payout_address, the entire payment amount minus fees is sent to this single address. You cannot use addresses in the same request.
addresses:
When splitting a payment among multiple recipients, provide an array of objects with address and percent. The sum of all percent values must equal exactly 100%. You cannot use payout_address in the same request.
- Each percent must be a number > 0 and <= 100.
- Each address must be unique.

⚠️ Reminder: The API validates that the sum of percent values is exactly 100%. Requests that do not satisfy this will be rejected.

Example of using addresses:

"addresses": [
  {
    "address": "Lbm9puUbw9FeaiVEyYmtkF8oRaH2HZwXaX",
    "percent": 60
  },
  {
    "address": "LN11EHj75RLm1Te4fHESPzNvYQHYd8561h",
    "percent": 40
  }
],

curl --location --request POST 'https://api.zelling.io/v1/payments' \ --header 'Content-Type: application/json' \ --data-raw '{ "currency": "EUR", "amount": 150.75, "crypto_coin": "LTC", "payout_address": "ltc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh", "webhook_url": "https://example.com/webhook", "meta": { "orderId": "ORD-001", "customerId": "12345", "notes": "Urgent payment" } }'

{ "message": "Payment created successfully", "data": { "tid": "TID123456", "address": "ltc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh", "qrCodeBase64": "data:image/png;base64,iVBORw0KGgoAAAANS...", "currency": "eur", "amount": 150.75, "cryptoCoin": "ltc", "cryptoAmountExpected": 0.01234, "status": "NEW", "webhookUrl": "https://example.com/webhook", "hostedUrl": "https://pay.zelling.io/TID123456", "meta": { "orderId": "ORD-001", "customerId": "12345" }, "splitPayoutAddresses": [ { "address": "Lbm9puUbw9FeaiVEyYmtkF8oRaH2HZwXaX", "percent": 60 }, { "address": "LN11EHj75RLm1Te4fHESPzNvYQHYd8561h", "percent": 40 } ] } }

Creating new Crypto payment

Supported Cryptocurrencies

Payout Address vs Split Addresses

Request

Responses