سرویس های دریافت رمز ارزراه اندازی درگاه سایت
در حال بررسی داده های ورودی...
ورود قبلا ثبت نام کرده اید ؟ ثبت نام حساب کاربری ندارید ؟ بازیابی رمزتان را به خاطر ندارید ؟ فعالسازی ایمیل فعال سازی دریافت نکردید ؟ انجام این فرآیند به منزله پذیرش قوانین مجموعه است.
به کمک این بخش می توانید یک درگاه پرداخت ارزی برای وب سایت تان راه اندازی نمایید. درگاه های ارزی محدودیتی در نوع خدمات و یا محل زندگی مشتریان ندارند و براحتی می توانید طیف متنوعی از خدمات و محصولات را به تمامی مشتریان در سر تا سر دنیا ارائه نمایید. برای شروع کافی است آدرس وب سایت تان را ثبت کرده و یک کلید API دریافت نمایید. سپس از طریق راهنمای زیر می توانید براحتی برای وب سایت تان یک درگاه اختصاصی پیاده سازی نمایید.
راهنمای اتصال سایت به درگاه پرداخت
افزونه های آماده
در پنل مدیریت وردپرس، روی گزینه افزونه ها از منو اصلی کلیک کنید. سپس از زیرمنوی باز شده، گزینه افزونه جدید را انتخاب نمایید. در صفحه باز شده، روی کلید بارگذاری در کنار عنوان صفحه کلیک کنید تا فرم بارگذاری افزونه، نمایش داده شود.
از طریق کلید Browes فایل مربوط به افزونه را انتخاب کرده و روی کلید نصب کلیک کنید. پس از چند ثانیه افزونه نصب می شود. سپس روی کلید فعال سازی کلیک نمایید تا افزونه فعال شود.
برای فعال سازی، تنظیم و مدیریت افزونه، به منو ووکامرس » زیرمنو تنظیمات » سربرگ روش های پرداخت، مراجعه نمایید.
از طریق کلید Browes فایل مربوط به افزونه را انتخاب کرده و روی کلید نصب کلیک کنید. پس از چند ثانیه افزونه نصب می شود. سپس روی کلید فعال سازی کلیک نمایید تا افزونه فعال شود.
برای فعال سازی، تنظیم و مدیریت افزونه، به منو ووکامرس » زیرمنو تنظیمات » سربرگ روش های پرداخت، مراجعه نمایید.
فایل مربوط به افزونه را دانلود کرده و از حالت زیپ خارج نمایید. سپس در بخش مدیریت فایل در پنل مدیریت هاست ( مانند Cpanel, DirectAdmin, Plesk,... (، به مسیر زیر رفته و فایل مربوط به افزونه را بارگذاری نمایید.
/Public_HTML/modules/gateways/
پس از بارگذاری فایل افزونه، به پنل مدیریت WHMCS رفته و از گزینه تنظیمات، سربرگ درگاه های پرداخت را انتخاب نمایید. در صفحه جدید، سربرگ تمام درگاه های پرداخت را انتخاب کرده و از لیست درگاه ها، گزینه DigiDargah را یافته و روی آن کلیک نمایید.
در صفحه جدید افزونه را فعال کرده و تنظیمات دلخواه را برای فیلدهای مربوط به آن اعمال نمایید.
/Public_HTML/modules/gateways/
پس از بارگذاری فایل افزونه، به پنل مدیریت WHMCS رفته و از گزینه تنظیمات، سربرگ درگاه های پرداخت را انتخاب نمایید. در صفحه جدید، سربرگ تمام درگاه های پرداخت را انتخاب کرده و از لیست درگاه ها، گزینه DigiDargah را یافته و روی آن کلیک نمایید.
در صفحه جدید افزونه را فعال کرده و تنظیمات دلخواه را برای فیلدهای مربوط به آن اعمال نمایید.
فایل مربوط به افزونه را دانلود کرده و از حالت زیپ خارج نمایید. سپس در بخش مدیریت فایل در پنل مدیریت هاست ( مانند Cpanel, DirectAdmin, Plesk,... (، به مسیر زیر رفته و پوشه مربوط به افزونه را بارگذاری نمایید.
/Public_HTML/modules/
پس از بارگذاری کل پوشه، به پنل مدیریت پرستان رفته و از گزینه ماژول ها، سربرگ مدیریت ماژول ها را انتخاب نمایید. در صفحه جدید کمی اسکرول کرده و از لیست ماژول ها، گزینه دیجی درگاه را یافته و روی کلید نصب کلیک نمایید.
پس از نصب، روی کلید ویرایش کلیک کرده و تنظیمات دلخواه را برای فیلدهای مربوط به آن اعمال نمایید.
/Public_HTML/modules/
پس از بارگذاری کل پوشه، به پنل مدیریت پرستان رفته و از گزینه ماژول ها، سربرگ مدیریت ماژول ها را انتخاب نمایید. در صفحه جدید کمی اسکرول کرده و از لیست ماژول ها، گزینه دیجی درگاه را یافته و روی کلید نصب کلیک نمایید.
پس از نصب، روی کلید ویرایش کلیک کرده و تنظیمات دلخواه را برای فیلدهای مربوط به آن اعمال نمایید.
در پنل مدیریت وردپرس، روی گزینه افزونه ها از منو اصلی کلیک کنید. سپس از زیرمنوی باز شده، گزینه افزونه جدید را انتخاب نمایید. در صفحه باز شده، روی کلید بارگذاری در کنار عنوان صفحه کلیک کنید تا فرم بارگذاری افزونه، نمایش داده شود.
از طریق کلید Browes فایل مربوط به افزونه را انتخاب کرده و روی کلید نصب کلیک کنید. پس از چند ثانیه افزونه نصب می شود. سپس روی کلید فعال سازی کلیک نمایید تا افزونه فعال شود.
برای فعال سازی، تنظیم و مدیریت افزونه، به منو گرویتی فرم » زیرمنو تنظیمات » سربرگ دیجی درگاه، مراجعه نمایید.
از طریق کلید Browes فایل مربوط به افزونه را انتخاب کرده و روی کلید نصب کلیک کنید. پس از چند ثانیه افزونه نصب می شود. سپس روی کلید فعال سازی کلیک نمایید تا افزونه فعال شود.
برای فعال سازی، تنظیم و مدیریت افزونه، به منو گرویتی فرم » زیرمنو تنظیمات » سربرگ دیجی درگاه، مراجعه نمایید.
در پنل مدیریت وردپرس، روی گزینه افزونه ها از منو اصلی کلیک کنید. سپس از زیرمنوی باز شده، گزینه افزونه جدید را انتخاب نمایید. در صفحه باز شده، روی کلید بارگذاری در کنار عنوان صفحه کلیک کنید تا فرم بارگذاری افزونه، نمایش داده شود.
از طریق کلید Browes فایل مربوط به افزونه را انتخاب کرده و روی کلید نصب کلیک کنید. پس از چند ثانیه افزونه نصب می شود. سپس روی کلید فعال سازی کلیک نمایید تا افزونه فعال شود.
برای فعال سازی، تنظیم و مدیریت افزونه، به منو دانلودها » زیرمنو تنظیمات » سربرگ پرداخت ها، مراجعه نمایید.
از طریق کلید Browes فایل مربوط به افزونه را انتخاب کرده و روی کلید نصب کلیک کنید. پس از چند ثانیه افزونه نصب می شود. سپس روی کلید فعال سازی کلیک نمایید تا افزونه فعال شود.
برای فعال سازی، تنظیم و مدیریت افزونه، به منو دانلودها » زیرمنو تنظیمات » سربرگ پرداخت ها، مراجعه نمایید.
این نمونه کد بر پایه زبان برنامه نویسی PHP نوشته شده است و برای استفاده از آن کافی است فایل را از حالت زیپ خارج کرده و در هاست بارگذاری نمایید. همچنین در صورتی که با مفاهیم برنامه نویسی آشنا هستید می توانید از کد ارائه شده در وب سایت تان استفاده نمایید.
این نمونه کد با دریافت API، لیست آخرین تراکنش های انجام شده روی درگاه وب سایت شما نمایش می دهد.
این نمونه کد با دریافت API، لیست آخرین تراکنش های انجام شده روی درگاه وب سایت شما نمایش می دهد.
برای اتصال به درگاه، پس از ثبت وب سایت تان و دریافت کلید API، کافی است از طریق تابع file_get_contents در PHP و یا توابع مشابه در زبان های برنامه نویسی دیگر، اطلاعات زیر را برای آدرس وب سرویس که در زیر نمایش داده شده است POST نمایید. پس از ارسال اطلاعات، داده های مورد نیاز برای انجام پرداخت توسط مشتری، در پاسخ نمایش داده می شود.
https://digidargah.com/action/ws/request_create
api_key
String
String
پس از ثبت وب سایت تان، این کلید به صورت خودکار از طرف سایت تولید و در اختیار شما قرار داده می شود. این کلید یکتا بوده و برای هر وب سایت به صورت اختصاصی تولید می شوند.
amount_value
Demical
Demical
مبلغ کالا را می توانید به تومان و یا دلار ارسال نمایید. مقدار ارز قابل پرداخت به صورت خودکار و براساس قیمت لحظه ای ارز محاسبه و به کاربر نمایش داده می شود.
amount_currency
String
String
از طریق این متغییر، نوع مبلغ ارسال شده در متغییر amount_value را تعیین می نمایید. مقدار پیش فرض usd است و در صورت تمایل به ارسال مبلغ براساس تومان، می توانید از مقدار irt برای این متغییر استفاده نمایید.
pay_currency
String
String
به صورت پیش فرض کاربر امکان پرداخت از طریق تمامی ارزهای فعال در درگاه را دارد اما در صورتی که تمایل دارید مشتری را محدود به پرداخت از طریق یک یا چند ارز خاص کنید، می توانید از طریق این متغییر نام ارز و یا ارزها را اعلام نمایید. در صورت تمایل به اعلام بیش از یک ارز، آنها را توسط خط تیره ( dash ) از هم جدا کنید.
نمایش لیست
نمایش لیست
order_id
String
String
یک مقدار یکتاست که در طرف وب سایت شما و برای ارجا به سفارش ایجاد می شود. در صورت تمایل به بررسی یک سفارش و یا رهگیری وضعیت آن، می توانید از عبارت اعلام شده از طریق این متغییر استفاده نمایید.
desc
String
String
مقدار ارسال شده برای این متغییر، فقط برای مدیریت سایت و در لیست تراکنش ها نمایش داده می شود و متناسب با نیاز، می تواند حاوی اطلاعات مرتبط با سفارش باشد. طول این رشته حداکثر می تواند 1024 کاراکتر باشد.
respond_type
String
String
مقدار این متغییر به صورت پیش فرض روی link تنظیم شده است و در پاسخ به درخواست ارسالی، یک لینک برگشت داده می شود تا کاربر با ورود به آن، نسبت به مشاهده و پرداخت فاکتور اقدام نماید. در صورتی که تمایل ندارید کاربر در فرآیند پرداخت از وب سایت شما خارج شود می توانید مقدار این متغییر را روی iframe تنظیم نمایید تا صفحه فاکتور به صورت مستقیم در وب سایت شما نمایش داده شود.
iframe_style
String
String
اگر مقدار متغییر respond_type را روی iframe تنظیم کرده باشید از طریق این متغییر می توانید برای پنجره فاکتور ( که در وب سایت شما نمایش داده می شود ) اندازه و استایل دلخواه اعمال نمایید. از طریق این متغییر تنها کدهای CSS ارسال نمایید. ( مثال : width:500px; height:300px; border:1px solid #000; )
callback
String
String
اگر تمایل دارید بعد از پرداخت موفق فاکتور، کاربر به صفحه خاصی هدایت شود می توانید آدرس صفحه را از طریق این متغییر ارسال نمایید. امکان بررسی وضعیت فاکتور در هر لحظه و از طریق تابع request_status میسر خواهد بود.
نمونه کد
ارسال اطلاعات به درگاه
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://digidargah.com/action/ws/request/create ",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 5,
CURLOPT_TIMEOUT => 60,
CURLOPT_USERAGENT => $_SERVER["HTTP_USER_AGENT"],
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
"api_key" => "YOUR_API_KEY",
"amount_value" => "100000",
"amount_currency" => "irt",
"pay_currency" => "bitcoin,dogecoin,litecoin",
"order_id" => "1733281583",
"desc" => "توضیح دلخواه درباره سفارش",
"respond_type" => "link",
"iframe_style" => "",
"callback" => "https://your-site.com/callback"
]),
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
$result = json_decode($response, true);
var_dump($result);
}
curl_setopt_array($curl, [
CURLOPT_URL => "
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 5,
CURLOPT_TIMEOUT => 60,
CURLOPT_USERAGENT => $_SERVER["HTTP_USER_AGENT"],
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
"amount_value" => "100000",
"amount_currency" => "irt",
"pay_currency" => "bitcoin,dogecoin,litecoin",
"order_id" => "1733281583",
"desc" => "توضیح دلخواه درباره سفارش",
"respond_type" => "link",
"iframe_style" => "",
"callback" => "https://your-site.com/callback"
]),
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
$result = json_decode($response, true);
var_dump($result);
}
پس از ارسال اطلاعات در مرحله قبل، متناسب با موارد ارسال شده، یکی از پاسخ های زیر را از طرف وب سرویس دریافت می کنید. در صورتی که داده های ارسالی معتبر باشند و برای مقدار respond_type گزینه link را ارسال کرده باشید، مقداری مشابه زیر برگشت داده می شود. حال می بایست از طریق تابع header در PHP و یا تابع windows.location.href در JS، مشتری را به لینک ارائه شده برای مقدار respond هدایت نمایید تا فرآیند پرداخت توسط مشتری انجام شود. همچنین مقدار ارائه شده برای متغییر request_id را ذخیره نمایید در مرحله بعد و برای بررسی وضعیت فاکتور بتوانید مجددا آن را فراخوانی کنید.
array(
"status" => "success",
"request_id" => "674fc72f745e7",
"respond" => "https://digidargah.com/sub/request/674fc72f745e7"
);
"request_id" => "674fc72f745e7",
"respond" => "https://digidargah.com/sub/request/674fc72f745e7"
);
در صورتی که داده های ارسالی معتبر باشند و برای مقدار respond_type گزینه Iframe را ارسال کرده باشید، مقداری مشابه زیر برگشت داده می شود. سپس کافی است کد HTML ارائه شده برای مقدار respond را به کاربران نمایش دهید تا فرآیند پرداخت را انجام دهند.
array(
"status" => "success",
"request_id" => "674fc72f745e7",
"respond" => "<iframe src="https://digidargah.com/sub/request/674fc72f745e7" style="width:100%; height:500px; border:0; overflow:auto;"></iframe>"
);
"request_id" => "674fc72f745e7",
"respond" => "<iframe src="https://digidargah.com/sub/request/674fc72f745e7" style="width:100%; height:500px; border:0; overflow:auto;"></iframe>"
);
در صورتی که داده های ارسالی معتبر نباشند و یا خطایی از طرف وب سرویس وجود داشته باشد، مقداری مشابه زیر برگشت داده می شود.
array(
"status" => "failed",
"respond" => "پیام خطا با ذکر جزئیات مرتبط با اطلاعات نامعتبری که ارسال شده است.",
"error_no" => "شماره خطا"
);
"respond" => "پیام خطا با ذکر جزئیات مرتبط با اطلاعات نامعتبری که ارسال شده است.",
"error_no" => "شماره خطا"
);
در صورتی که پرداخت کاربر با موفقیت انجام شود کاربر به آدرس ارائه شده برای مقدار callback برگشت داده می شود. در این صفحه مالک وب سایت می تواند از طریق تابع request_status وضعیت فاکتور را بررسی کرده و در صورت موفقیت آمیز بودن پرداخت، نسبت به ارائه خدمات به مشتری اقدام نماید. به منظور بررسی وضعیت فاکتور، می بایست از طریق تابع file_get_contents در PHP و یا توابع مشابه در زبان های برنامه نویسی دیگر، اطلاعات زیر را برای آدرس وب سرویس که در زیر نمایش داده شده است POST نمایید.
https://digidargah.com/action/ws/request/status
api_key
String
String
پس از ثبت وب سایت تان، این کلید به صورت خودکار از طرف سایت تولید و در اختیار شما قرار داده می شود. این کلید یکتا بوده و برای هر وب سایت به صورت اختصاصی تولید می شوند.
order_id
String
String
یک مقدار یکتاست که در طرف وب سایت شما و برای ارجا به سفارش ایجاد می شود. این عبارت می بایست با عبارت ارسال شده برای قدم اول یکسان باشد.
request_id
String
String
یک مقدار یکتاست که در قدم دوم از طرف وب سرویس برگشت داده شده است. در قدم دوم می بایست این مقدار را ذخیر نمایید تا در این قدم بتوانید از طریق آن وضعیت فاکتور را بررسی نمایید.
نمونه کد
ارسال اطلاعات به درگاه
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://digidargah.com/action/ws/request/status ",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 5,
CURLOPT_TIMEOUT => 60,
CURLOPT_USERAGENT => $_SERVER["HTTP_USER_AGENT"],
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
"api_key" => "YOUR_API_KEY",
"order_id" => "1733281583",
"request_id" => "674fc72f745e7"
]),
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
$result = json_decode($response, true);
var_dump($result);
}
curl_setopt_array($curl, [
CURLOPT_URL => "
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 5,
CURLOPT_TIMEOUT => 60,
CURLOPT_USERAGENT => $_SERVER["HTTP_USER_AGENT"],
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
"order_id" => "1733281583",
"request_id" => "674fc72f745e7"
]),
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
$result = json_decode($response, true);
var_dump($result);
}
در صورتی که داده های ارسالی معتبر باشند، مقداری مشابه زیر برگشت داده می شود.
array(
"status" => "success",
"request_id" => "674fc72f745e7",
"order_id" => "1733281583",
"amount_value" => "100000",
"amount_currency" => "irt"
);
"request_id" => "674fc72f745e7",
"order_id" => "1733281583",
"amount_value" => "100000",
"amount_currency" => "irt"
);
در صورتی که داده های ارسالی معتبر نباشند و یا خطایی از طرف وب سرویس وجود داشته باشد، مقداری مشابه زیر برگشت داده می شود.
array(
"status" => "failed",
"respond" => "پیام خطا با ذکر جزئیات مرتبط با اطلاعات نامعتبری که ارسال شده است.",
"error_no" => "شماره خطا"
);
"respond" => "پیام خطا با ذکر جزئیات مرتبط با اطلاعات نامعتبری که ارسال شده است.",
"error_no" => "شماره خطا"
);