📡 REST API · v1

Phygit API
Developer Documentation

Integrate EU DPP verification, factory authentication, and AI-powered matching into your platform. All endpoints return JSON.

Base URL: https://phygit.itglobalonline.com
Format: All responses are JSON · UTF-8 encoded
Authentication: Public endpoints require no auth. Factory-write endpoints require Sanctum token.

1. Get DPP Data

Retrieve the full EU Digital Product Passport for any product by NFC tag UID

GET /api/dpp/{uid} Public · No auth required

Returns the complete EU Digital Product Passport for a product identified by its NFC tag UID. Includes supply chain events, blockchain verification status, fiber composition, certifications, and manufacturer details.

ParameterTypeRequiredDescription
uid string Required NFC tag UID (e.g. DEMO-TAG-001). Case-insensitive.
cURL Example
bash 
curl https://phygit.itglobalonline.com/api/dpp/DEMO-TAG-001
Response (200 OK)
json 
// Loading live data...

2. Factory Reputation Score

Get a factory's verified reputation score and compliance metrics

GET /api/factory/{id}/reputation Public · No auth required

Returns the factory's aggregated reputation score calculated from on-chain transactions, EU DPP compliance records, and supply chain verification events.

ParameterTypeRequiredDescription
id integer Required Factory ID from the Phygit registry (e.g. 1)
cURL Example
bash 
curl https://phygit.itglobalonline.com/api/factory/1/reputation
Response (200 OK)
json 
{
  "factory_id":      1,
  "factory_name":    "Apex Weaving Mills Ltd",
  "score":            87,
  "grade":            "A",
  "on_chain_events": 14,
  "dpp_issued":       3,
  "certifications":  ["GOTS", "OEKO-TEX"],
  "verified":         true
}

3. AI Factory Matching

Submit an RFQ and get AI-matched factory recommendations

POST /api/marketplace/match Public · No auth required

Submit a Request for Quotation (RFQ) and receive AI-powered factory matches from the Phygit verified registry. Powered by Claude (Anthropic). Returns ranked matches with scores and contact information.

FieldTypeRequiredDescription
rfq string Required Natural language description of what you need (e.g. "organic cotton shirts for EU")
quantity integer Optional Order quantity in units
certifications array Optional Required certifications: "GOTS", "OEKO-TEX", "ISO9001"
cURL Example
bash 
curl -X POST https://phygit.itglobalonline.com/api/marketplace/match \
  -H "Content-Type: application/json" \
  -d '{
    "rfq": "organic cotton shirts for EU",
    "quantity": 50000,
    "certifications": ["GOTS"]
  }'
Response (200 OK)
json 
{
  "matches": [
    {
      "factory_id":   1,
      "name":          "Apex Weaving Mills Ltd",
      "score":         94,
      "reason":        "GOTS certified, 15yr export experience, EU DPP active",
      "certifications": ["GOTS", "OEKO-TEX"],
      "location":      "Dhaka, Bangladesh"
    }
  ],
  "rfq_summary": "Organic cotton shirts for EU, qty 50,000, GOTS required",
  "model":        "claude-3-5-sonnet"
}

4. Platform Statistics

Live counts from the Phygit network database

GET /api/stats Public · No auth required

Returns live aggregate statistics from the Phygit platform database. Useful for dashboards, embeds, and partner integrations.

cURL Example
bash 
curl https://phygit.itglobalonline.com/api/stats
Response (200 OK)
json 
// Loading live data...

5. Rate Limits

All API keys are metered monthly. Exceeding limits returns HTTP 429.

Tier Plan NFC Scans/mo DPP Certs/mo API Calls/mo
Tier 1 Starter 5,000 500 1,000
Tier 2 Growth 50,000 5,000 10,000
Tier 3 Enterprise Unlimited Unlimited Unlimited

6. Webhook Events

Configure your webhook URL in the admin panel. Phygit sends a POST with JSON payload on these events:

order.paid Customer completes payment via bKash, Nagad, Stripe or cash.
cert.issued New EU DPP certificate is generated for a product.
scan.verified NFC tag scanned and product verified on blockchain.
tag.assigned NFC tag linked to a product in the dashboard.

7. Custom Domain Setup

Point your own domain to your Phygit shop (Tier 2+). We handle SSL automatically via Let's Encrypt.

  1. Go to your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.)
  2. Add a CNAME record:
    shop.yourbrand.com → phygit.itglobalonline.com
  3. In your Phygit brand editor, enter shop.yourbrand.com in the Custom Domain field
  4. Wait up to 24h for DNS propagation
  5. SSL certificate is auto-issued — your domain is live over HTTPS ✅
⚠️ For Cloudflare users: set your CNAME proxy status to DNS Only (grey cloud) initially. You can enable proxying after the SSL is issued.

8. White-Label Branding Guide

Customize every visible element of your brand's customer-facing pages.

Logo
PNG or WebP, 512×512px minimum, transparent background. Displayed in 44px height.
Primary Color
HEX format e.g. #2D5016. Used for headers, buttons, accents.
Secondary Color
HEX format e.g. #C9A84C. Used for highlights and badges.
Tagline
Max 120 characters. Shown below brand name on scan pages.
About Text
Max 500 characters. Shown on /brand/{slug} profile page.
Social Links
Facebook, Instagram, Website. Shown in profile and DPP footer.

9. Bangladesh Payment Guide

Three mobile payment methods + Stripe + Cash QR — all configured in your admin panel.

bKash Most widely used mobile banking in Bangladesh. Add your bKash merchant credentials in Admin → Brands → {your brand} → Gateway Keys.
Nagad Bangladesh Post Office mobile financial service. Growing user base. Same setup as bKash.
Stripe International cards, Apple Pay, Google Pay. Requires Stripe account with Bangladesh bank.
Cash QR In-store cash collection. Generate a QR code; cashier scans to confirm payment on their screen. No gateway account needed.

10. Pricing

Starter
$49/mo
Subdomain only
5K scans · 500 DPPs · bKash + Nagad
MOST POPULAR
Growth
$199/mo
Custom domain included
50K scans · 5K DPPs · All gateways + Stripe
Enterprise
Contact us
API access + white-label
Unlimited · Custom SLA · Dedicated support

NFC stickers sold separately — from $0.02 (NTAG215) to $1.20 (NTAG424). All plans include onboarding support.

🔒 Authentication — Factory write operations (mint, assign, register) require a Sanctum token obtained via POST /api/login.
📧 Support — admin@itglobalonline.com
🏢 IT Global LLC · QFC Licence #03131 · Qatar Financial Centre