Cross-border payments · Roadmap

Cross-border payments from South Africa are on our roadmap.

No cross-border rail is built yet. Available today: daily SARB exchange-rate snapshots, with the source and observation date on every rate. Talk to us if cross-border payouts matter to you.

Get API keys Contact sales

Why cross-border on FinVeil

What exists, and what doesn't.

Cross-border payouts (roadmap)

No cross-border rail is built today, and FinVeil does not settle payouts on any rail yet. Cross-border payouts are on the roadmap.

Daily SARB FX snapshot

Exchange rates ingested daily from the South African Reserve Bank, returned with the observation date and source. A daily snapshot, not a real-time or dealable rate.

Proof receipts

Each settled transaction gets a SHA-256 proof receipt stored by FinVeil. There is no Balance of Payments reporting feature.

Convert at the SARB rate

Convert an amount between SARB-quoted currencies. The response carries the rate and its observation date, and unquoted pairs are refused rather than invented.

How it works

Rates → Convert → (roadmap) Pay out.

01
Rates
GET /api/rates/fx returns the latest SARB exchange rates with source and observation date. Available today.
02
Convert
GET /api/rates/fx/convert converts an amount at the latest SARB rate. Available today.
03
Pay out
Roadmap. No cross-border payout rail is built.
04
Record
Roadmap. Receipts for cross-border payouts will follow the payout rail.

SARB rates, today

Convert ZAR at the SARB rate.

Read the latest SARB rates, or convert an amount. Each answer carries the rate used and the date SARB observed it.

Read the docs

cross-border.bashbash

# Latest SARB exchange rates, with source and observation date
curl https://api.finveil.money/api/rates/fx

# Convert R1,500.00 to USD at the latest SARB rate
curl "https://api.finveil.money/api/rates/fx/convert?amountCents=150000&from=ZAR&to=USD"

# Cross-border payouts: roadmap, no endpoint yet.

Splits (South Africa)

FinVeil Connect for split payments.

Take one ZAR card payment and split it between partners through Paystack subaccounts, each share settled at source. Verified end to end in Paystack test mode. Cross-border splits are not supported.

Explore FinVeil Connect

Want cross-border on the roadmap sooner?

Get API keys Contact sales