If you're a product lead at a marketplace, a vertical SaaS product or a payroll platform, you're really asking two questions. Which cross-border payments API should we build on, and what will running it actually cost us once it's live?
Most vendor pages answer neither. They list corridors and call it coverage.
This guide is built the other way round. It covers what to check in a provider's own documentation before you sign, what the integration genuinely involves stage by stage, and how platforms turn the flow into revenue.
It also covers the India regulatory layer that decides whether you can offer this at all. Where a figure comes from a vendor's own page, it's cited. Where research couldn't confirm something, it's tagged rather than smoothed over.
TL;DR
- A cross-border payments API gives your platform collections, multi-currency balances, FX, payouts, compliance, webhooks and reconciliation through one integration, instead of one bank relationship per corridor.
- The most checkable difference between providers is local collection versus wire routing. Wise Platform's docs show balances in 50+ currencies but local account details for only 10+ of them (docs.wise.com).
- Nobody publishes an accountable cross-border payments API integration SLA. Xflow's own marketing page claims "less than 2 weeks". The long pole is compliance and KYC onboarding, not the code.
- Platforms monetise through per-transaction fees, FX markup, revenue share, subscription tiers or a hybrid. Stripe Connect publishes full India unit economics, so that arithmetic can actually be checked.
- In India, cross-border collection sits under RBI's Payment Aggregator - Cross Border (PA-CB) framework. Whether your platform needs its own authorisation is genuinely unresolved, and any provider answering it flatly is overstating.
What a Cross-Border Payments API Actually Does
Strip out the marketing and you're buying seven capabilities. A cross-border payments API bundles them behind one set of credentials, so your team integrates once rather than per corridor.
- Collections - accepting funds from an overseas payer, either into local rails in that market or via international wire.
- Multi-currency balances - holding value in the currency received, so conversion timing is your decision rather than the bank's.
- FX conversion - the rate, the markup mechanic, and whether either is disclosed to you and to your end user.
- Payouts - sending funds onward to sellers, contractors or merchants, often across a different country footprint from collections.
- Compliance - KYC on your connected users, sanctions screening, purpose coding and the reporting attached to each flow.
- Webhooks - asynchronous state changes pushed to you, because settlement doesn't complete inside a request cycle.
- Reconciliation - fields and endpoints built for matching money to invoices, not a raw transaction dump you have to parse.
The structural distinction that matters for a platform is who the funds belong to. Xflow's developer documentation splits accounts into direct users, who accept funds for themselves, and platform users, who accept on behalf of connected parties you've onboarded (docs.xflowpay.com).
Stripe Connect draws the same line with connected accounts. If you're building a marketplace or a payout platform, you're in the second model, and it carries heavier onboarding and compliance obligations.
Check which model a provider supports as your first check.
What to Evaluate When You Choose One
Almost every criterion below can be settled from a provider's own public documentation in an afternoon, before a sales call. That's the point of building a cross-border payments API shortlist this way rather than by brand familiarity.
| Criterion | The question to put to the docs |
|---|---|
| Collection reach | Which currencies get real local account details, and which are wire-routed? |
| Payout reach | Is the send footprint the same as the collect footprint? |
| Settlement timing | What's the published time from funds received to funds in your account? |
| FX mechanic | Is the rate source and markup disclosed, and can you set your own? |
| India availability | Can an India-incorporated entity actually onboard today? |
| Developer experience | Is there a free sandbox, idempotency on POST calls, and signed webhooks? |
| Reconciliation | Are there purpose-built matching fields, or just transaction logs? |
Local Collection Versus Wire Routing
This is where headline currency counts mislead. A provider can hold a balance in a currency without being able to collect into it on local rails, and the two have different cost and speed profiles for your end users.
Wise Platform's documentation is unusually clear about this. Its multi-currency account holds balances in 50+ currencies, but local account details exist for only 10+ of those (docs.wise.com/guides/product/accounts). The rest are funded through international wire style routing.
That's not a knock on Wise. It's a documented fact worth checking against every provider on your list, including the one you end up picking.
Reach also splits by direction, and vendor headline numbers rarely make that obvious:
- Nium - its own site describes 190+ payout markets and 100+ real-time markets. We found no "35+ currencies" claim anywhere on nium.com, so treat any such figure with suspicion .
- Thunes - positions around wallet-first markets, reporting connections to 145 mobile wallet brands .
- Payoneer for Platforms - positioned around marketplace and mass-seller payouts rather than as a general collect-and-pay stack .
Developer Experience You Can Verify Before Signing
Three mechanics tell you how seriously a provider takes production reliability.
- Sandbox depth - Rapyd publishes a free sandbox with its own keys, and its docs state that sandbox generates webhooks identically to production (docs.rapyd.net). Xflow's testmode simulates the full lifecycle without touching live rails (docs.xflowpay.com).
- Idempotency - Nium documents idempotency on all POST APIs through an
Idempotency-Keyheader, with a V4 UUID recommended (docs.nium.com). Without this, a retried payout request can move money twice. - Reconciliation primitives - Nium carries a client-supplied
externalIDthrough to payout webhooks. Xflow exposesamount_reconcilableandamount_reconciledfields, a reconciliation-preview endpoint with a settlement ETA, andlinked_paymentstracing (docs.xflowpay.com).
If a provider's docs don't cover idempotency, assume you'll be building the deduplication layer yourself.
Who Controls the End-Customer Rate
For a platform, this decides your commercial model rather than your architecture.
Stripe Connect publishes two mechanics. Either Stripe sets and collects the processing rate and qualifying platforms earn a revenue share from Stripe, or the platform sets its own rate for connected accounts.
Under the second, the platform pays Stripe ₹150 per monthly active connected account and 0.25% + ₹20 per payout sent (stripe.com/in/connect/pricing). Xflow for Platforms takes that second shape by default, with transaction fees and FX markup set independently per connected user (xflowpay.com/solutions/platforms).
One India-specific access note worth checking early. Stripe moved to invite-only for new India merchants and platforms in May 2024, and general availability has not visibly resumed . That's an availability question, not a product judgement.
Compare Xflow's platform APIs against your current provider's docs
Integration: What the Build Involves and How Long It Takes
Search volume exists for "typical integration timeline cross-border payments api" and almost nobody answers it straight. Here's the honest position. No provider checked in this research publishes an accountable integration SLA.
Xflow's own solutions page states "typical integration takes less than 2 weeks", and that is Xflow's marketing claim rather than an industry norm or a technical-docs commitment (xflowpay.com/solutions/platforms).
So plan a build by stage, rather than by a number somebody quoted you.
| Stage | What it involves | What gates it |
|---|---|---|
| Sandbox access | Simulate the full lifecycle on test keys | Usually self-serve, sometimes a sales call |
| Authentication | Bearer-token keys, plus a header to scope calls per user | Nothing; a day's work |
| Webhooks and idempotency | Signature verification, retry and duplicate handling | Your own queue and state design |
| Reconciliation | Wiring balance and matching fields into your ledger | Your existing accounting model |
| Compliance and onboarding | Submitting your KYC, then each connected user's | Document readiness on your side |
| Go-live | Account status transitions to activated | Verification outcomes, not a certification exam |
The Stages Your Team Controls
Authentication is the smallest piece. Xflow's guide uses an Authorization: Bearer sk_your_key pattern plus an Xflow-Account header to scope a call to a specific connected user, with separate test and live keys (docs.xflowpay.com).
Webhooks are where real engineering time goes. You need signature verification, timestamp validation, retry logic and duplicate-event handling, because settlement events arrive asynchronously and sometimes twice.
Reconciliation is the third workstream. It's much cheaper if the provider gives you matching primitives instead of leaving you to diff transaction lists.
The Compliance Gate, Which Usually Sets the Date
In practice the paperwork sets your launch date, not the code. Xflow publishes a one business day verification SLA on account activation, and receivable activation can complete in about two hours where purpose codes are pre-approved (docs.xflowpay.com).
The part that stretches is platform-user onboarding. Every connected user's KYC information has to be submitted and verified before that user can transact live.
If you're launching with two hundred sellers, that's two hundred document sets, and their responsiveness isn't something your sprint plan controls. Start collecting those documents in parallel with the build, not after it.
The Revenue Models: How Platforms Earn on the Flow
A cross-border payments API only pays for itself once you've decided how to price it. Five mechanics cover almost every platform in this space, and mature platforms usually run two at once.
| Model | How it works | Fits best when |
|---|---|---|
| Per-transaction fee | Flat or percentage charge on each payment | Volume is predictable and payment sizes are similar |
| FX markup | A spread over your cost rate on the conversion leg | Conversion is unavoidable in the flow |
| Revenue share | The provider collects and shares back with you | You want no pricing responsibility |
| Subscription tier | Payments bundled into a paid software plan | Payments is a feature of a bigger product |
| Hybrid | A base fee plus usage or markup | Usage varies widely across your customer base |
Airwallex publishes a concrete FX-markup illustration on its own blog. A 0.2% fee charged to a merchant converting $30,000 to euros produces $60 of platform revenue.
The same post describes platforms issuing branded cards keeping a portion of interchange, usually between 1% and 1.5% (airwallex.com blog, vendor-published). Xflow for Platforms publishes no fixed percentage, by design, because the platform sets its own fee constructs per connected user.
Worked Arithmetic on Published Rates
Stripe Connect's platform-sets-its-own-rate model is the only mechanic here with fully published unit economics, so it's the one where the sums can be checked. Both rows assume an average payout of ₹50,000 and are illustrative, not a benchmark.
| Scenario | Cost calculation | Provider cost | Effective rate |
|---|---|---|---|
| 100 accounts, 100 payouts, ₹50,00,000 | (₹150×100) + ((0.25%+₹20)×100) | ₹29,500 | about 59 paise per ₹100 |
| 1,000 accounts, 4,000 payouts, ₹20,00,00,000 | (₹150×1,000) + ((0.25%+₹20)×4,000) | ₹7,30,000 | about 36 paise per ₹100 |
Rate components come from stripe.com/connect/pricing. The arithmetic and the average-payout assumption are ours.
Two things fall out of that. The per-account fee dilutes as average payout size rises, so your unit economics depend as much on payout size as on total volume.
And whatever you charge your end customer sits on top of that floor. Model the cost side before you publish a rate card. If you're collecting by card, note Stripe's underlying rates too: 2% for India-issued cards and 3% for cards issued outside India.
Model your own fee structure with per-user configuration
Platform Archetypes and What Each One Should Charge For
Flow shape determines which cross-border payments API model fits far more than company size does. Three archetypes cover most of this reader set.
| Archetype | Flow shape | Model that usually fits |
|---|---|---|
| Marketplace | Collect from buyer, split, pay many sellers | FX markup on conversion plus a per-payout fee |
| Vertical SaaS | Fewer, larger accounts; payments added to existing software | Revenue share or a take rate priced into the plan |
| Payroll or contractor payouts | One-directional, high-frequency outbound | Per-payout fee, or markup on the payout conversion |
A marketplace is the classic platform-user model. You're accepting on behalf of connected parties and paying out across many small recipients, so a per-payout fee compounds and the conversion leg is where the margin lives.
Vertical SaaS has the opposite shape. Fewer accounts, larger tickets, and an existing subscription you can fold payments into, which is what Stripe's platform-sets-its-own-rate mechanic is designed for.
Payroll and contractor platforms rarely collect cross-border at all. The flow is outbound, high-frequency and to individuals, so payout reach and per-payout cost dominate every other criterion. That's the case where a payout specialist can genuinely beat a full-stack provider.
The India Regulatory Layer: PA-CB
If any leg of your flow touches India, this decides your build-versus-buy answer more than any cross-border payments API feature will.
RBI brought non-bank entities facilitating cross-border collections under direct oversight with its Payment Aggregator - Cross Border (PA-CB) circular, issued on 31 October 2023 .
Before that, most such flows ran through the Online Payment Gateway Service Provider (OPGSP) route, which operated on bank tie-ups without direct RBI authorisation. No new OPGSPs may be set up, and the category is being phased out rather than abolished overnight.
How the Categories Are Defined Now
The original 2023 circular split authorisations by export, import, or both. RBI's consolidated Master Direction of 15 September 2025 appears to relabel these as PA-CB (inward) and PA-CB (outward).
Inward covers payments from overseas customers to Indian merchants. Outward covers payments from Indian customers to overseas merchants .
Both framings describe the same underlying scope. Providers, including Xflow, still commonly state their own status in the export and import language of the original circular.
Net Worth, Accounts and Limits
- Net worth - ₹15 crore at authorisation, rising to ₹25 crore. The rule is framed per entity, as the end of the third financial year from an entity's own authorisation date. Secondary trackers also cite a fixed legacy deadline, but they disagree on the date .
- Collection accounts - the consolidated Master Direction requires Inward Collection Accounts and Outward Collection Accounts, held only with AD Category-I banks, keeping customer funds ring-fenced from the provider's own.
- Per-transaction limits - per-transaction limits apply on cross-border transactions, on both the inward and the outward leg. Confirm the current figure with your provider and your counsel before you size a payout product around it .
The Master Direction also tightens due diligence. Per the same secondary summary, payment aggregators can't rely solely on third-party introductions or lightweight checks, and must hold their own KYC documentation and demonstrate a risk-based assessment.
Does Your Platform Need Its Own Authorisation?
This is the question that decides build versus buy, and it's the one nobody should be answering confidently. Two research passes couldn't settle it from RBI's primary text.
What's clear is where the documented burden sits. The licensed entity holding the authorisation and the collection accounts carries the KYC, risk-assessment and fund-custody responsibility.
That's consistent with platforms integrating as connected parties on a licensed provider's rails, but it's how the framework is generally structured rather than a statement RBI has made about platforms specifically .
Two practical steps follow. Ask any provider to show you their authorisation status in writing, final rather than in-principle. Then get your own counsel to sign off on your specific flow before launch. Xflow's PACB guidelines by RBI OPGSP update 2024 explainer is a starting point, not a legal opinion.
Check whether your flow needs its own PA-CB authorisation
Xflow for Platforms
Xflow builds for the platform-user model directly, so it's worth stating plainly what that includes and what it doesn't.
Everything runs over APIs with no redirection of your users outside your product, and the developer docs cover accounts, deposits, balances, events and webhooks. A no-code dashboard handles operations for teams who don't want to build the admin layer, and co-branded options exist where you want the provider visible.
On the commercial side, fee constructs are configurable independently per connected user, so you can price volume drivers and margin makers differently inside the same platform. Updates on your users arrive over webhooks, which keeps end-user communication yours.
The operating facts:
- 140+ countries and 25+ currencies for receiving.
- Settlement into an Indian bank account in one business day.
- The live mid-market rate rather than a marked-up board rate.
- ISO 27001 and SOC 2 certification.
- Final RBI PA-CB authorisation covering both exports and imports as of February 2026.
- 7,000+ businesses across Xflow's platform customers, against 20,000+ customers company-wide.
Where Xflow is a poor fit is worth saying too. If your flow is outbound payroll to a hundred countries with no India leg, a payout specialist will map to your problem better.
If you need card issuing or wallet-first coverage in emerging markets, look at providers built around those rails. Xflow's depth is India's inbound and outbound corridor and the compliance sitting on it.
Pricing for platform arrangements is set per deal rather than off the published Xflow pricing plans. The global payment aggregators page covers the collections-from-India direction if that's your flow.
If you're weighing a multi-currency account approach against a full API integration, the deciding factor is usually whether you need to onboard third parties or only yourself.
Providers commonly shortlisted for a cross-border payments API include Stripe Connect, Wise Platform, Airwallex, Rapyd, Thunes, Nium, Payoneer for Platforms and Xflow. There's no single answer, because collection reach, payout reach and India availability differ sharply.
No provider publishes an accountable integration SLA. Xflow's own marketing page claims under two weeks, which is its claim rather than an industry standard. The real variable is KYC and compliance onboarding for you and your connected users, not the API work.
Through per-transaction fees, an FX markup on the conversion leg, a revenue share from the provider, a subscription tier that bundles payments, or a hybrid. Stripe Connect publishes both a revenue-share model and a platform-sets-its-own-rate model with full India unit economics.
Unresolved. RBI's framework places KYC, risk-assessment and fund-custody responsibility on the entity holding the authorisation and the collection accounts, which is consistent with platforms operating on a licensed provider's rails. Confirm your flow with legal counsel .
Local collection means the payer sends a domestic transfer in their own market, which is generally faster and cheaper for them. Wire routing goes through correspondent banking instead. Wise Platform's docs show local account details on only 10+ of its 50+ currency balances.
Usually, yes. Rapyd publishes a free sandbox with its own keys where webhooks behave as they do in production. Xflow's testmode simulates deposits and accelerated payout settlement across the full lifecycle. Sandbox depth is a fair proxy for documentation quality.
