Xflow - Changelog

Changelog

This changelog lists all additions and updates to the Xflow API, in chronological order. The changelog has two levels; the first level lists the actual API version. This first level almost always refers to breaking-API changes. The second level lists out the dates on which non-breaking changes to the API version were made.


2024-02-05

2024-08-01

  • We've introduced a new parameter, live_fx, on the AccountSettings object to enhance the flexibility of payouts processing. This boolean parameter lets you control whether payouts are processed immediately for all connected users (platforms) or for you (direct users). When set to true, payouts are processed instantly. When set to false, payouts adhere to the configured payout schedule in the AccountSettings object.

2024-06-14

  • We've unshipped two endpoints, v1/accounts/activate_address and v1/accounts/deactivate_address. These endpoints were part of our legacy modeling and since then, we've substituted the functionality provided by these endpoints by providing more finer grained control to our users through explicit address creation. While technically this is a breaking change, we've ensured that before unshipping, no one was using these endpoints and consequently, there was no user impact.

2024-03-03

  • We've improved the API reference documentation by enabling additional filters for the address object across all API versions

2024-02-29

  • Xflow now supports an additional 10 currencies - AUD, HKD, SGD, AED, CHF, CZK, DKK, NOK, PLN and SEK. This is in addition to the already existing supported currencies USD, EUR and GBP. You can now use the POST v1/addresses endpoint to the spin up Virtual Bank Account Numbers (VBANs) at the platform, user, connected user and partner level
  • With the addition of the above currencies, we've updated our Balance object to support balances across the above currencies. We've also added support for these currencies in FeePlans to allow you to configure fees at a granular level
  • You can also configure default addresses (aka VBANs) for connected users and partners

2024-02-05

  • Xflow is now live with it's second version of the API. This version support's multi-currency (a long standing ask!), the ability to configure fees for (i) payouts and (i) FX related to payouts and transfers and configure account settings for direct users, platforms and their connected users
  • We've also introduced API versioning using the Xflow-Account header parameter and ensured that nothing breaks for existing Xflow users :)

2023-04-12

2023-10-16

  • The Xflow Dashboard has a fresh coat of paint for the direct users. Check out the experience and let us know what you think!
  • The Dashboard has also been upgraded to add native support for invoice creation and management
  • Payment Links now support PayPal as a payment method

2023-09-11

  • We've added support for setting FX reference rates as mid_market or inter_bank. This can be set for direct users, platforms and connected users. This capability should especially provide more flexibility for platforms to set competitive pricing for their connected users.

2023-08-28

  • We've added support for three new entity types: partnership, sole_proprietor and individual! This is in addition to the already supported company and limited_liability_partnership
  • In addition, we simplified our onboarding requirements for the above entity types. This will ultimately translate into a more seamless and faster onboarding experience
  • We now support setting minimum fees per payout. This can be set using the parameter account.fees.payouts.minimum[]
  • We've enabled filters for the ExchangeRate and person objects!

2023-08-14

  • You can now use POST v1/transfers to move funds between partners, users and platforms!
  • We've also provided the ability for you to add a transfer.description when you create or update a transfer
  • Platform pre-funding is now enabled for all platforms! You can now set connected user fees independent of platform passthrough fees and make Xflow whole by pre-funding a new address of category xflow_fee_advance. We've also added balance.fee_advance to show this new balance compartment
  • You can now enable both payout fees, specifically account.fees.payout.variable and account.fees.payout.fixed[] at the same time!
  • We've enabled filters for the address object!

2023-08-03

  • We've released filters for our API documentation! These filters will help you to determine precisely what parameters are optional or required for relevant requests. Check out the account object to see this capability in action!

2023-07-28

  • You can now receive funds from partners at a user or a connected user level through an address of category xflow_receive. In other words, Xflow will enable funds acceptance through Virtual Bank Account Numbers (VBANs) at the platform, user and connected user level
  • You can now reconcile funds directly from users through a single reconcile request

2023-07-26

  • Added account.payouts.reason_code_not_enabled parameter to the account object which tracks why an Xflow account has its payouts on hold

2023-06-23

  • Added GET v1/balance/aggregate endpoint which returns aggregated partner pending balance
  • balance.pending[] at a user-level is now exclusive of all partner-level pending balances
  • Added balance.payout_processing[]. This tracks funds that are being processed for payouts
  • Made improvements to the integration guide

2023-06-05

  • Added account.address parameter to the account object which tracks when an address of category xflow_receive has been activated
  • Added a new event account.address.activated which is occurs when the above account.address parameter moves to activated

2023-06-01

  • Added GET v1/quotes. Using this, you can pull indicative FX rates for the buy or sell currency and amount

2023-05-20

  • Added 3 new events: address.created, address.status.activated and address.status.deactivated
  • The balance object can now be retrieved by account of type partner, user and platform
  • Added VBAN details (like bank name, bank address and bank account type) to the integration guide
  • Made improvements to the integration guide

2023-04-27

  • Added file_request_body_invalid to return a 400 if an invalid multipart request body is used to upload a file
  • Added address.wallet.provider as a list parameter on the address object
  • Added address_global_wire_not_supported to return a 400 if an invalid Business Identifier Code (BIC) is associated with an address.bank_account.number
  • Made improvements to the integration guide

2023-04-12

  • Hello world! This is the first version of the Xflow API!