Z$ Tokens

# Adding points also triggers Z$ distribution automatically
curl -X POST "https://api.zupy.com/api/v2/customers/2awTHloSJX7kGGprFerOOsvABcd/points/add/" \
  -H "X-API-Key: zupy_pk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50, "reason": "Order #12345"}'

import requests

BASE_URL = "https://api.zupy.com/api/v2"
HEADERS = {"X-API-Key": "zupy_pk_your_api_key_here"}

# Adding points — Z$ bonus is distributed automatically
response = requests.post(
    f"{BASE_URL}/customers/2awTHloSJX7kGGprFerOOsvABcd/points/add/",
    json={"amount": 50, "reason": "Order #12345"},
    headers=HEADERS,
)
result = response.json()["data"]
print(f"Points added: {result['amount']}")
# Z$ distribution happens asynchronously in the background

const BASE_URL = "https://api.zupy.com/api/v2";
const API_KEY = "zupy_pk_your_api_key_here";

// Adding points — Z$ bonus is distributed automatically
const response = await fetch(
  `${BASE_URL}/customers/2awTHloSJX7kGGprFerOOsvABcd/points/add/`,
  {
    method: "POST",
    headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ amount: 50, reason: "Order #12345" }),
  }
);
const { data: result } = await response.json();
console.log(`Points added: ${result.amount}`);
// Z$ distribution happens asynchronously in the background

curl -X GET "https://api.zupy.com/api/v2/customers/2awTHloSJX7kGGprFerOOsvABcd/z-balance/" \
  -H "X-API-Key: zupy_pk_your_api_key_here"

customer_id = "2awTHloSJX7kGGprFerOOsvABcd"

response = requests.get(
    f"{BASE_URL}/customers/{customer_id}/z-balance/",
    headers=HEADERS,
)
balance = response.json()["data"]

if balance["has_wallet"]:
    print(f"Z$ Balance: {balance['z_balance']}")
    print(f"Wallet: {balance['wallet_address']}")
else:
    print("Customer has no Z$ wallet yet")

if balance.get("error"):
    print(f"Warning: {balance['error']}")

const customerId = "2awTHloSJX7kGGprFerOOsvABcd";

const response = await fetch(
  `${BASE_URL}/customers/${customerId}/z-balance/`,
  { headers: { "X-API-Key": API_KEY } }
);
const { data: balance } = await response.json();

if (balance.has_wallet) {
  console.log(`Z$ Balance: ${balance.z_balance}`);
  console.log(`Wallet: ${balance.wallet_address}`);
} else {
  console.log("Customer has no Z$ wallet yet");
}

if (balance.error) {
  console.warn(`Warning: ${balance.error}`);
}

curl -X POST "https://api.zupy.com/api/v2/customers/2awTHloSJX7kGGprFerOOsvABcd/rewards/2bxRKmpWJY8lHHqsGfsQQtwCDef/redeem/" \
  -H "X-API-Key: zupy_pk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"use_z_tokens": true}'

customer_id = "2awTHloSJX7kGGprFerOOsvABcd"
reward_id = "2bxRKmpWJY8lHHqsGfsQQtwCDef"

response = requests.post(
    f"{BASE_URL}/customers/{customer_id}/rewards/{reward_id}/redeem/",
    json={"use_z_tokens": True},
    headers=HEADERS,
)
coupon = response.json()["data"]
print(f"Coupon: {coupon['coupon_code']}")
print(f"Points used: {coupon['points_used']}")
print(f"Z$ used: {coupon['z_tokens_used']}")
print(f"Remaining Z$: {coupon['new_z_balance']}")

const customerId = "2awTHloSJX7kGGprFerOOsvABcd";
const rewardId = "2bxRKmpWJY8lHHqsGfsQQtwCDef";

const response = await fetch(
  `${BASE_URL}/customers/${customerId}/rewards/${rewardId}/redeem/`,
  {
    method: "POST",
    headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ use_z_tokens: true }),
  }
);
const { data: coupon } = await response.json();
console.log(`Coupon: ${coupon.coupon_code}`);
console.log(`Points used: ${coupon.points_used}`);
console.log(`Z$ used: ${coupon.z_tokens_used}`);
console.log(`Remaining Z$: ${coupon.new_z_balance}`);