Connect to Vonos
Step 1: Mint an OpenCharge ID
Every gateway on the network needs an OpenCharge ID (OCID). Mint one using the UI at opencharge.cloud, or directly on the Router Registry contract on Base. opencharge.cloud includes a metadata editor that helps you create and sign the NFT metadata in one place.Step 2: Sign and host your metadata
Your metadata must be live at the URL you registered during minting. It tells the network your public key, endpoint, and capabilities. Sign the config with your network private key — see the OpenCharge signing guide.Step 3: Implement the required endpoints
Before connecting to Vonos, your gateway needs three OpenCharge endpoints running:| Endpoint | Method | Purpose |
|---|---|---|
/payment/create | POST | Accept payment requests from partner gateways |
/payment/settle | POST | Complete payments once a settlement proof is received |
/transfer/webhook | POST | Receive signed transfer proofs from Vonos |
Step 4: Create a Vonos account
- Go to vonos.io and create an account.
- Provide your OCID.
- Connect Metamask. Import the private key associated with your OCID as an account in Metamask, switch to that account, then click Verify Signature on the Vonos dashboard.
Step 5: Top up your reserve
Fund your Vonos reserve balance. This is the USDT pool Vonos draws from when you initiate outbound settlements.Step 6: Add recipient gateways
Under Settings, add the OCIDs of the gateways you want to settle with. Both you and the recipient must have active Vonos accounts.Make sure Vonos’ OCID is in the recipient gateway’s
accepts list in their order config. The recipient won’t accept a settlement proof from an issuer that isn’t on their list.Next steps
How Settlement Works
Walk through a full payment flow end to end.
Create Transfer
The main endpoint you call to settle payments via Vonos.