Piggyvest Business

Introduction

API Doc

Webhooks

Pay With Pocket

DocsTransaction Status Query
Ctrl K

Transaction Status Query (TSQ)

GET/api/v1/transaction/verify?reference={reference}

Check the status of a specific transaction. This uses the integrations transaction route (singular transaction), not the plural transactions list routes.

Query Parameters

NameTypeRequiredDescription
referencestringYesTransaction reference to verify.
wallet_idstringNoNarrows the lookup to a specific wallet.
1
Request Example
(cURL)
curl -X GET "https://api.piggyvest.business/api/v1/transaction/verify?reference=PVB1234567890" \\
-H "Authorization: Bearer YOUR_SECRET_KEY"
2
Success Response(200)
(JSON)
{
  "status": true,
  "message": "Transaction status retrieved",
  "data": {
    "reference": "PVB1234567890",
    "status": "success",
    "amount": 10000,
    "recipient": "0123456789",
    "bank": "GTBank",
    "created_at": "2024-03-25T12:00:00Z"
  }
}

Status values includes: "success", "pending", "failed"