List Products

Fetch all available products (denominations/values) for a given gift card operator. This returns the specific card values your users can purchase, along with USD and NGN pricing.

Usage

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

Path parameters

Parameter	Type	Required	Description
`operator_id`	string	Yes	The operator ID from List Operators

Response fields

The data object is a map of product IDs to product objects:

Field	Type	Description
`id`	string	Product ID (used as `product_id` when creating an order)
`name`	string	Display name (e.g. “$25 Amazon Gift Card”)
`price_type`	string or null	Pricing type (e.g. “FIXED”, “RANGE”)
`usd`	number or null	Price in USD
`ngn`	number or null	Price in NGN
`operator_id`	string or null	Parent operator ID
`country`	string or null	Country code
`image`	string or null	Card image URL

Next step

Use the product id as the product_id when purchasing a gift card.

API Reference

Full request/response details and Try it

List Operators Purchase

Getting started

Use cases

API Basics

Accept Payment

Transfers

Wallets

Virtual Accounts

Issuing

Identity Verification

Value Added Services

Webhook

Usage

Path parameters

Response fields

Next step

API Reference

​Usage

​Path parameters

​Response fields

​Next step

API Reference

Usage

Path parameters

Response fields

Next step