Skip to Content
FeaturesIntegrations

Integrations

Overview

Siyahfy integrates with several third-party services to extend its functionality. These integrations include Amazon for multi-channel selling, Shopify for store migration, Delhivery for shipping logistics, Razorpay and Cashfree for payments, Firebase for authentication, Google OAuth for social login, and Google Analytics for traffic tracking. Each integration is designed to be configured through the vendor’s admin panel without requiring custom code.

How It Works

Amazon Integration

Siyahfy connects to Amazon Seller Central via OAuth to enable multi-channel selling:

  1. Authorization — Vendor initiates Amazon OAuth flow from the admin panel.
  2. Callback — Amazon redirects back with an authorization code.
  3. Token exchange — The backend exchanges the code for access/refresh tokens.
  4. Data sync — Amazon product and order data can be synced with the Siyahfy store.

Shopify Import

For vendors migrating from Shopify, the import process supports:

  • Products — Full product catalog with variants, images, and descriptions
  • Customers — Customer database with addresses
  • Orders — Historical order data
  • Reviews — Product reviews and ratings

Each import type has a dedicated endpoint that handles the field mapping from Shopify’s data format to Siyahfy’s schema.

Delhivery Shipping

The Delhivery integration provides:

  • Pickup address management — Register warehouse addresses with Delhivery
  • Rate calculation — Get shipping cost estimates based on weight and destination
  • Shipment creation — Create shipments when orders are fulfilled
  • Tracking — Track shipment status in real time

Payment Gateways

Two payment gateways are supported:

GatewayFeatures
RazorpayUPI, cards, net banking, wallets, EMI; webhook-based payment confirmation
CashfreeUPI, cards, net banking; session-based checkout with webhooks

Both gateways support:

  • Order creation on the gateway
  • Payment verification via webhooks
  • Refund processing
  • Subscription management (Razorpay)

Firebase Authentication

Firebase handles customer authentication on the storefront:

  • Email/password login with OTP verification
  • Google OAuth social login
  • Session management via JWT tokens

Google Analytics

GA4 integration provides:

  • Session and pageview tracking
  • Conversion tracking
  • Revenue attribution
  • Channel-wise traffic breakdown
  • Data is fetched via the GA4 Data API and cached in hourly_marketing_reports

Key API Endpoints

Amazon

GET/api/amazon/callback

Handle Amazon OAuth callback and store authorization tokens

GET/api/getAmazonStoreDataAuth Required

Get connected Amazon store data and sync status

GET/api/getInfo

Get Amazon seller account information

Shopify Import

POST/api/shopifyBulkUploadAuth Required

Import products from Shopify CSV export

POST/api/shopifyBulkUploadCustomerAuth Required

Import customers from Shopify export

POST/api/shopifyBulkUploadOrdersAuth Required

Import orders from Shopify export

POST/api/shopifyReviewUploadAuth Required

Import reviews from Shopify export

Delhivery

GET/api/delhivery/pickup-addressesAuth Required

List registered Delhivery pickup addresses

POST/api/delhivery/pickup-addressesAuth Required

Register a new pickup address with Delhivery

PUT/api/delhivery/pickup-addresses/:idAuth Required

Update a Delhivery pickup address

Payment Gateways

POST/api/manage-paymentAuth Required

Add or update payment gateway configuration

POST/api/get-payment-methodsAuth Required

Get configured payment methods

POST/api/getRazoryPayOrderId

Create a Razorpay payment order

POST/razorpay/webhook

Razorpay payment webhook handler

POST/api/payment-cashfree

Create a Cashfree payment session

POST/api/payment/webhook-cashfree

Cashfree payment webhook handler

Customer Auth (Storefront)

POST/api/validateOtpByEmail

Send OTP for email verification (Firebase)

POST/api/verifyOtpByEmail

Verify email OTP and create/update customer

Database Tables

TablePurpose
amazon_store_connectionsAmazon OAuth tokens and seller account data
delhivery_addressesRegistered Delhivery pickup addresses
payment_methodsPayment gateway configurations per store
vendor_subscriptionsRazorpay subscription data for platform billing
hourly_marketing_reportsCached Google Analytics data
customersCustomer accounts (Firebase-authenticated)
  • Payments — Razorpay and Cashfree are payment integrations
  • Shipping — Delhivery is a shipping integration
  • Bulk Operations — Shopify import is a bulk integration
  • Marketing — Google Analytics feeds marketing data
  • Customers — Firebase/Google OAuth handle customer authentication
Team ManagementStorefront