Skip to main content

​
How Vonos fits in

Vonos acts as a settlement provider on the OpenCharge Network. When two gateways settle through Vonos, each side has a clear set of responsibilities. Your gateway implements (OpenCharge spec — you host these):
EndpointMethodWhat it does
/payment/createPOSTAccept payment requests from partner gateways
/payment/settlePOSTComplete payments with a valid settlement proof
/transfer/webhookPOSTReceive signed proofs from Vonos when a transfer completes
Full implementation details live in the OpenCharge Merchant Gateway docs. Vonos provides (you call these):
EndpointMethodWhat it does
/transfer/createPOSTInitiate a USDT settlement to a recipient gateway
/verify/{txid}GETConfirm a transaction was settled and retrieve the signed proof

​
Authentication

All requests to and from Vonos use the standard OpenCharge request authentication scheme.
HeaderDescription
X-OC-IDYour OCID
X-OC-TimestampUnix timestamp of the request
X-OC-NonceUnique nonce for the request
X-OC-Signaturesecp256k1 signature over the canonical request
The signature covers: your OCID, the timestamp, the nonce, the HTTP method, the request path, and the SHA-256 hash of the request body. See the OpenCharge implementation guide for test vectors and a step-by-step signing walkthrough.