- منبع: تاجر
- محدودیتهای پرداخت
- محدودیتهای کارت اعتباری
- نوع کارت اعتباری
- گزینه پرداخت
- نوع گزینه پرداخت
- نوع فعالسازی
- محدودیت خرید کاربر
- پیکربندی پردازنده پرداخت
- پردازنده
- پیکربندی توکنسازی
- قالب اطلاعات صورتحساب
- شرایط
- MerchantMatchingHints
- ویژگی سرویس
- ارزش
- الگوی پیوند
- مشاوره
- اپراتور اقتصادی
- روشها
منبع: تاجر
اطلاعات مربوط به یک تاجر که در پلتفرم تجمیعکننده قرار دارد.
| نمایش JSON |
|---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
| فیلدها | |
|---|---|
name | نام منبع تجاری، که قالب آن |
merchantName | نام فروشنده، تلفن، آدرس اینترنتی و موقعیت جغرافیایی برای تطبیق موجودی شریک با فروشندگانی که از قبل در نقشههای گوگل حضور دارند، استفاده میشوند. این اطلاعات نمایش داده نخواهند شد. نام تاجر. |
telephone | شماره تلفن عمومی فروشنده شامل کد کشور و منطقه، مثلاً +14567891234 |
url | آدرس اینترنتی وبسایت عمومی تاجر. |
geo | اطلاعات جغرافیایی فروشنده، شامل عرض جغرافیایی، طول جغرافیایی و آدرس. |
category | دسته بندی کسب و کار در پلتفرم تجمیع کننده. |
numBookings30d | این فیلد منسوخ شده است. |
taxRateBasisPoints | نرخ مالیات تاجر بر حسب واحد پایه (یک صدم درصد). برای مثال، اگر نرخ مالیات ۷.۵٪ باشد، این فیلد باید روی ۷۵۰ تنظیم شود. اگر این فیلد تنظیم نشده یا روی ۰ تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این فروشنده از کاربر دریافت میشود، دقیقاً همان قیمتی است که توسط Service.price مشخص شده است. فرض بر این است که قیمت سرویس از مالیاتهای مربوطه معاف است یا قبلاً شامل آن میشود. مالیاتها به عنوان یک ردیف جداگانه به کاربر نشان داده نمیشوند. اگر این فیلد روی هر مقدار غیر صفر تنظیم شود، کل قیمتی که برای هر خدماتی که توسط این فروشنده ارائه میشود، از کاربر دریافت میشود، شامل قیمت خدمات به علاوه مالیات تعیینشده با استفاده از نرخ مالیات ارائه شده در اینجا خواهد بود. کسرهای کوچکترین واحد پول (به عنوان مثال، کسرهای یک سنت) با استفاده از گرد کردن زوج گرد میشوند. مالیاتها به عنوان یک ردیف جداگانه به کاربر نشان داده میشوند. این فیلد منسوخ شده است، لطفاً به جای آن از taxRate استفاده کنید. |
taxRate | نرخ مالیات تاجر. در صورت وجود، این فیلد جایگزین فیلد منسوخشدهی taxRateBasisPoints میشود. یک پیام خالی (یعنی taxRate { }) نرخ مالیات اعمالشده را به صفر بازنشانی میکند. منسوخ شده است زیرا پرداختهای E2E دیگر پشتیبانی نمیشوند. |
paymentRestrictions | محدودیتهای روشهای پرداختی که این فروشنده میپذیرد. اگر این فیلد تنظیم نشده باشد، فرض میکنیم هیچ محدودیتی وجود ندارد. منسوخ شده است زیرا پرداختهای E2E دیگر پشتیبانی نمیشوند. |
paymentOption[] | گزینههای پرداخت برای این فروشنده موجود است. سرویسهای تحت این فروشنده قادر خواهند بود گزینههای پرداخت مجاز را به صورت جداگانه محدود کنند. منسوخ شده است زیرا پرداختهای E2E دیگر پشتیبانی نمیشوند. |
paymentProcessorConfig | پیکربندی برای پردازنده پرداخت توکنیزه شده، در صورتی که فروشنده از آن پشتیبانی کند. |
tokenizationConfig | پیکربندی برای پردازنده پرداخت توکنیزه شده، در صورتی که فروشنده از آن پشتیبانی کند. منسوخ شده است زیرا پرداختهای E2E دیگر پشتیبانی نمیشوند. |
terms | شرایط و ضوابط خاص فروشنده که هنگام رزرو سرویس از طریق رزرو با گوگل به کاربر نمایش داده میشود. علاوه بر این، شرایط و ضوابط شریک تجمیعکننده همیشه به کاربر نمایش داده میشود و نباید در اینجا ارائه شود. |
brandId | رشتهای مبهم که برندِ مشتریمدار را برای نمایشِ نسبتِ شریک مشخص میکند. این فیلد به شرکایی که چندین برندِ مشتریمدار دارند اجازه میدهد تا برای همه برندها در یک فید، فروشندگانی را ارائه دهند. یک برند شامل ویژگیهایی است که با مصرفکننده در ارتباط هستند، مانند نام، لوگو، شرایط خدمات و سیاست حفظ حریم خصوصی. اگر فقط یک برند شریک با مشتری وجود دارد، نیازی به تنظیم این فیلد نیست و میتوان آن را نادیده گرفت. اگر شریک ... آیا چندین برندِ مشتریمحور ندارد؟ --> این فیلد را نادیده بگیرید آیا چندین برند پیکربندی شده دارد؟ نکتهی مهم: اکثر شرکا نیازی به تنظیم این فیلد ندارند. اگر شریکی مایل به استفاده از این فیلد باشد، ابتدا باید برای پیکربندی برندهای جداگانه، از جمله برند پیشفرض، با ما تماس بگیرد. |
matchingHints | نکاتی برای کمک به گوگل در تطبیق یک فروشنده با مکانی در نقشه گوگل. توجه: اکثر شرکا نیازی به تنظیم این فیلد ندارند، زیرا گوگل با استفاده از اطلاعات ارائه شده در بالا، فروشندگان را با مکانهای موجود در نقشه گوگل تطبیق میدهد. (اختیاری) |
serviceAttribute[] | تعاریف مربوط به هرگونه ویژگی سرویس که برای توصیف خدمات این پذیرنده استفاده میشود. (اختیاری) |
actionLink[] | اختیاری. یک URL مربوط به یک عمل به همراه زبان مربوطه، فهرست کشورهای محدود به آن، نوع آن و پلتفرم اختیاری که نشان میدهد این عمل باید روی کدام پلتفرم انجام شود، |
reservationLinkoutTemplate[] | اختیاری. الگوی پیوند که مشخص میکند گوگل چگونه باید URL شریک را برای رزرو میز در پلتفرم خود تولید کند. توجه داشته باشید که در حال حاضر، در صورت ارائه چندین مورد، فقط از مورد اول استفاده خواهد شد. الگوی URI از فیلدهایی پشتیبانی میکند که بر اساس انتخابهای رزرو کاربر پر میشوند، برای ساخت موفقیتآمیز URL رزرو، به همه فیلدهای الزامی نیاز است: * (الزامی) partySize, int: اندازه مهمانی که کاربر درخواست رزرو برای آن را دارد. * (الزامی) selected_date_time, ISO 8601 datetime ( https://en.wikipedia.org/wiki/ISO_8601 ) : زمانی که کاربر درخواست رزرو برای آن را دارد. * (اختیاری) merchantId, string: شناسه فروشندهای که کاربر درخواست رزرو با آن را دارد، در صورتی که الگو از قبل شامل شناسه فروشنده باشد، نیازی نیست. * (اختیاری) roomId, string: شناسه اتاقی که کاربر درخواست رزرو برای آن را دارد. |
waitlistAdvisement | اختیاری. توصیههای کلی از یک فروشنده خاص برای کاربری که از طریق رزرو با گوگل به لیست انتظار میپیوندد. طول فیلدهای متنی در این توصیه باید به ۱۰۰ بایت محدود شود. |
economicOperator | اختیاری. اطلاعات اپراتور اقتصادی مرتبط با این تاجر خاص که برای رعایت مقررات لازم است. (اختیاری) |
محدودیتهای پرداخت
محدودیتهای روشهای پرداختی که این فروشنده میپذیرد.
| نمایش JSON |
|---|
{
"creditCardRestrictions": {
object ( |
| فیلدها | |
|---|---|
creditCardRestrictions | محدودیتهای کارتهای اعتباری که این فروشنده میپذیرد. اگر این فیلد تنظیم نشده باشد، فرض میکنیم همه کارتهای اعتباری پذیرفته میشوند. توجه داشته باشید که لیست کارتهای پشتیبانی شده توسط CreditCardType به مرور زمان افزایش مییابد، به این معنی که خالی گذاشتن این قسمت منوط به تغییرات پیکربندی در آینده است. |
محدودیتهای کارت اعتباری
محدودیتهای مربوط به انواع کارتهای اعتباری که این فروشنده میپذیرد.
| نمایش JSON |
|---|
{
"creditCardType": [
enum ( |
| فیلدها | |
|---|---|
creditCardType[] | فهرستی از کارتهای اعتباری پشتیبانیشده. در صورت خالی بودن، هیچ کارت اعتباری پشتیبانی نمیشود. |
نوع کارت اعتباری
یک نوع کارت اعتباری.
| انومها | |
|---|---|
CREDIT_CARD_TYPE_UNSPECIFIED | استفاده نشده. |
VISA | یک کارت اعتباری ویزا. |
MASTERCARD | یک کارت اعتباری مسترکارت. |
AMERICAN_EXPRESS | یک کارت اعتباری امریکن اکسپرس. |
DISCOVER | یک کارت اعتباری دیسکاور. |
JCB | یک کارت اعتباری جی سی بی. |
گزینه پرداخت
یک گزینه پرداخت، که میتواند برای پرداخت هزینه خدمات ارائه شده توسط یک فروشنده استفاده شود. گزینههای پرداخت را میتوان بین چندین فروشنده (مثلاً فروشندگان متعلق به یک زنجیره) به اشتراک گذاشت.
| نمایش JSON |
|---|
{ "paymentOptionId": string, "name": string, "description": string, "price": { object ( |
| فیلدها | |
|---|---|
paymentOptionId | این شناسه برای شناسایی این گزینه پرداخت استفاده میشود. این شناسه برای کل تجمیعکننده جهانی است و استفاده مجدد از یک مقدار در بین چندین فروشنده به کاربر اجازه میدهد تا با گزینه پرداخت مربوطه در بین آن فروشندگان پرداخت کند. هنگام استفاده مجدد از یک شناسه توسط چندین فروشنده، بهروزرسانی هر مقدار برای گزینه پرداخت تحت یک فروشنده، هر گزینه پرداخت دیگری را که دارای همان شناسه است، تحت یک فروشنده متفاوت، نیز بهروزرسانی میکند. به این ترتیب، بهترین روش این است که همه گزینههای پرداخت دارای شناسه یکسان باشند و همیشه با مقادیر یکسان بهروزرسانی شوند تا از هرگونه احتمال رفتار غیرمنطقی جلوگیری شود. |
name | نام گزینه پرداخت. این گزینه میتواند توسط کاربر قابل مشاهده باشد. |
description | توضیحی از گزینه پرداخت. این توضیح میتواند برای کاربر قابل مشاهده باشد. |
price | قیمت گزینه پرداخت. |
taxRate | نرخ مالیات برای این گزینه پرداخت. در صورت وجود، این فیلد جایگزین فیلد taxRate موجود در بخش فروشنده یا سرویس میشود. یک پیام خالی (یعنی taxRate {}) نرخ مالیات اعمال شده را به صفر بازنشانی میکند. |
paymentOptionType | نوع این گزینه پرداخت. یکبار مصرف برای خریدهای حضوری، چندبار مصرف برای بستهها و نامحدود برای عضویتها. |
sessionCount | این گزینه پرداخت برای چند جلسه قابل استفاده است؟ فقط برای چند جلسه / بسته معتبر است، که در آن مقدار باید بزرگتر از ۱ باشد. |
purchaseInterval | گزینه پرداخت را میتوان در این بازه زمانی خریداری کرد. |
validInterval | گزینه پرداخت میتواند در این بازه زمانی استفاده شود (مثلاً قیمت ویژه ژانویه ۲۰۱۷). در صورت وجود، این گزینه، validDuration و activationType را لغو میکند. |
validDuration | مدت اعتبار گزینه پرداخت (مثلاً عضویت 30 روزه). مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' |
activationType | نحوه تعیین تاریخ شروع اعتبار برای این گزینه پرداخت را تعریف میکند. |
userRestriction | کاربران واجد شرایط برای خرید این گزینه پرداخت را محدود میکند. میتواند برای محدود کردن گزینه پرداخت تبلیغاتی به زیرمجموعهای از کاربران استفاده شود. اگر تنظیم نشود، همه کاربران واجد شرایط هستند. |
نوع گزینه پرداخت
نوع گزینه پرداخت.
| انومها | |
|---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED | استفاده نشده. |
PAYMENT_OPTION_SINGLE_USE | گزینه پرداخت فقط یک بار قابل استفاده است. |
PAYMENT_OPTION_MULTI_USE | اگر تعداد جلسات > 0 باشد، میتوان از گزینه پرداخت استفاده کرد. |
PAYMENT_OPTION_UNLIMITED | گزینه پرداخت میتواند در محدوده زمانی معتبر خود استفاده شود - تعداد جلسات قابل اجرا نیست. |
نوع فعالسازی
نحوه تعیین تاریخ شروع اعتبار را تعریف میکند.
| انومها | |
|---|---|
ACTIVATION_TYPE_UNSPECIFIED | استفاده نشده. |
ACTIVATION_ON_PURCHASE | اعتبار از زمان خرید شروع میشود. |
ACTIVATION_ON_FIRST_USE | اعتبار از زمانی شروع میشود که برای اولین بار از گزینه پرداخت استفاده شود. |
محدودیت خرید کاربر
کاربران واجد شرایط برای خرید یک گزینه پرداخت را محدود میکند.
| نمایش JSON |
|---|
{ "newToMerchant": boolean, "newToPaymentOption": boolean } |
| فیلدها | |
|---|---|
newToMerchant | یک گزینه پرداخت که فقط کاربرانی میتوانند آن را خریداری کنند که قبلاً هرگز از همان فروشنده خرید نکردهاند. |
newToPaymentOption | یک گزینه پرداخت که فقط کاربرانی میتوانند آن را خریداری کنند که قبلاً هرگز همان گزینه پرداخت را خریداری نکردهاند. |
پیکربندی پردازنده پرداخت
پیکربندی برای یک پردازنده پرداخت، که بر اساس هر پذیرنده تنظیم میشود.
| نمایش JSON |
|---|
{
"processor": enum ( |
| فیلدها | |
|---|---|
processor | شریک پردازشگر پرداختی که این پیکربندی برای آن اعمال میشود را تعریف میکند. |
publicKey | کلیدی که برای شناسایی این فروشنده توسط پردازنده پرداخت استفاده میشود. برای Stripe، به آدرس https://stripe.com/docs/dashboard#api-keys مراجعه کنید. برای Braintree، به آدرس https://articles.braintreepayments.com/control-panel/important-gateway-credentials مراجعه کنید. |
version | شماره نسخه API که به همراه درخواستهای پرداخت به پردازنده پرداخت ارسال میشود. |
پردازنده
یک شریک پردازشگر پرداخت خاص را تعریف میکند.
| انومها | |
|---|---|
PROCESSOR_UNSPECIFIED | استفاده نشده |
PROCESSOR_STRIPE | پیکربندی برای پرداختها با Stripe. |
PROCESSOR_BRAINTREE | پیکربندی برای پرداختها با Braintree. |
پیکربندی توکنسازی
پیکربندی برای توکنسازی پردازنده پرداخت، که بر اساس هر پذیرنده تنظیم میشود.
| نمایش JSON |
|---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
| فیلدها | |
|---|---|
tokenizationParameter | یک پیکربندی توکنسازی معمولاً یک پارامتر توکنسازی دارد که کلید آن "gateway" و مقدار آن نام پردازنده است. بقیه پارامترها به پردازنده بستگی دارند. برای اطلاعات بیشتر به مستندات Google Pay مراجعه کنید. مثال Braintree: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" } مثال Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" } مثال Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" } یک شیء شامل لیستی از جفتهای |
billingInformationFormat | اطلاعات صورتحساب کاربر را همانطور که با FOP خود در Google Pay وارد کرده است (به بالا مراجعه کنید) در توکن پرداخت وارد کنید. خالی گذاشتن این فیلد معادل مشخص کردن MIN است. |
قالب اطلاعات صورتحساب
چه مقدار از آدرس صورتحساب از کاربر درخواست شود و در توکن لحاظ شود. مقادیر enum مربوط به پارامترهای موجود در API گوگل پی هستند (به https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters مراجعه کنید) .
| انومها | |
|---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED | مشخص نشده است. مقدار پیشفرض MIN است. |
MIN | نام، کد کشور و کد پستی (تنظیمات پیشفرض Google Pay). |
FULL | نام، آدرس خیابان، محل، منطقه، کد کشور و کد پستی. |
شرایط
مجموعهای از قوانین و دستورالعملها که به کاربر نمایش داده میشود تا بتواند از طریق رزرو با گوگل، رزرو انجام دهد.
| نمایش JSON |
|---|
{
"url": string,
"text": string,
"localizedText": {
object ( |
| فیلدها | |
|---|---|
url | در صورت تمایل، آدرس اینترنتی (URL) مربوط به شرایط و ضوابط. |
text | متنی که به کاربر نمایش داده میشود. برای ادغامهای جدید از localizedText زیر استفاده کنید. |
localizedText | متن محلی شده که قرار است به کاربر نمایش داده شود. |
MerchantMatchingHints
نکاتی که برای کمک به گوگل در تطبیق یک فروشنده با مکانی در نقشههای گوگل استفاده میشد.
| نمایش JSON |
|---|
{ "placeId": string } |
| فیلدها | |
|---|---|
placeId | شناسه مکان برای یک مکان در پایگاه داده Google Places و در نقشههای گوگل. برای اطلاعات بیشتر در مورد شناسههای مکان به https://developers.google.com/places/web-service/place-id مراجعه کنید. |
ویژگی سرویس
ویژگیهای سرویس، دستههای تعریفشده توسط شریک هستند که خدمات یک پذیرنده را توصیف میکنند. برای مثال، یک بانک ممکن است یک ویژگی سرویس «نوع حساب» با مقادیر احتمالی «شخصی» و «تجاری» تعریف کند، در حالی که یک آرایشگاه ممکن است یک ویژگی سرویس «نوع سرویس» با مقادیر احتمالی «مدل مو»، «رنگ» و «مدل» تعریف کند.
| نمایش JSON |
|---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
| فیلدها | |
|---|---|
attributeId | شناسهای که این ویژگی سرویس را به طور منحصر به فرد در میان سایر ویژگیهای همان فروشنده مشخص میکند، مثلاً "نوع حساب". |
attributeName | یک نام قابل مشاهده توسط کاربر برای این ویژگی، مثلاً "نوع حساب". |
value[] | تمام مقادیر ممکن برای این ویژگی سرویس. |
ارزش
نشان دهنده یک مقدار ممکن برای یک ویژگی خاص سرویس است.
| نمایش JSON |
|---|
{ "valueId": string, "valueName": string } |
| فیلدها | |
|---|---|
valueId | شناسهای که این مقدار را به طور منحصر به فرد در میان سایر مقادیر برای این ویژگی سرویس مشخص میکند، مثلاً "شخصی". |
valueName | یک نام قابل مشاهده توسط کاربر برای مقدار، مثلاً "شخصی". |
الگوی پیوند
الگویی که مشخص میکند گوگل چگونه باید URLها را به سایت شریک تولید کند.
| نمایش JSON |
|---|
{ "uriTemplate": string } |
| فیلدها | |
|---|---|
uriTemplate | الگوی uri باید از RFC 6570 پیروی کند، به https://datatracker.ietf.org/doc/html/rfc6570 مراجعه کنید. از الگوهای سطح ۱ و تمام الگوهای ترکیبی سطح ۴ پشتیبانی میکند. مثال: http://example.com/book/{foo}?b={bar } * foo = 2 * bar = abc https://example.com/book/2?b=abc |
مشاوره
توصیههایی که هنگام رزرو از طریق رزرو با گوگل به کاربر نمایش داده میشوند.
| نمایش JSON |
|---|
{
"text": {
object ( |
| فیلدها | |
|---|---|
text | پیام سفارشی که هنگام رزرو از طریق رزرو با گوگل به کاربر نمایش داده میشود. |
اپراتور اقتصادی
اطلاعات اپراتور اقتصادی برای تجمیعکننده.
| نمایش JSON |
|---|
{
"text": {
object ( |
| فیلدها | |
|---|---|
text | الزامی. نام، آدرس، شماره تلفن و آدرس ایمیل اپراتور اقتصادی، که به عنوان تولیدکننده، نماینده مجاز، واردکننده، توزیعکننده، ارائهدهنده خدمات تکمیل سفارش یا هر شخص حقیقی یا حقوقی دیگری که مشمول تعهدات مربوط به تولید محصولات، عرضه یا بهکارگیری آنها است، تعریف میشود. نمایش رشتهای آزاد از اپراتور اقتصادی. این اطلاعات ممکن است با استفاده از " " و "\n" قالببندی شود. |
روشها | |
|---|---|
| یک Merchant جدید ایجاد میکند که توسط تجمیعکننده مشخصشده مدیریت میشود و آن را برمیگرداند. |
| یک Merchant موجود که توسط تجمیعکننده مشخصشده مدیریت میشود را حذف میکند. |
| MerchantStatus یک Merchant را دریافت کنید. |
| یک Merchant موجود که توسط تجمیعکنندهی مشخصشده مدیریت میشود را بهروزرسانی میکند و آن را برمیگرداند. |