بقچه

مدیریت سبد خرید و پرداخت برای فروشگاه‌های آنلاین

ورود

اتصال ساده

فقط کافیست یک CNAME به بقچه اشاره کنید

تشخیص خودکار محصول

محصولات را از schema.org به صورت خودکار تشخیص می‌دهد

پرداخت دستی

تأیید پرداخت با اسکرین‌شات یا شماره تراکنش

راهنمای اتصال فروشگاه (On-Boarding)

برای افزودن سبد خرید و پرداخت به فروشگاه خود، مراحل زیر را انجام دهید:

ثبت فروشگاه

ادمین سیستم فروشگاه شما را در پنل مدیریت ایجاد می‌کند

تنظیم DNS

یک زیردامنه مانند cart.example.com با رکورد CNAME به سرور بقچه اشاره کنید

تنظیم هدرها (Headers)

برای تشخیص خودکار محصول، هدرهای زیر را در سرور خود تنظیم کنید:

Content-Type: text/html; charset=utf-8
X-Robots-Tag: all
Access-Control-Allow-Origin: *

هدر Content-Type با charset=utf-8 برای خواندن صحیح کاراکترهای فارسی ضروری است.

افزودن لینک

لینک زیر را در صفحه محصول خود قرار دهید:

<a href="https://SUBDOMAIN/add?url=PRODUCT_URL">
  افزودن به سبد خرید
</a>

اگر URL شامل کاراکترهای خاص است از روش base64 استفاده کنید:

<a href="https://SUBDOMAIN/add?b64=BASE64_URL">
  افزودن به سبد خرید
</a>

بررسی ساختار داده (Schema.org)

بقچه از ساختارهای استاندارد schema.org پشتیبانی می‌کند. صفحه محصول شما باید شامل JSON-LD یا Microdata باشد:

انواع پشتیبانی شده:

schema.org/Product
schema.org/Offer (price, priceCurrency, inventoryLevel)
schema.org/AggregateOffer (highPrice, lowPrice, priceCurrency)

پراپرتی‌های ضروری:

name — نام محصول
offers.price — قیمت (عددی مثبت)

پراپرتی‌های اختیاری:

description — توضیحات
image — URL تصویر
offers.priceCurrency — واحد پول (پیش‌فرض: USD)
offers.inventoryLevel.value — موجودی انبار (عدد صحیح)
productType — نوع محصول (physical/digital)

مثال inventoryLevel: اگر موجودی انبار را تعریف کنید، بقچه آن را ذخیره می‌کند.

{
  "@type": "Offer",
  "price": 250000,
  "priceCurrency": "IRR",
  "inventoryLevel": {
    "@type": "QuantitativeValue",
    "value": 42
  }
}

انجام شد

بقچه به صورت خودکار اطلاعات محصول را از schema.org استخراج می‌کند

توجه: crawler بقچه با User-Agent BindleBot/1.0 صفحه محصول شما را برای استخراج اطلاعات بررسی می‌کند. در صورت استفاده از CDN یا فایروال، این crawler را مجاز کنید.

نمونه پرامپت برای AI Agent

برای ادغام سریع وب‌سایت با بقچه، این پرامپت را در AI Agent خود (Cursor، Claude، ChatGPT) کپی کنید:

You are integrating a website with Bindle (بقچه), a shopping cart & payment SaaS.

The merchant has a CNAME subdomain pointing to Bindle (e.g. cart.example.com).

On each product detail page, add an "add to cart" link:

<a href="https://SUBDOMAIN/add?url=PRODUCT_URL">
  Add to Cart
</a>

- SUBDOMAIN: the merchant's subdomain (e.g. cart.example.com)
- PRODUCT_URL: URL-encoded full URL of the product page

For complex URLs use base64 instead:

<a href="https://SUBDOMAIN/add?b64=BASE64_URL">
  Add to Cart
</a>

- BASE64_URL: standard base64 of the full product URL

Header requirements:
- Set Content-Type: text/html; charset=utf-8
- Set X-Robots-Tag: all
- Set Access-Control-Allow-Origin: *

Supported schema.org markup (JSON-LD or Microdata):
- Product (name, description, image)
- Offer (price, priceCurrency, inventoryLevel.value)
- AggregateOffer (highPrice, lowPrice)

Steps:
1. Find the product page template
2. Add the link with the correct SUBDOMAIN
3. Add schema.org/Product JSON-LD to the page head (if missing)
4. Include offers.inventoryLevel.value for stock tracking (optional)
5. Style the link as a button matching the site design
6. Whitelist BindleBot/1.0 in CDN/firewall so Bindle can fetch product data