Force requery

X-API-Key

POST/transactions/{id}/requery

Ask VendPower to refresh status from the upstream provider. Useful for airtime and cable orders stuck in pending / processing.

Language

curl -X POST "https://api.vendpower.ng/api/v1/transactions/88001/requery" \
  -H "X-API-Key: YOUR_X_API_KEY" \
  -H "Accept: application/json"

Authentication

Send your approved API key on every request. Keep it on your server only.

Header	Value	Required
X-API-Key	YOUR_X_API_KEY	Yes
Content-Type	application/json	Yes
Accept	application/json	Recommended

Authentication failures (401 / 403 / 429) are listed in Authentication.

Parameters

Path parameters

Name	Type	Required	Description
id	string	Yes	Numeric transaction id (preferred) or reference

Responses

200 OK — Refreshed

{
  "success": true,
  "message": "Transaction requery completed.",
  "data": {
    "id": 88001,
    "reference": "VP_AIRTIME_001",
    "idempotency_key": "VP_AIRTIME_001",
    "status": "success",
    "category": "airtime",
    "amount": 1000,
    "charge": 1000
  }
}

Notes

Prefer numeric id for requery. Combine with polling guidance on the Requery polling page.