GET /verify/
Checks the status of a settlement transaction on Vonos and returns the signed proof once it has completed. Use this to confirm a payment went through after calling /transfer/create.
Request
No request body. Pass the txid as a URL parameter.
GET /verify/vonos_tx_abc123
| Parameter | Description |
|---|
txid | The Vonos transaction ID returned by /transfer/create |
Response
{
"txid": "vonos_tx_abc123",
"status": "completed",
"from": { "ocid": 200, "reference": "internal_ref_001" },
"to": { "ocid": 500, "reference": "gateway_txid_from_payment_create" },
"amount": "10.00",
"currency": "USDT",
"timestamp": 1706500500,
"proof": {
"txid": "vonos_tx_abc123",
"issuer": 100,
"from": { "ocid": 200, "reference": "internal_ref_001" },
"to": { "ocid": 500, "reference": "gateway_txid_from_payment_create" },
"amount": "10.00",
"currency": "USDT",
"timestamp": 1706500500
},
"signature": "a1b2c3d4..."
}
| Field | Description |
|---|
status | completed if settled, pending if still processing |
proof | The signed proof — only present when status is completed |
signature | Vonos’ signature over the proof |
Example
const response = await fetch(
`https://api.vonos.io/verify/${vonosTxid}`,
{
method: 'GET',
headers: createAuthHeaders(YOUR_OCID, YOUR_PRIVATE_KEY)
}
);
const { status, proof, signature } = await response.json();
if (status === 'completed') {
console.log('Settlement confirmed:', proof.txid);
}
You generally don’t need to poll this endpoint. Vonos notifies the recipient gateway via /transfer/webhook once settlement completes. Use /verify when you need on-demand confirmation — for example in a retry flow or a user-facing status check.
