پرداخت سرویس پزشک
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
}ورودی
| Field | Type | Description |
|---|---|---|
| amount | Number | مبلغ پایه خدمت (ریال) — اجباری |
| payload | Object | اختیاری؛ در پاسخ برنمیگردد |
خروجی
| Field | Type | Description |
|---|---|---|
| event | String | SUCCESS | CANCEL | ERROR |
| receipt_id | String | در SUCCESS |
| message | String | در ERROR |
رویدادها
HAMDAST_PAYMENT_DOCTOR_SERVICE_SUCCESSHAMDAST_PAYMENT_DOCTOR_SERVICE_CANCELHAMDAST_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: "لغو خدمت به درخواست پزشک",
}),
});| Field | Type | Description |
|---|---|---|
| receipt_id | String | شناسه صورتحساب همان پرداخت موفق — اجباری |
| reason | String | دلیل استرداد (برای سوابق) — اجباری |
| x-api-key | Header | API Key از کنسول همدست |
پاسخ موفق (200)
| Field | Type | Description |
|---|---|---|
| status | Boolean | نتیجه درخواست |
| message | String | پیام (در صورت وجود) |
| receipt_id | String | همان شناسه ارسالی |
خطاهای رایج
| کد | معنی |
|---|---|
400 | رسید هنوز برای استرداد آماده نیست، یا فیلدها ناقص/نامعتبر است |
403 | این رسید به ابزارک شما تعلق ندارد |
404 | رسید پیدا نشد |