Skip to main content

​
Settlement flow

Vonos sits between two gateways and settles their transactions in USDT. Neither gateway needs a direct relationship with the other — Vonos bridges the gap.

​
A real example

A Venmo user wants to pay a mobile money (Momo) merchant in Uganda. Venmo and Momo are on different networks, different currencies, different continents. Here’s how Vonos makes it work:
  1. The Venmo user initiates a payment to the Momo merchant.
  2. Venmo calls Momo’s /payment/create endpoint, opening a pending payment and receiving a transaction ID (txid).
  3. Venmo calls Vonos’ /transfer/create to credit Momo’s OCID with USDT, using the txid as the reference.
  4. Vonos debits Venmo’s reserve, credits Momo’s reserve, and returns a signed transaction proof.
  5. Vonos notifies Momo via its /transfer/webhook with the same signed proof.
  6. Venmo calls Momo’s /payment/settle with the proof to complete the payment.
  7. Momo credits the merchant.
The whole chain settles instantly — no batching, no holdups.

​
Sending a payment

If you’re the sending gateway (Venmo in the example above):
1

Open a pending payment

Call the recipient gateway’s /payment/create. You get back a txid and their list of accepted settlement providers in settlement.accepts.
2

Confirm Vonos is accepted

Check that Vonos’ OCID is in the recipient’s accepts list. If it isn’t, the recipient needs to add it on their end.
3

Settle via Vonos

POST to Vonos’ /transfer/create with the recipient’s OCID and the txid as the to.reference field.
4

Receive the proof

Vonos returns a signed transaction proof attesting to the transfer.
5

Complete the payment

Call the recipient’s /payment/settle with the proof. The payment is done.

​
Receiving a payment

If you’re the receiving gateway (Momo in the example above):
1

Accept the payment request

Handle the incoming POST to your /payment/create. Return a txid and your accepts list (which should include Vonos’ OCID).
2

Wait for the proof

Vonos will POST a signed transfer proof to your /transfer/webhook once the settlement completes.
3

Verify and credit

Verify the proof signature and that the issuer is in your accepts list. If valid, credit the recipient. You can also accept the proof via your /payment/settle endpoint.
Vonos expects instant settlement. Gateways that fail to settle immediately will be suspended.

​
Cash Agent network

For gateways that need on-the-ground liquidity, Vonos is building a Cash Agent and OTC app. A single agent with one USDT reserve account can handle cash deposits and withdrawals for any gateway on the network — removing the need for each gateway to independently source and manage agents around the world.