Get Order

Retrieve a gift card order by its PayVessel order ID. Use this to poll for the final status and retrieve the redemption code.

Usage

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

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

Full request/response details and Try it