Plugin Documentation

Integrate and configure Preciousuite WordPress & API plugins in minutes. Real-time metal calculations, professional formatting, and fully responsive layouts.

Gold Price Based on Weight

Calculate real-time gold values based on current live market metal rates, karat purity options, and item weight (grams, ounces, pennyweights). Perfect for gold buyers, scrap sellers, pawn shops, and jewelry retailers looking to embed a live price estimation tool.

Key Features

  • Live Market Rate Integration
  • Support for multiple Karats (9K to 24K)
  • Custom styling & theme options
  • Responsive widget rendering

Quick Start Integration

To display this calculator widget on your site, add the following HTML block and script reference:

HTML Widget Setup
<!-- Embed Gold Price Calculator Widget -->
        <div class="preciousuite-gold-calculator" 
             data-apikey="YOUR_API_KEY" 
             data-karat="18" 
             data-currency="USD">
        </div>
        <script src="https://cdn.preciousuite.com/js/widgets.js" async></script>

Widget Parameters

Customize the widget's default behavior by passing attributes to the target div container:

Attribute Type Default Value Description
data-apikey String Required Your Preciousuite API License Key.
data-karat Integer 24 Default karat purity selection (options: 9, 10, 14, 18, 22, 24).
data-currency String USD Active currency calculation (e.g. USD, EUR, INR, GBP).

Preciousuite Gold Buyback Quote Calculator

Provide your customers with instant quotes for buying back gold scrap, coins, or old jewelry. It integrates live market feeds and allows store owners to set their margin percentages or flat discount rates.

Key Features

  • Instant PDF quote generation
  • Custom admin margins configuration
  • Customer email capture for leads
  • Automatic scrap valuation

Quick Start Integration

To display this buyback widget on your store or website, insert this code snippet:

HTML Widget Setup
<!-- Embed Gold Buyback Widget -->
        <div class="preciousuite-buyback" 
             data-apikey="YOUR_API_KEY" 
             data-margin="-12" 
             data-email-required="true">
        </div>
        <script src="https://cdn.preciousuite.com/js/widgets.js" async></script>

Widget Parameters

Attribute Type Default Value Description
data-apikey String Required Your Preciousuite API License Key.
data-margin Number -10 Percentage margin below spot price (e.g. -12 for buying back at 88% of spot).
data-email-required Boolean true Requires user email validation to generate and email quotes.

Jewelry Invoice & Certificate Generator

Automate the generation of GST/VAT tax invoices and jewelry certificates of authenticity. The plugin automatically fetches live gold, silver, and platinum rates, itemizes stones, making charges, and tax compliance details.

Your Setup Progress
1
Check Req.
2
Install Plugin
3
Settings
4
Add Fields
5
Orders
6
Download
Requirements
Before installing, confirm your store meets these requirements.
⚠️
WooCommerce must be active first
The plugin will not activate without WooCommerce. Install and activate WooCommerce before continuing with this guide.
RequirementNotesMinimum
WordPressSelf-hosted (wordpress.org) only5.8+
WooCommerce RequiredMust be installed and active before this plugin6.0+
PHPCheck via Tools → Site Health in WordPress7.4+
PDF libraryBuilt into the plugin — no separate installation neededIncluded
1
Install the Plugin
Install directly from WordPress — no file download needed.
1
Go to Plugins → Add New Plugin
Log in to your WordPress admin and click Plugins in the left sidebar, then Add New Plugin.
2
Search and Install
In the search box type Jewelry Invoice Certificate Generator — find the plugin by Preciousuite and click Install Now.
3
Click Activate Plugin
Activate the plugin to enable settings screens.
After activation a new Jewelry Invoice sub-menu appears under WooCommerce in your sidebar. This is where all plugin settings live.
2
Configure the Plugin
Set your store details, tax type, and certificate settings. This is a one-time setup — documents will use these details on every order from now on.
1
Open Jewelry Invoice settings
Access settings via the WooCommerce navigation path.
WordPress Admin WooCommerce Jewelry Invoice
2
Fill in Store & Certificate Settings
This is exactly what the settings page looks like — fill in all fields for your store.
🔔 0 Howdy, admin
Jewelry Invoice & Certificate Settings
Store Details
Store / Jeweler Name*Appears on invoice header and certificate
This name will appear on all generated documents
Store AddressPrinted on invoice footer
Store LogoDisplayed top-left on all documents
🏅
PNG or JPG, max 2MB
Tax & Compliance Settings
Tax Type*Select your country's tax system
GSTIN*Your GST Identification Number
Printed on every invoice. Required for GST-compliant documents.
HSN CodeHarmonised System of Nomenclature code for jewelry
Standard HSN for articles of jewelry: 7113. For gold coins: 7118.
Certificate Settings
Certificate TitleHeading on purchase certificate
Certificate SubtitleSub-heading below title
Auto-generate on orderWhen to create documents
WooCommerce → Jewelry Invoice settings page — fill in your store details, tax type, and certificate heading
FieldDescriptionExample
Store / Jeweler Name*Printed on invoice header and certificate topRaj Jewellers
Store AddressAppears on invoice footer123 Gold Market, Surat, Gujarat
Store LogoUpload PNG or JPG — appears top-left on all documentsYour logo file
Tax Type*GST (India) / VAT (EU/UK) / UAE VAT / No TaxGST (India)
GSTIN*Your GST registration number — required for India24AABCR1234A1Z5
HSN CodeProduct classification code for jewelry7113 (jewelry) / 7118 (coins)
Certificate TitleHeading shown on the purchase certificate documentJewelry Purchase Certificate
Auto-generate on orderWhen "Completed" — documents generate the moment you mark an order completeWhen order = Completed
3
Click Save Settings
Your store details are now saved. Every document generated from this point will use these settings.
3
Add Jewelry Fields to Your Products
Each product needs jewelry-specific data so the certificate includes the correct hallmark, purity, weight, and stone details. Add these on each WooCommerce product page.
1
Open a product in WooCommerce
Find the product you want to edit.
WordPress Admin Products All Products Edit [product name]
2
Find the Jewelry Certificate Details panel
Scroll down on the product edit page — below the standard WooCommerce product data tabs you will find a new panel added by the plugin.
+ New Howdy, admin
Edit Product — 22K Gold Bridal Necklace
↑ Standard WooCommerce product fields (price, stock, images) above this...
📄 Jewelry Certificate Details These fields appear on the purchase certificate and invoice
Metal Details
Gemstone Details (optional)
Products → Edit Product — the Jewelry Certificate Details panel appears below standard product fields
FieldDescriptionExample
Metal Details
Metal TypeGold / Silver / PlatinumGold
Purity / KaratKarat of the metal22K
Gross Weight (grams)Total weight including stones and setting19.80
Net Metal Weight (grams)Weight of metal only after subtracting stones18.50
Hallmark / BIS HUIDBIS hallmark number (India) or assay mark (UK/EU)BIS2024KL7829
Making ChargesLabour/making charge percentage or fixed amount12%
Gemstone Details (optional — only fill if the item has stones)
Stone TypeDiamond, Ruby, Emerald, Sapphire, etc.Diamond
Stone Weight (carats)Total carat weight of all stones in the piece0.42
ColourDiamond colour grade (for diamonds)F
ClarityDiamond clarity gradeVS1
Certificate No.GIA, IGI, AGS, or HRD certificate numberGIA 2195447895
CutDiamond cut gradeExcellent
💡 Gemstone fields are completely optional. If your product has no stones, leave those fields blank — they simply won't appear on the certificate.
3
Click Update Product
Save the product. These jewelry details will now appear on every invoice and certificate generated for orders containing this product.
ℹ️
Do this for every jewelry product
Repeat Step 3 for each product in your store. Products without jewelry fields will still get a standard invoice — they just won't have the jewelry certificate panel with hallmark, purity and stone details.
4
How It Works When a Customer Orders
Once the plugin is configured and your products have jewelry fields, the entire process is fully automatic. Here is exactly what happens from order to document.
1
Customer places an order on your store
Customer browses, adds jewelry to cart, and checks out via WooCommerce as normal. No change to the shopping experience.
2
You mark the order as Completed
When you process and ship the order, change the order status to Completed in WooCommerce. This automatically triggers the PDF engine.
Orders
Orders
OrderDateStatusTotalActions
#WC-4821 13 June 2026 Completed ₹1,72,750
#WC-4820 12 June 2026 Completed ₹73,200
WooCommerce → Orders — Download Invoice and Download Certificate buttons appear on every Completed order
5
Download Documents
Documents are available in two places — your admin panel and your customer's My Account page.
A
Admin — from the Orders list or individual order
  • Go to WooCommerce → Orders
  • Find the completed order
  • Click Download Invoice to get the GST/VAT invoice PDF
  • Click Download Certificate to get the jewelry purchase certificate PDF
💡 You can also open an individual order and find the download buttons inside the order detail page — useful when you need to re-send documents to a customer.
B
Customer — from My Account → Orders
  • Customer logs in to their WooCommerce account on your store
  • Goes to My Account → Orders
  • Clicks View on the relevant order
  • Sees download buttons for Invoice and Certificate at the bottom of the order detail
Customers can download their own documents at any time — no need to email them manually. This reduces your support workload significantly.
Document Samples
These are examples of the two documents the plugin generates for every completed order.
Document 1 GST Invoice (PDF)
Raj Jewellers
123 Gold Market, Surat, Gujarat · GSTIN: 24AABCR1234A1Z5
Phone: +91 98765 43210 · raj@jewellers.com
TAX INVOICE
Invoice No: INV-2026-00847
Date: 13 June 2026
Bill To
Priya Sharma
priya.sharma@gmail.com
+91 99887 76655
Order
#WC-4821
Payment: Razorpay
✓ Paid
ItemPurityWeightMakingHUIDAmount
22K Gold Bridal Necklace
HSN: 7113
22K 18.5g 12% BIS2024KL7829 ₹1,02,340
18K Diamond Stud Earrings
HSN: 7113 · GIA: 2195447895
18K 4.2g 15% ₹48,600
Subtotal₹1,50,940
CGST @ 1.5%₹2,264
SGST @ 1.5%₹2,264
Making Charges₹17,282
Total Amount₹1,72,750
Sample GST Invoice — auto-generated with your store details, customer details, product jewelry fields, and full tax breakdown
Document 2 Jewelry Purchase Certificate (PDF)
Raj Jewellers
Jewelry Purchase Certificate
Authenticity & Quality Assurance Document
Certificate No.
CERT-2026-00847
Date of Purchase
13 June 2026
Customer Name
Priya Sharma
Item Description
22K Gold Bridal Necklace
Metal Type & Purity
Gold · 22 Karat (91.67%)
BIS Hallmark (HUID)
BIS2024KL7829
Gross Weight
19.8 grams
Net Metal Weight
18.5 grams
💎 Gemstone Details
Stone Type
Diamond
Total Carat
0.42 ct
Certificate
GIA 2195447895
Colour
F
Clarity
VS1
Cut
Excellent
Sample Purchase Certificate — auto-generated with hallmark, metal purity, stone details, and certificate number
Quick Reference — Navigation Paths
TaskAdmin Dashboard Navigation Path
Plugin settingsWooCommerce → Jewelry Invoice
Add jewelry fieldsProducts → Edit Product → Jewelry Certificate Details
Download invoice (admin)WooCommerce → Orders → Download Invoice
Download certificate (admin)WooCommerce → Orders → Download Certificate
Customer downloadsMy Account → Orders → View Order
Change tax typeWooCommerce → Jewelry Invoice → Tax Type

Preciousuite Gold Savings Scheme

Complete guide to configure, enroll, and manage customer installments and redemption for the Preciousuite Gold Savings Scheme WooCommerce plugin.

Your Setup Progress
1
Install Plugin
2
Configure Settings
3
Create Scheme
4
Enroll Customers
5
Track Payments
6
Redeem
Requirements
Before installing, make sure your server meets these requirements.
⚠️
WooCommerce is required
This plugin only works with WooCommerce installed and activated. Install WooCommerce first if you have not already.
RequirementMinimumRecommended
WordPress5.86.5 or higher
WooCommerce6.08.0 or higher
PHP7.48.1 or higher
MySQL5.68.0 or higher
HTTPSRequiredRequired (for payments)
Razorpay accountOptional (Free)Required for online payments (Pro)
1
Install the Plugin
There are two ways to install. Method A is the easiest for most users.
A
Install from WordPress Dashboard (Recommended)
Search and install directly from your WordPress admin — no file download needed.
  • Log in to your WordPress admin at yoursite.com/wp-admin
  • In the left sidebar go to Plugins → Add New Plugin
  • In the search box type Preciousuite Gold Saving Scheme
  • Find the plugin by Preciousuite and click Install Now
  • After installation click Activate Plugin
After activation you will see Gold Scheme appear in your WordPress sidebar menu.
B
Install via ZIP Upload (Manual)
Use this method if you downloaded the plugin ZIP file from WordPress.org or received a Pro ZIP from Preciousuite.
  • Go to Plugins → Add New Plugin
  • Click Upload Plugin at the top of the page
  • Click Choose File and select your preciousuite-gold-savings-scheme.zip file
  • Click Install Now
  • Click Activate Plugin
💡 If you are upgrading from Free to Pro, upload the Pro ZIP through the same Upload Plugin screen. It will replace the free version automatically without losing any data.
2
Configure Settings
Set up your store's gold price and payment settings before creating any schemes.
1
Open the Settings Page
Navigate to the plugin settings from your WordPress admin sidebar.
WordPress Admin Gold Scheme Settings
2
Set the Manual Gold Price
This is the fallback gold price used for weight calculations when the live API is not connected.
FieldDescriptionExample
Manual Gold Price (₹ per gram)* Current 24K gold rate per gram in your currency ₹7,200
Currency Your store currency — must match WooCommerce currency INR (₹)
⚠️ Update the manual gold price regularly if you are not using the live API. An outdated rate will cause incorrect gold weight calculations for customers.
3
Enter Razorpay API Keys PRO
Required only if you want customers to pay installments online via Razorpay. Skip this step for cash-only stores.
  • Log in to your Razorpay Dashboard at dashboard.razorpay.com
  • Go to Settings → API Keys
  • Click Generate Key to create a new key pair
  • Copy the Key ID and Key Secret
  • Paste both into the Razorpay fields in Plugin Settings
FieldWhere to Find It
Razorpay Key IDRazorpay Dashboard → Settings → API Keys → Key ID
Razorpay Secret KeyRazorpay Dashboard → Settings → API Keys → Key Secret
💡 Use Test Mode keys first (rzp_test_...) while setting up. Switch to Live keys (rzp_live_...) only when ready for real transactions.
4
Click Save Changes
Click the Save Changes button at the bottom of the settings page to apply your configuration.
3
Create Your First Scheme
A scheme defines the rules for a gold saving plan. You can create multiple schemes — for example a Bridal Set scheme and a Daily Wear scheme with different installment amounts.
1
Open Scheme Creation
Gold Scheme Schemes Add New Scheme

Or click the Create New Scheme button on the Dashboard page.

2
Fill in Scheme Basic Information
These fields define the core rules of the scheme.
FieldDescriptionExample
Scheme Title* A name your customers will see when enrolling Bridal Jewellery Set Plan
Description Short description shown to customers on the enrollment page Save ₹5,000/month for 11 months and receive a free bonus month. Redeem for any bridal jewellery of your choice.
Scheme Type* Fixed Monthly Amount — customer pays same amount every month.
Fixed Gold Weight — customer receives same grams every month, amount varies with gold price.
Fixed Monthly Amount
Duration (Months)* How many months the scheme runs before maturity 11
Gold Purity* The karat of gold used to calculate weight from installment amount 22K
Min Installment (₹)* Minimum monthly payment amount. Customers can pay more if they choose. ₹5,000
3
Configure Rules & Benefits
These settings appear on the right panel of the Create Scheme page.
FieldDescriptionRecommended
Provide 1 Month Bonus on Maturity When ticked, the system automatically adds one free bonus installment when the scheme matures. This is the standard industry practice. ✓ Enable
GST Rate (%) GST percentage applied to installment payments. In India the standard rate for jewelry is 3%. 3
KYC — Aadhaar Card Require customers to upload their Aadhaar card during enrollment ✓ Recommended for India
KYC — PAN Card Require customers to upload their PAN card. Required for purchases above ₹2 lakh. ✓ Recommended
💡 The bonus month is the biggest incentive for customers to join. Always enable it — it costs you one month's gold liability but guarantees a high-value purchase at maturity.
4
Click Save Scheme
Click Save Scheme on the right panel. The scheme is now Active and visible to customers.
Your scheme now appears in the Jewelry Saving Schemes list with Status: Active. Customers can now enroll.
4
Customer Enrollment
Customers can enroll in a scheme in two ways — online through their WooCommerce account, or manually by the store admin on their behalf.
A
Customer Self-Enrolls Online
When the customer is logged in, they visit My Account → Gold Scheme and fill in the enrollment form.
  • Customer logs in to their WooCommerce account
  • Goes to My Account → Gold Scheme
  • Clicks Enroll in a Scheme
  • Selects a scheme from the dropdown
  • Enters their installment amount (must be ≥ minimum)
  • Uploads KYC documents (Aadhaar, PAN) if required
  • Submits the enrollment form
💡 The enrollment is set to Pending KYC until you verify the uploaded documents. The customer cannot make payments until KYC is approved.
B
Admin Enrolls a Customer Manually
For in-store enrollments — when the customer walks in and wants to join a scheme at the counter.
Gold Scheme Customers Add New Customer
  • Search for the customer by email or create a new WP user
  • Select the scheme they want to join
  • Enter installment amount and start date
  • Upload scanned KYC documents on their behalf
  • Save — KYC can be auto-approved for in-store enrollments
5
Verify Customer KYC
Before a customer can start making payments, you need to verify their identity documents. This is a legal requirement in India for jewelry transactions.
1
Go to Customer KYC Management
Gold Scheme Customers

You will see a list of all enrolled customers with their KYC Status column showing Pending, Verified, or Rejected.

2
Review the Documents
Click View Document next to the customer's name to see their uploaded Aadhaar or PAN card.
3
Approve or Reject
Click Verify to approve the KYC — the customer is now Active and can pay installments. Click Reject/Unverify if documents are invalid.
Once KYC is verified, the customer receives an email confirmation and their installment schedule becomes active.
6
Record Installment Payments
Payments can be collected online via Razorpay (Pro) or recorded manually for cash/UPI in-store payments (Free and Pro).
A
Customer Pays Online PRO
The customer logs into My Account → Gold Scheme, opens their enrollment, and clicks Pay Now for their next installment. Razorpay handles the payment and the ledger updates automatically.
💡 After a successful Razorpay payment, the plugin automatically calculates the gold weight earned (based on today's live rate) and updates the customer's gold weight ledger. No admin action is required.
B
Record Manual Payment (Cash / UPI / Cheque)
When a customer pays in-store, record the payment manually from your admin dashboard.
Gold Scheme Customers View Enrollments Record Payment
FieldDescription
Payment Date*Date the customer paid. Defaults to today.
Amount Paid (₹)*Actual amount received. Must be ≥ scheme minimum.
Gold Rate on Payment DateAuto-filled from live API if connected, or from manual rate. You can edit this.
Payment Method*Cash / Cheque / Bank Transfer / UPI
Reference NumberUPI transaction ID, cheque number, or any reference for your records.
After saving, the gold weight is calculated automatically and added to the customer's ledger. A payment receipt email is sent to the customer.
7
Customer Portal — My Account
Pro customers get a full self-service portal in WooCommerce My Account. Here is what it shows and how it works.
ℹ️
Pro feature
The customer-facing My Account portal is available in the Pro version only. Free version customers can view their scheme status from the admin dashboard.
1
How Customers Access the Portal
  • Customer logs in to their WooCommerce account
  • Clicks Gold Scheme tab in the My Account menu
  • Sees all their active and past scheme enrollments
2
What Customers Can See and Do
FeatureDescription
Summary cardsTotal gold accumulated, total amount saved, next payment due date and amount
Scheme progress barVisual progress showing X of 11 installments paid
Gold weight balanceCurrent gold weight in grams and live value in ₹
Payment historyTable of all payments with date, amount, gold rate on that day, gold weight credited
Download receiptPDF receipt for each installment payment
Pay Now buttonOpens Razorpay to pay the next installment directly
Redeem buttonVisible only when scheme matures — starts the redemption flow
8
Scheme Maturity & Redemption
When all installments are paid, the scheme matures. Here is exactly what happens next.
1
Automatic Maturity on Final Payment
When the last installment is recorded (payment 11 of 11), the plugin automatically triggers maturity.
  • Enrollment status changes from Active to Matured
  • Bonus month is automatically credited to the gold weight ledger
  • Maturity email sent to customer with full summary (total amount, total gold grams, current value, redemption instructions)
  • Admin notification email sent
  • Dashboard Gold Liabilities updates to reflect the matured balance
2
Customer Redeems Their Balance PRO
The customer uses their accumulated gold value to purchase jewelry from your store.
  • Customer goes to My Account → Gold Scheme and clicks Redeem Now
  • Sees a redemption summary showing total gold weight and current ₹ value
  • Clicks Start Shopping — a credit equal to their accumulated value is added to their WooCommerce account
  • Customer browses your store and adds items to cart
  • At checkout the gold scheme credit is applied automatically as a discount
  • If cart total exceeds the credit, customer pays the difference by normal payment method
After the order is complete, enrollment status changes to Redeemed and a redemption confirmation email is sent to the customer.
⚠️ The default redemption window is 30 days from maturity. If the customer does not redeem within 30 days, send them the deadline warning email manually or configure automatic deadline reminders (Pro).