Skip to main content
This page tracks every significant change to the VelaFi API platform, including new endpoints, workflow updates, webhook additions, and documentation improvements. Review this changelog whenever you upgrade your integration or want to take advantage of new features. Changes are listed in reverse chronological order.

​
2026-09-18 — Pix - Woovi Liveness

​
2026-09-14 — Argentine Alias and CVU Lookups

​
2026-09-07 — Fee Breakdown on Order Detail

  • GET /v2/order/detail now includes orderFeeDetail for fiat-to-crypto and crypto-to-fiat orders, with grossAmount, netAmount and feeLines.
  • For fiat-to-fiat orders, it includes onRampOrderFeeDetail and offRampOrderFeeDetail.

​
2026-05-28 — Sandbox Crypto Deposit Simulator

  • New sandbox-only endpoint /v2/platform/test/crypto/deposit adds test crypto funds to a merchant. See Sandbox Testing Tools.

​
2026-04-23 — Order Failure Details

  • GET /v2/order/detail now returns failCode and failReason for fiat-to-crypto and crypto-to-fiat orders.

​
2026-04-22 — Remarks on Crypto Withdrawals

​
2026-04-17 — Payment Template Metadata

​
2026-02-28 — Order Expiry Timestamp

  • GET /v2/order/detail returns orderExpireTimestamp while an order is awaiting its crypto deposit (orderStatus 32).

​
2026-02-05 — Sandbox Fiat Deposit Simulator

  • New sandbox-only endpoint /v2/platform/test/deposit simulates a bank deposit to a merchant’s activated fiat account. See Sandbox Testing Tools.

​
2026-01-17 — Quote IDs

  • Crypto quotes (GET /v2/user/crypto-quote) and fiat quotes (GET /v2/user/fiat-quote) accept an optional createQuoteId parameter and return quoteId.
  • POST /v2/order/fiat_to_crypto, POST /v2/order/crypto_to_fiat and POST /v2/order/fiat_to_fiat accept quoteId.

​
2026-01-08 — Virtual Accounts

​
2025-12-12 — Bank Order ID on Order Detail

​
2025-12-01 — Fiat Flow Records

​
2025-11-18 — Guides and API Reference Updates

This release delivers broad documentation improvements covering the merchant onboarding workflow, a brand-new Limits guide, and updated API reference pages for merchant limit management.

​
Guides

Updated the onboarding workflow description to improve clarity and reflect the latest merchant setup process.
Updated the KYC/KYB merchant creation process, including clearer guidance on verification steps and requirements.
Updated the merchant account activation flow with a clearer explanation of fiat account activation requirements.
Added a new guide introducing merchant limit levels, approval criteria, and instructions on requesting limit upgrades.

​
API Reference

Updated the API response structure to include merchant limit information and related fields.
Updated the KYC/KYB workflow for merchant creation. Added improved API request and response examples.
Updated API fields related to merchant limits, including limit status and approval/rejection reasons.
Updated the activation flow for individual merchants’ fiat accounts.
Updated the activation flow for business merchants’ fiat accounts with refined workflow requirements.
Updated API response fields related to merchant account limits and limit status tracking.
Updated the merchant limit upgrade process with revised approval logic and enhanced parameter definitions.

​
2025-06-13 — KYC/KYB Merchant Creation Workflow

This release transitions the merchant creation workflow to the KYC/KYB model and introduces the Activate Merchant Account endpoint.
Endpoints released before 2025-06-13 will remain functional temporarily but are scheduled for deprecation. Migrate to the new KYC/KYB flow as soon as possible to avoid disruption.

Workflow Update: Merchant Creation

The merchant creation process has been updated to adopt the KYC/KYB model. Refer to the Creating Your Merchant guide for the updated steps and verification requirements.

API Update: Create Merchant Endpoint

The create merchants API endpoint has been updated to align with the new KYC/KYB process. Update your integration to use the revised request schema.

New Guide: Activate a Merchant Account

A new guide step covers activating fiat accounts once a merchant entity is successfully created, ensuring the merchant is fully operational for fiat transactions.

New Endpoint: Activate Merchant Account

A new API endpoint enables merchants to activate their fiat account after initial merchant setup is complete. This is required before the merchant can process fiat transactions.

​
2025-05-08 — Funding Records Webhook Fields and Transfer Endpoint

This release enhances the Funding Records Message Push webhook with richer payer information and adds an internal fund transfer endpoint.

​
Funding Records Message Push Webhook

The webhook payload now includes two new fields to provide more detailed funding record information for better tracking and management of fund sources.
​
string
Name of the entity sending funds.
​
string
Bank account of the entity sending funds.

​
New Endpoint: Internal Fund Transfer

Added the POST /v2/merchant/transfer endpoint for initiating internal fund transfers between accounts.

​
2025-04-14 — Pending Fund System

This release introduces the Pending Fund system — a new payment method, three new API endpoints, and a dedicated webhook for real-time event notifications.

​
New Payment Method: VelaFi Pending Fund (ID: 70)

When creating an order via API, you can now select VelaFi Pending Fund (payment ID 70) as the payment or receiving method. Using preloaded funds enables faster transaction processing by bypassing external transfer confirmation delays.

​
New API Endpoints

1

Retrieve Pending Fund

Query your Pending Fund account balance and status via API. You can also preload funds into the account to avoid delays from external transfer confirmation during live transactions.Location: API Reference → Merchant
2

Claim Pending Fund

Withdraw available balances from the Pending Fund account to a specified payment method at any time. This provides flexible, on-demand fund management.Location: API Reference → Merchant
3

Retrieve Funding Records

Fetch detailed records of all Pending Fund-related activities — including deposits, withdrawals, usage, and refunds — for full traceability and financial transparency.Location: API Reference → Merchant

​
New Webhook: Funding Records Message Push

Funding Records Message Push

Receive real-time webhook notifications for Pending Fund events. Each notification delivers structured transaction data to your endpoint, improving operational automation and fund monitoring.Location: Webhooks