Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.yativo.com/llms.txt

Use this file to discover all available pages before exploring further.

Purchase a gift card product. The face value is debited from your USD wallet. 
POST https://api.yativo.com/api/v1/giftcards
Requires Idempotency-Key header. Gift card purchases are non-refundable.
​
product_id
number
required
The gift card product ID from GET /giftcards.
​
amount
number
required
Face value in the product’s native currency. Must be within min_amount/max_amount or match a fixed_amounts value.
​
quantity
number
Number of cards to purchase (default: 1).
​
recipient_email
string
Email to deliver the gift card code to. If omitted, code is returned in the API response only.
curl -X POST 'https://api.yativo.com/api/v1/giftcards' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: gc-amazon-001' \
  -d '{
    "product_id": 1,
    "amount": 50,
    "quantity": 1,
    "recipient_email": "customer@example.com"
  }'

{
  "status": "success",
  "status_code": 200,
  "message": "Giftcard request submitted successfully",
  "data": {
    "transaction_id": "gc-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "product_name": "Amazon US",
    "amount": 50,
    "currency": "USD",
    "status": "completed",
    "created_at": "2026-06-01T10:00:00.000000Z"
  }
}