پارامترهای کارت و گزینه ها
رویدادهای ارسالی میتوانند شامل پارامترهایی که محصول را توصیف می کنند بوده یا شامل پارامترهای کارت باشند.
مشخصات کارت #
Parameter |
Type |
Description |
---|---|---|
cart_id |
string |
Cart ID. |
cart_items |
number |
تعداد گزینه ها در کارت (محصولات منحصر به فرد). |
currency |
string |
ارزی که قیمت، مالیات، تخفیف و هزینه حمل بر حسب آن محاسبه می شوند. اگر پارامتر مشخص نشود، ارز "USD" در گزارش نمایش داده خواهد شد. |
value |
number |
ارزش تمامی گزینه های کارت، شامل مالیات، تخفیف و هزینه حمل. به عبارت دیگر میزانی که خریدار بابت خرید خود پرداخت نموده است. به صورت پول مشخص می شود. |
profit |
number |
سود خالص فروشنده بابت فروشتمام گزینه های کارت. به صورت پول مشخص می شود. ارز محاسباتی استفاده شده بر اساس "currency". |
transaction_fee |
number |
هزینه تراکنش (کمیسیون سیستمپرداخت) برای خرید تمامی گزینه های کارت. به صورت پول مشخص می شود. ارز محاسباتی استفاده شده بر اساس "currency". |
transaction_id |
string |
شناسه پرداخت گزینه های کارت. |
affiliation |
string |
فروشگاه یا شعبه ای که تراکنش در آن انجام شده است. |
detail |
string |
جزئیات خطای خرید یا دلیل بازگشت وجه. این فیلد همچنین میتواند برای خرید موفق (پرداخت موفق) جهت ارائه جزئیات بیشتر استفاده شود. |
tax_value |
number |
مالیات کلی برای تمامی گزینه های کارت بر حسب پول. ارز محاسباتی استفاده شده بر اساس "currency". |
tax_name |
string |
Tax name. |
tax_type |
string |
Tax type. |
discount_value |
number |
میزان کل تخفیف اعمال شده برای تمامی گزینه های کارت بر حسب پول. ارز محاسباتی استفاده شده بر اساس "currency". |
discount_name |
string |
Discount name. |
discount_type |
string |
Discount type. |
shipping_value |
number |
هزینه حمل کل گزینه های کارت بر حسب پول. ارز محاسباتی استفاده شده بر اساس "currency". |
shipping_name |
string |
Delivery service name. |
shipping_type |
string |
Shipping type. |
checkout_step |
number |
شماره مرحله ای که مشتری در حال حاضر در آن هست. شما این مراحل را بر اساس رویدادهای شروع پرداخت، فرآیند پرداخت و پرداخت موفق شماره گذاری میکنید |
checkout_option |
string |
گزینه های پرداخت کارت. |
buyer |
string |
نام یا شناسه خریدار. به عنوان مثال نام کاربری فروشنده در سایت. این پارامتر برای تولید گزارشات خریداران برتر استفاده می شود. این گزارشات بسیار مفید خواهند بود اگرشما محصولات فروشندگان دیگر در سایت خود عرضه کنید . |
seller |
string |
شناسه یا نام فروشنده. به عنوان مثال نام کاربری فروشنده در سایت. این پارامتر برای تولید گزارشات فروشندگان برتر استفاده می شود. این گزارشات بسیار مفید خواهند بود اگرشما محصولات فروشندگان دیگر در سایت خود عرضه کنید . |
خصوصیات محصول #
Parameter |
Type |
Description |
---|---|---|
id * |
string |
Stock Keeping Unit (SKU). |
name * |
string |
Item name. |
brand |
string |
Item brand. |
category |
string |
Item category. به عنوان مثال، "البسه" یا "گوشی همراه". |
variant |
string |
Item variant: color, model, etc. |
quantity |
number |
Item quantity. |
currency |
string |
ارزی که قیمت گزینه، مالیات، تخفیف یا هزینه حمل بر اساس آن محاسبه می شوند. اگر پارامتر مشخص نشود، ارز "USD" در گزارش نمایش داده خواهد شد. |
price |
number |
Item value. |
value |
number |
خالص ارزش گزینه بر حسب پول مشتمل بر مالیات، تخفیف وهزینه حمل. به عبارت دیگر، این مقداری هست که خریدار برای گزینه ها پرداخت میکند. به صورت پول مشخص می شود. |
profit |
number |
خالص سود فروشنده گزینه. به صورت پول مشخص می شود. ارز محاسباتی استفاده شده بر اساس "currency". |
transaction_fee |
number |
هزینه تراکنش برای خرید گزینه. به صورت پول مشخص می شود. ارز محاسباتی استفاده شده بر اساس "currency". |
list_name |
string |
عنوان لیستی که گزینه تحت آن به کاربر عرضه شده است. به عنوانمثال لیست قیمت. |
list_position |
number |
جایگاه گزینه در لیست که تحت عنوان list_name مشخص می شود. |
tax_value |
number |
مالیات گزینه بر حسب پول. ارز محاسباتی استفاده شده بر اساس "currency". |
tax_name |
string |
Tax name. |
tax_type |
string |
Tax type. |
discount_value |
number |
تخفیف گزینه بر حسب پول. ارز محاسباتی استفاده شده بر اساس "currency". |
discount_name |
string |
Discount name. |
discount_type |
string |
Discount type. |
shipping_value |
number |
هزینه حمل بر حسب پول. ارز محاسباتی استفاده شده بر اساس "currency". |
shipping_name |
string |
Delivery service name. |
shipping_type |
string |
Shipping type. |
* — پارامترهای اجباری.