مقدمه

فروشگاه‌هایی که به شبکه خرید آوند می‌پیوندند، می‌توانند با استفاده از این سرویس‌ها، عملیات خرید خود را پیاده‌سازی نمایند.

پیش از شروع

  • URL فراخوانی سرویس­ها:

Production Server: https://api.pod.ir/srv/sc/nzh/doServiceCall

Sandbox Server:https://sandbox.pod.ir/srv/sc/nzh/doServiceCall

  • تمامی درخواست­ها با متد POST ارسال می­شوند.
  • فیلدهای زیر درHeader تمامی درخواست­ها ثابت است:

پارامتر

توضیحات

_token_

توکن کسب­وکاری دریافتی از پنل

_token_issuer_

مقدار ثابت "1"

 

  • فیلدهای زیر در بدنه‌ی تمامی درخواست‌ها ثابت است (با فرمت x-www-form-urlencoded):

پارامتر

توضیحات

scProductId

شناسه­ی سرویس مدنظر

scApiKey

راهنمای دریافت این پارامتر در این لینک موجود است.

 

  • علاوه بر موارد بالا که ثابت هستند، اگر سرویس نیاز به پارامتر دیگری داشته باشد در داکیومنت مربوطه ذکر شده است.
  • خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.

نکته:پس از درخواست سرویس به پادیوم، همکاران ما درخواستهای ارسالی را بررسی می‌کنند. در صورت عدم دریافت تایید کرد بر روی درخواست ارسالی ظرف یک روز کاری،به همکاران ما از طریق شماره تلفن (021-89518989) و یا در گروه واتس‌اپ اطلاع دهید تا دسترسی به سرویس موردنظر برای شما فعال شود.

سرویس خرید

  • شناسه‌ی سرویس : 1390689

  • پارامترهای ورودی

پارامتر

نوع

توضیحات

userId

string

شناسه‌ی کاربری

businessId

string

شناسه‌ی کسب‌وکاری

price

string

مبلغ

 

بدنه­ی پاسخ دریافتی دارای ساختار زیر است:

پارامتر

نوع

توضیحات

customerInvoiceId

int

شناسه فاکتور کاربر

paymentUrl

string

لینک پرداخت

 

سرویس تایید خرید

  • شناسه‌ی سرویس : 1390695

  • پارامترهای ورودی

پارامتر

نوع

توضیحات

invoiceId

string

شناسه فاکتور

بدنه­ ی پاسخ دریافتی دارای ساختار زیر است:

پاسخ این سرویس دارای بدنه نمی‌باشد و موفقیت‌آمیز بودن یا نبودن آن بر اساس http status code قابل ارزیابی است.

 

سرویس لغو خرید

  • شناسه‌ی سرویس : 1390697

  • پارامترهای ورودی

پارامتر

نوع

توضیحات

invoiceId

string

شناسه فاکتور

 

بدنه­ ی پاسخ دریافتی دارای ساختار زیر است:

پاسخ این سرویس دارای بدنه نمی‌باشد و موفقیت‌آمیز بودن یا نبودن آن بر اساس http status code قابل ارزیابی است.

 

کدهای ارور (errorCode) معمول در پلتفرم

برای مشاهده‌ی کدهای ارور پلتفرم به این لینک مراجعه کنید.

 

 

Clasor npm package version 2.1.4
به پادیوم قدرت داده اند:
pasargad
fanap
pod