Verify Order - PayVessel

Verify the status of a gift card order using your merchant reference. If the order is not yet final, PayVessel checks the provider for the latest status before responding.

Usage

curl https://api.payvessel.com/vaas/api/v1/gift-cards/orders/verify/{reference} \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_SECRET_KEY"

Path parameters

Parameter	Type	Required	Description
`reference`	string	Yes	Your unique merchant order reference

Response fields

Field	Type	Description
`id`	string (uuid)	PayVessel order ID
`business_id`	string	Your business ID
`merchant_reference`	string	Your merchant reference
`order_reference`	string	PayVessel’s internal order reference
`operator_id`	string	Operator ID
`product_id`	string	Product ID
`product_name`	string	Gift card name
`country`	string	Country
`amount_naira`	number	Amount in NGN
`amount_usd`	number	Amount in USD
`redeem_code`	string or null	Gift card redemption code
`serial_number`	string or null	Gift card serial number
`status`	string	`pending`, `processing`, `completed`, or `cancelled`
`error_message`	string or null	Error details if the order failed
`wallet_transaction_id`	string or null	Associated wallet transaction
`created_datetime`	datetime	When the order was created
`updated_datetime`	datetime	Last status update
`completed_datetime`	datetime or null	When the order was fulfilled

API Reference

Full request/response details and Try it