GiftyZel

Plugin Documentation

Add address-free gifting to any store in 2 lines of code

What is the GiftyZel Plugin?

The GiftyZel plugin lets your customers gift your products and services to anyone using just a phone number or email. No shipping address is needed upfront — recipients privately enter their own address later.

One-click gift checkout on your website

Address-free — recipients confirm privately

Works with any website or platform

Stripe-powered payments with instant payouts

Booking flow for service businesses

Full API access for custom integrations

Quick Start — 2 Lines of Code

Paste this before the closing </head> tag on your website:

<script src="https://www.giftyzel.com/plugin.js"
  data-store-id="YOUR_STORE_ID"
  data-api-key="YOUR_API_KEY" defer></script>

Replace YOUR_STORE_ID and YOUR_API_KEY with values from your Merchant Dashboard.

Gift Button Attributes

Add gift buttons to your services or products:

<button class="giftyzel-gift-btn"
  data-service-name="Deep Tissue Massage"
  data-service-price="120"
  data-service-type="booking"
  data-booking-url="https://yoursite.com/book">
  🎁 Gift This
</button>

Attribute	Required	Description
`class`	required	Must be "giftyzel-gift-btn" to activate the plugin
`data-service-name`	required	Name of the service or product displayed in the modal
`data-service-price`	required	Price in dollars (e.g. "120" or "49.99")
`data-service-type`	optional	Type: "booking" for services, "product" for physical items
`data-booking-url`	optional	URL where the recipient can schedule/book the service

Platform Installation Guides

WordPress

Go to Appearance → Theme Editor → header.php → paste the script before </head>

Wix

Go to Settings → Custom Code → Add Code → select "Head" placement

Squarespace

Go to Settings → Advanced → Code Injection → paste in Header field

Shopify

Go to Online Store → Themes → Edit Code → theme.liquid → paste before </head>

WooCommerce

Go to Appearance → Theme Editor → header.php → paste before </head> (same as WordPress)

Custom Website

Paste the script tag directly into your HTML before the closing </head> tag

FAQ

Is my API key public?

The key in data-api-key is visible in your page source, but it's scoped to your store only. Keep your secret key (if issued) private.

What does it cost?

3.5% per transaction for the plugin. No monthly fees, no setup costs.

Which platforms work?

Any website — Shopify, WooCommerce, WordPress, Wix, Squarespace, custom builds, and more.

Do I need PCI compliance?

No. Stripe handles all payment data. You never touch card numbers.

How does address privacy work?

The recipient enters their own address privately. You receive it for shipping. The gift sender never sees it.

How do I test?

Use a gfty_test_ prefixed key and Stripe test card 4242 4242 4242 4242.

Need Help?

Email us at hello@giftyzel.com and we'll get you set up.

Full API Reference

Detailed endpoint documentation, authentication, webhooks, and rate limits.

Ready to get started?

Apply for your API key and be live within 48 hours.

Apply Now

Questions? hello@giftyzel.com