Storefront API

নিজের ফ্রন্টএন্ড আনুন। কমার্স চালাবে Shopemaa।

প্রোডাক্ট, কালেকশন, সার্চ, কার্ট, চেকআউট ও শপার অ্যাকাউন্টের জন্য একটি স্টোরফ্রন্ট API, পেমেন্ট আগে থেকেই Stripe-এর সঙ্গে যুক্ত। Next.js, Astro, একটি মোবাইল অ্যাপ বা কিয়স্ক দিয়ে বানান; পেমেন্ট ও অর্ডার সামলায় Shopemaa।

যে প্ল্যানে অন্তর্ভুক্ত:
  • Growth
  • Scale
  • Enterprise
ডায়াগ্রাম: আপনার ফ্রন্টএন্ড স্টোরফ্রন্ট API কল করে; Shopemaa Stripe দিয়ে পেমেন্ট, অর্ডার ও স্টক সামলায়, আর সাইন করা ওয়েবহুক ফেরত পাঠায়।

কেন গুরুত্বপূর্ণ

Storefront API দিয়ে কী বদলায়

সমস্যা

নিজে কমার্স তৈরি করা মানে কার্ট, চেকআউট, পেমেন্ট আর অর্ডার ব্যবস্থাপনা, যার সবকিছু নিরাপদ ও মিলিয়ে রাখতে হয়।

Storefront API দিয়ে

ফ্রন্টএন্ডের পুরো নিয়ন্ত্রণ আপনার হাতে রাখুন, আর এর পেছনের কমার্স চালাতে দিন Shopemaa-কে: ক্যাটালগ, চেকআউট, Stripe পেমেন্ট, অর্ডার ও স্টক।

  • পেমেন্ট সিস্টেম নয়, নিজের ফ্রন্টএন্ড বানান
  • নিরাপদ রিট্রাই, ডুপ্লিকেট অর্ডার নয়
  • সব জায়গায় স্টক ও অর্ডার মিলে থাকে

সবচেয়ে উপযোগী: যেসব টিমের নিজস্ব ফ্রন্টএন্ড, মোবাইল অ্যাপ বা কিয়স্ক আছে.

কীভাবে কাজ করে

সাইন আপ থেকে বিক্রি পর্যন্ত 4টি ধাপ

  1. অ্যাপ কী নিন

    প্রতিটি রিকোয়েস্টে আপনার স্টোরের অ্যাপ কী থাকে।

  2. ক্যাটালগ পড়ুন

    প্রোডাক্ট, কালেকশন ও সার্চ, ভ্যারিয়েন্ট, ছবি ও প্রাপ্যতাসহ।

  3. চেকআউট করুন

    কার্ট পাঠান এবং একটি অর্ডার ও একটি চেকআউট লিংক ফেরত পান। পেমেন্ট হয় Stripe-এর মাধ্যমে।

  4. পরিবর্তনের খবর পান

    সাইন করা ওয়েবহুক আপনার সিস্টেমকে অর্ডার, প্রোডাক্ট ও স্টকের খবর জানায়।

যা পাচ্ছেন

Storefront API-এ যা যা আছে

  • একটি API

    প্রোডাক্ট, কালেকশন, সার্চ, কার্ট, চেকআউট ও শপার অ্যাকাউন্ট।

  • পেমেন্ট আগে থেকেই যুক্ত

    চেকআউট আগে থেকেই Stripe-এর সঙ্গে যুক্ত, পেমেন্ট আসে আপনার নিজের অ্যাকাউন্টে।

  • নিরাপদ রিট্রাই

    চেকআউটের সঙ্গে একটি Idempotency-Key পাঠান, যাতে কোনো রিকোয়েস্ট আবার পাঠালেও দ্বিতীয় অর্ডার তৈরি না হয়।

  • সাইন করা ওয়েবহুক

    অর্ডার, প্রোডাক্ট ও স্টকের জন্য। ওয়েবহুক পাওয়া যায় Growth ও তার ওপরের প্ল্যানে।

  • আপনার ফ্রেমওয়ার্ক

    Next.js, Astro বা স্ট্যাটিক থিম, যা Shopemaa Cloud-এ বিল্ড ও হোস্ট হয়, অথবা আপনার চালানো যেকোনো অ্যাপ।

  • একটাই ক্যাটালগ

    স্টক, দাম ও অর্ডার আপনার স্টোরফ্রন্ট, চেকআউট ও লিংকের সঙ্গে মিলে থাকে।

উদাহরণ

প্রোডাক্ট তালিকা থেকে চেকআউট পর্যন্ত দুটি রিকোয়েস্ট

আপনার অ্যাপ কী দিয়ে একটি কালেকশন পড়ুন, তারপর একটি Idempotency-Key সহ কার্ট পোস্ট করুন এবং অর্ডার ও তার চেকআউট লিংক ফেরত পান।

Example storefront API requests: list a collection's products, then check out.
GET /storefront/v1/products?collection=mugs&size=12
Shopemaa-App-Key: sfk_…

{ "items": [{ "slug", "title", "price", "images",
             "variants", "availability" }], "page", … }

POST /storefront/v1/checkout
Idempotency-Key: 7c9e…
{ "lines": [{ "variant_id", "quantity" }], "email", … }

{ "order_id", "order_number", "checkout_url", … }

একটাই ক্যাটালগ

API বিক্রির চারটি উপায়ের একটি

প্রোডাক্ট একবার যোগ করুন আর সব জায়গায় বিক্রি করুন। স্টক, দাম আর অর্ডার মিলে থাকে, তাই Storefront API থেকে আসা অর্ডার আর অন্য যেকোনো চ্যানেলের অর্ডার একই তালিকায় জমা হয়।

প্রোডাক্ট একবার যোগ করুন। কাস্টমার যেখান থেকেই কিনুক, স্টক, দাম আর অর্ডার মিলে থাকে।

Storefront API দিয়ে বিক্রি শুরু করুন

30 দিন ফ্রি, কোনো কার্ড লাগবে না। অর্ডারে কোনো কমিশন নেই।