Welcome to the Zelling changelog! Here you can find the latest updates, improvements, and fixes.

📢 Important API Update

Hey everyone!
From now on:

⛔ We are ending updates for API v1 – our full focus is now on API v2

🚧 We’re working 100% on completing the final version of Zelling

✏️ On this channel you will find:

Changelogs for the new API

Official updates on version v2

Devlogs and code snippets from our development progress

Thank you for being with us and supporting our project!
Best regards,
The Zelling Team 💚

[v1.1.4] – Split Address Support

🎉 New Features and Changes

✅ Split payouts using multiple addresses

You can now send a single payment to multiple crypto addresses using the addresses field instead of payout_address.

Each entry in addresses must include:

address: the recipient wallet address

percent: the percentage of the total payment to send to this address

The sum of all percent values must equal exactly 100%

You cannot use payout_address in the same request if addresses is provided

Each address must be unique

Allows automatic distribution of funds across multiple recipients while ensuring precise validation

Documentation: Creating New Crypto Payment

🛠️ Fixes & Improvements

Improved validation for split payouts:

Ensures total percentage is exactly 100%

Prevents duplicate addresses

Validates all addresses for the selected cryptocurrency

Encouraging developers to explore the updated documentation to make full use of this feature

[v1.1.3] – Currency Information & Socket Security Update

🎉 New Features and Changes

✅ Get information about a given currency

Endpoint: /v1/currencies/:currency

Pass a currency code (e.g., USD, EUR, GBP) to get latest exchange rates for 1 unit of that currency in multiple supported currencies.

Rates are continuously updated to reflect current market values.

Useful as a helper function if you use Zelling API as a wrapper in your store or internal tools.

Supported currencies: USD, EUR, GBP, CAD, JPY, AED, MYR, IDR, THB, CHF, SGD, RUB, ZAR, TRY, LKR, RON, BGN, HUF, CZK, PHP, PLN, UGX, MXN, INR, HKD, CNY, BRL, DKK, TWD, AUD, NGN, SEK, NOK, UAH, VND.

Documentation: Get information about a given currency

✅ Improved Socket.IO security

Removed sending of webhookUrl, meta, and hostedUrl from socket events.

Prevents exposure of private information if someone uses only Zelling.io API without their own wrapper.

Protects sensitive data and prevents previewing webhook links.

🛠️ Fixes & Improvements

Standardized response format for easier frontend and backend integration.

Error handling improved: unsupported currencies now return clear CURRENCY_NOT_SUPPORTED message.

[v1.1.2] – Socket.IO Real-Time Updates Update

🎉 New Features and Changes

✅ Separate subscription channels for payment types:

tid subscriptions for crypto payments.

pid subscriptions for PayPal payments.

Enables more granular control and prevents event collisions between payment types.

✅ Real-time event payload updates:

Crypto payments emit payment_update with full blockchain details, confirmations, and partial payments.

PayPal payments emit payment_update with pid, currency, amountExpected, amountReceivedTotal, status, payoutEmail, senderEmail, note, webhookUrl, hostedUrl, meta.

Allows frontends to react instantly to payment confirmations or partial payments.

✅ Improved subscription management:

Added explicit subscribe and unsubscribe events for both tid and pid.

Clients can join or leave specific rooms for selective updates.

✅ Reliability & stability improvements:

Socket server initialization checks to prevent multiple instances.

Logging standardized for connect, disconnect, subscribe, unsubscribe events.

🛠️ Fixes & Improvements

Fixed potential race conditions when multiple clients subscribe/unsubscribe simultaneously.

General performance optimizations for high-frequency payment updates.

[v1.1.1] – PayPal Integration Update

🎉 New Features and Changes

✅ Added PayPal F&F support:

Create and manage PayPal payments via Zelling API.

Instant updates via webhook notifications on payment status changes.

Include additionalInformation field in creation and webhook payload.

✅ Webhook improvements:

Every status change (NEW, PARTIALLY_PAID, CONFIRMED) triggers a webhook.

Webhook payload now includes: pid, currency, amountExpected, amountReceivedTotal, status, payoutEmail, senderEmail, note, webhookUrl, hostedUrl, meta.

Payload includes additionalInformation if provided.

✅ Backend validation enhancements:

additionalInformation max length: 2048 characters.

note uniqueness enforced; auto-generates a new note if collision occurs.

Optional webhook_url validation only if provided and non-empty.

🛠️ Fixes & Improvements

Standardized status handling for PayPal payments.

Accumulated partial payments correctly update AmountReceivedTotal.

Instant status update triggers webhooks only when the endpoint returns HTTP 200.

Improved logging for IPN processing and webhook delivery failures.

Info:

Webhook IPN for PayPal (https://api.zelling.io/v1/paypal/ipn) | has Anti-Spoof PayPal verifies the payload received in the webhook so you don't have to worry about your integration being susceptible to spoof.

[v1.1.0] – Payment validation and security update

🎉 New Features and Changes

✅ Field validation for creating payments:

currency – string, max 10 characters

crypto_coin – string, max 20 characters; supported: BTC, ETH, LTC, BCH, DOGE, BNB, TRX, XMR, ERC20/USDT

payout_address – validated according to selected crypto

amount – number > 0 and ≥ the minimum for the selected crypto (minimumTransactionCoin) in a given cryptocurrency

meta – object, max 10 keys, values as string ≤ 255 characters

webhook_url – optional, valid URL, max 2048 characters

ℹ️ Improved message for invalid payout address:

"Invalid payout_address. Please make sure you entered a correct address for the selected crypto_coin (BTC)."

❌ Removed webhookUrl and meta fields when fetching a transaction by TID.
These fields are now only available in the webhook payload sent upon transaction update.

💰 Added minimumTransactionCoin when fetching info for a single cryptocurrency.
Previously, it was only available when fetching the list of all cryptocurrencies.

🛠️ Fixes

Standardized error formats (INVALID_PAYOUT_ADDRESS, AMOUNT_TOO_LOW, etc.) across the API

Unified error messages and codes for easier handling on the client side

Stay up to date and make sure your integration uses the latest validations and security improvements!
💬 Join our community on Discord: https://discord.gg/zelling

Changelog

📢 Important API Update#

[v1.1.4] – Split Address Support#

[v1.1.3] – Currency Information & Socket Security Update#

[v1.1.2] – Socket.IO Real-Time Updates Update#

[v1.1.1] – PayPal Integration Update#

[v1.1.0] – Payment validation and security update#

📢 Important API Update

[v1.1.4] – Split Address Support

[v1.1.3] – Currency Information & Socket Security Update

[v1.1.2] – Socket.IO Real-Time Updates Update

[v1.1.1] – PayPal Integration Update

[v1.1.0] – Payment validation and security update