ابزارک ها
مستندات SDK
پرداخت سرویس پزشک

پرداخت سرویس پزشک

window.hamdast.initialize({ app_key: "YOUR_APP_KEY" });
 
const { event, receipt_id, message } = await window.hamdast.payment.payForDoctorService({
  amount: 100000,
  payload: { serviceId: "..." },
});
 
if (event === "HAMDAST_PAYMENT_DOCTOR_SERVICE_SUCCESS") {
  // receipt_id
} else if (event === "HAMDAST_PAYMENT_DOCTOR_SERVICE_CANCEL") {
  // cancelled
} else if (event === "HAMDAST_PAYMENT_DOCTOR_SERVICE_ERROR") {
  // message
}

ورودی

FieldTypeDescription
amountNumberمبلغ پایه خدمت (ریال) — اجباری
payloadObjectاختیاری؛ در پاسخ برنمی‌گردد

خروجی

FieldTypeDescription
eventStringSUCCESS | CANCEL | ERROR
receipt_idStringدر SUCCESS
messageStringدر ERROR

رویدادها

  • HAMDAST_PAYMENT_DOCTOR_SERVICE_SUCCESS
  • HAMDAST_PAYMENT_DOCTOR_SERVICE_CANCEL
  • HAMDAST_PAYMENT_DOCTOR_SERVICE_ERROR

مبلغ

payable = amount + (amount × 0.3 × 0.1)

amount را خودتان VAT اضافه نکنید. واحد: ریال.

پیش‌نیاز

  • SDK: نصب
  • اجرا داخل iframe روی پروفایل پزشک (/dr/...)
  • پس از پرداخت موفق، نیازی به تایید monetization ندارید؛ تسویه توسط پلتفرم انجام می‌شود

استرداد (سرور)

اگر پرداخت موفق بود و باید مبلغ به بیمار برگردد، receipt_id برگشتی از SDK را در سرور خود نگه دارید و درخواست استرداد را فقط از بک‌اند بفرستید (همان الگوی کلید توسعه‌دهندهx-api-key را در فرانت‌اند قرار ندهید).

fetch("https://hamdast.paziresh24.com/api/v1/apps/{app_key}/billing/provider-service/refund", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    receipt_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    reason: "لغو خدمت به درخواست پزشک",
  }),
});
FieldTypeDescription
receipt_idStringشناسه صورت‌حساب همان پرداخت موفق — اجباری
reasonStringدلیل استرداد (برای سوابق) — اجباری
x-api-keyHeaderAPI Key از کنسول همدست
پاسخ موفق (200)
FieldTypeDescription
statusBooleanنتیجه درخواست
messageStringپیام (در صورت وجود)
receipt_idStringهمان شناسه ارسالی
خطاهای رایج
کدمعنی
400رسید هنوز برای استرداد آماده نیست، یا فیلدها ناقص/نامعتبر است
403این رسید به ابزارک شما تعلق ندارد
404رسید پیدا نشد