Skip to main content
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.
​
productId
integer
required
The gift card product ID (from GET /giftcards).
​
unitPrice
number
required
Price per unit in the product’s native currency (minimum 0.01).
​
quantity
integer
required
Number of cards to purchase (minimum 1).
​
senderName
string
required
Name of the sender. Maximum 100 characters.
​
recipientEmail
string
required
Email address of the gift card recipient.
​
customer_id
string
Optional. Link this purchase to a customer in your account.
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 '{
    "productId": 1234,
    "unitPrice": 10.00,
    "quantity": 1,
    "senderName": "John Doe",
    "recipientEmail": "recipient@example.com",
    "customer_id": "cust_abc123"
  }'

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

{
  "status": "error",
  "status_code": 402,
  "message": "Insufficient wallet balance"
}