سرویس های دریافت رمز ارزراه اندازی درگاه سایت
ورود قبلا ثبت نام کرده اید ؟ ثبت نام حساب کاربری ندارید ؟ بازیابی رمزتان را به خاطر ندارید ؟ فعالسازی ایمیل فعال سازی دریافت نکردید ؟ انجام این فرآیند به منزله پذیرش قوانین مجموعه است.
به کمک این بخش می توانید یک درگاه پرداخت ارزی برای وب سایت تان راه اندازی نمایید. درگاه های ارزی محدودیتی در نوع خدمات و یا محل زندگی مشتریان ندارند و براحتی می توانید طیف متنوعی از خدمات و محصولات را به تمامی مشتریان در سر تا سر دنیا ارائه نمایید. برای شروع کافی است آدرس وب سایت تان را ثبت کرده و یک کلید 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 را تعیین می نمایید. مقدار پیش فرض toman است و در صورت تمایل به ارسال مبلغ براساس دلار، می توانید از مقدار dollar برای این متغییر استفاده نمایید.
pay_currency
String
String
به صورت پیش فرض کاربر امکان پرداخت از طریق تمامی ارزهای فعال در درگاه را دارد اما در صورتی که تمایل دارید مشتری را محدود به پرداخت از طریق یک یا چند ارز خاص کنید، می توانید از طریق این متغییر نام ارز و یا ارزها را اعلام نمایید. در حال حاضر ارزهای bitcoin-ethereum-bnb-binanceusd-dogecoin-tron-tethertrc20-tetherbep20-tethererc20-toncoin-litecoin-bitcoincash-usdcointrc20-usdcoinbep20-usdcoinerc20-polygon فعال هستند. در صورت تمایل به اعلام بیش از یک ارز، آنها را توسط خط تیره ( dash ) از هم جدا کنید.
order_id
String
String
یک مقدار یکتاست که در طرف وب سایت شما و برای ارجا به سفارش ایجاد می شود. در صورت تمایل به بررسی یک سفارش و یا رهگیری وضعیت آن، می توانید از عبارت اعلام شده از طریق این متغییر استفاده نمایید.
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
اگر تمایل دارید بعد از پرداخت موفق فاکتور، کاربر به صفحه خاصی هدایت شود می توانید آدرس صفحه را از طریق این متغییر ارسال نمایید. امکان بررسی وضعیت فاکتور در هر لحظه و از طریق تابع requestStatus() میسر خواهد بود.
نمونه کد PHP ارسال اطلاعات به وب سایت
$DD_params = array(
'api_key' => '',
'amount_value' => '50000',
'amount_currency' => 'toman',
'pay_currency' => 'bitcoin,dogecoin,litecoin',
'order_id' => '46229791',
'respond_type' => 'link',
'iframe_style' => '',
'callback' => 'https://your-site.com/callback'
);
$DD_options = array( 'http' => array('method' => 'POST', 'header' => 'Content-Type: application/x-www-form-urlencoded', 'timeout' => 10, 'content' => http_build_query($DD_params)), 'ssl' => array('verify_peer' => false, 'verify_peer_name' => false));
$DD_result = file_get_contents('https://digidargah.com/action/ws/request_create', false, stream_context_create($DD_options));
$DD_result = json_decode($DD_result, true);
print_r($DD_result);
'api_key' => '',
'amount_value' => '50000',
'amount_currency' => 'toman',
'pay_currency' => 'bitcoin,dogecoin,litecoin',
'order_id' => '46229791',
'respond_type' => 'link',
'iframe_style' => '',
'callback' => 'https://your-site.com/callback'
);
$DD_options = array( 'http' => array('method' => 'POST', 'header' => 'Content-Type: application/x-www-form-urlencoded', 'timeout' => 10, 'content' => http_build_query($DD_params)), 'ssl' => array('verify_peer' => false, 'verify_peer_name' => false));
$DD_result = file_get_contents('https://digidargah.com/action/ws/request_create', false, stream_context_create($DD_options));
$DD_result = json_decode($DD_result, true);
print_r($DD_result);
پس از ارسال اطلاعات در مرحله قبل، متناسب با موارد ارسال شده، یکی از پاسخ های زیر را از طرف وب سرویس دریافت می کنید. در صورتی که داده های ارسالی معتبر باشند و برای مقدار respond_type گزینه link را ارسال کرده باشید، مقداری مشابه زیر برگشت داده می شود. حال می بایست از طریق تابع header در PHP و یا تابع windows.location.href در JS، مشتری را به لینک ارائه شده برای مقدار respond هدایت نمایید تا فرآیند پرداخت توسط مشتری انجام شود. همچنین مقدار ارائه شده برای متغییر request_id را ذخیره نمایید در مرحله بعد و برای بررسی وضعیت فاکتور بتوانید مجددا آن را فراخوانی کنید.
array('status' => 'success', 'request_id' => '641acb5f88ba5', 'respond' => 'https://digidargah.com/sub/request/641acb5f88ba5');
در صورتی که داده های ارسالی معتبر باشند و برای مقدار respond_type گزینه Iframe را ارسال کرده باشید، مقداری مشابه زیر برگشت داده می شود. سپس کافی است کد HTML ارائه شده برای مقدار respond را به کاربران نمایش دهید تا فرآیند پرداخت را انجام دهند.
array('status' => 'success', 'request_id' => '641acb5f88ba5', 'respond' => '<iframe src="https://digidargah.com/sub/request/641acb5f88ba5" style="width:100%; height:500px; border:0; overflow:auto;"></iframe>');
در صورتی که داده های ارسالی معتبر نباشند و یا خطایی از طرف وب سرویس وجود داشته باشد، مقداری مشابه زیر برگشت داده می شود.
array('status' => 'failed', 'respond' => 'پیام خطا با ذکر جزئیات مرتبط با اطلاعات نامعتبری که ارسال شده است.');
در صورتی که پرداخت کاربر با موفقیت انجام شود کاربر به آدرس ارائه شده برای مقدار 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
یک مقدار یکتاست که در قدم دوم از طرف وب سرویس برگشت داده شده است. در قدم دوم می بایست این مقدار را ذخیر نمایید تا در این قدم بتوانید از طریق آن وضعیت فاکتور را بررسی نمایید.
نمونه کد PHP ارسال اطلاعات به وب سایت
$DD_params = array('api_key' => '', 'order_id' => '46229791', 'request_id' => '641acb5f88bb6');
$DD_options = array( 'http' => array('method' => 'POST', 'header' => 'Content-Type: application/x-www-form-urlencoded', 'timeout' => 10, 'content' => http_build_query($DD_params)), 'ssl' => array('verify_peer' => false, 'verify_peer_name' => false));
$DD_result = file_get_contents('https://digidargah.com/action/ws/request_status', false, stream_context_create($DD_options));
$DD_result = json_decode($DD_result, true);
print_r($DD_result);
$DD_options = array( 'http' => array('method' => 'POST', 'header' => 'Content-Type: application/x-www-form-urlencoded', 'timeout' => 10, 'content' => http_build_query($DD_params)), 'ssl' => array('verify_peer' => false, 'verify_peer_name' => false));
$DD_result = file_get_contents('https://digidargah.com/action/ws/request_status', false, stream_context_create($DD_options));
$DD_result = json_decode($DD_result, true);
print_r($DD_result);
در صورتی که داده های ارسالی معتبر باشند، مقداری مشابه زیر برگشت داده می شود.
array('status' => 'success', 'request_id' => '641acb5f88bc1', 'order_id' => '46229791', 'amount_value' => '5000', 'amount_currency' => 'toman');
در صورتی که داده های ارسالی معتبر نباشند و یا خطایی از طرف وب سرویس وجود داشته باشد، مقداری مشابه زیر برگشت داده می شود.
array('status' => 'failed', 'respond' => 'پیام خطا با ذکر جزئیات مرتبط با اطلاعات نامعتبری که ارسال شده است.');