SL Gift Cards & Store Credits

ཞིབ་བརྗོད།

Complete WordPress/WooCommerce plugin for gift cards, store credits, and coupon management integrated with Streamline POS.

Features

🎁 Gift Cards

• Auto-generated card numbers (GC-XXXX-XXXX-XXXX)
• E-gift cards with automatic email delivery
• Physical gift cards for in-store printing
• Balance tracking and transaction history
• Expiration date support
• Beautiful branded HTML emails
• Customer account integration – Link gift cards to accounts
• Combine cards – Merge multiple gift cards into one
• Edit functionality – Modify balance, status, notes from admin
• Import/Export – Bulk operations via CSV

💰 Store Credits

• Customer balance tracking
• Add/deduct credits easily
• Refund to store credit
• Full transaction history
• Order associations
• Import/Export – Bulk credit operations

🎟️ Coupons

• Uses WooCommerce coupons
• Integrated into POS Extensions tab

📦 Import/Export

• Export all gift cards to CSV
• Export all store credits to CSV
• Import gift cards from CSV (with template)
• Import store credits from CSV (with template)
• Download pre-formatted templates
• Validation and error reporting

👤 Customer Features

• View all gift cards in “My Account”
• Link received gift cards to account
• Combine multiple cards into one
• Check balances and transaction history
• Remove applied gift cards from cart

🔌 POS Integration

• Extensions tab with sub-tabs
• Store credit display in customer profile
• Gift card payment at checkout
• Permission management

Requirements

• WordPress 5.0+
• WooCommerce 5.0+
• PHP 7.4+

Database Tables

Created automatically on activation:
– wp_streamline_gift_cards – Gift card data
– wp_streamline_gift_card_transactions – Transaction history
– wp_streamline_store_credits – Store credit transactions

REST API Endpoints

Gift Cards

• POST /wp-json/sl-gcsc/v1/gift-cards/validate
• POST /wp-json/sl-gcsc/v1/gift-cards/create
• POST /wp-json/sl-gcsc/v1/gift-cards/apply
• GET /wp-json/sl-gcsc/v1/gift-cards/balance/:number

Store Credits

• GET /wp-json/sl-gcsc/v1/store-credit/balance/:customer_id
• GET /wp-json/sl-gcsc/v1/store-credit/history/:customer_id
• POST /wp-json/sl-gcsc/v1/store-credit/add
• POST /wp-json/sl-gcsc/v1/store-credit/apply

Usage

Admin Menu Pages

Navigate to Gift Cards & Credits in WordPress admin:

1. Dashboard – Overview of gift cards and store credits
2. Gift Cards – View all gift cards
   • Edit – Modify balance, status, notes, recipient
   • Combine – Transfer balance between cards
3. Create Physical Card – Generate new physical gift cards
4. Store Credits – View all customer store credits
5. Add Store Credit – Add credits to customer accounts
6. Reports – View gift card and store credit analytics
7. Settings – Configure email templates and URLs
8. Import/Export – Bulk operations
   • Export gift cards to CSV
   • Export store credits to CSV
   • Import from CSV with templates

Customer Account Pages

Customers can access at My Account → My Gift Cards:

• View all their gift cards
• Check balances and transaction history
• Link a gift card – Add received cards to account
• Combine – Merge multiple cards into one
• Remove applied gift cards from cart

Cart & Checkout

• Apply gift cards on cart page
• Apply gift cards on checkout page
• Remove applied gift cards with one click
• $0 total notice when fully covered
• Session-based persistence

Create Physical Gift Card

`php

$gift_card_id = SGCSC_Gift_Card::create([
‘initial_balance’ => 100.00,
‘is_physical’ => true
]);
`

Add Store Credit

`php

SGCSC_Store_Credit::add($customer_id, 25.00, [
‘reason’ => ‘Compensation’,
‘notes’ => ‘Issue #1234’
]);
`

Validate Gift Card

`php

$result = SGCSC_Gift_Card::validate(‘GC-XXXX-XXXX-XXXX’);
`

Creating E-Gift Card Products

1. Products → Add New
2. Product Type: Gift Card
3. Set price
4. Publish

Customers can purchase and recipient receives email automatically!

Support

Check the included guides:
– COMPLETE-SETUP-GUIDE.md – Full setup instructions
– POS-INTEGRATION-CODE.js – POS integration code
– COMPLETE-INTEGRATION-GUIDE.md – Detailed integration

Version

1.0.4

Author

Streamline Diving — streamlinediving.com/plugins