راهنمای جامع تراکنش با API درگاه پرداخت نکست پی
ایجاد یک تجربه پرداخت آنلاین روان و امن، یکی از مهمترین عوامل موفقیت هر کسبوکار اینترنتی است. درگاه پرداخت نکست پی با ارائه API قدرتمند و منعطف، این فرآیند را برای توسعهدهندگان بسیار ساده کرده است. در این راهنمای جامع، قصد داریم تمام مراحل تراکنش با API درگاه پرداخت نکست پی را به صورت گامبهگام و با مثالهای عملی بررسی کنیم. پس اگر به دنبال یک راهنمای کامل برای اتصال وبسایت یا اپلیکیشن خود به این درگاه پرداخت هستید، تا انتها همراه ما باشید. 🚀
چرا باید از API درگاه پرداخت نکست پی استفاده کنیم؟
استفاده از وبسرویس پرداخت نکست پی مزایای قابل توجهی برای کسبوکار شما به همراه دارد. این API به گونهای طراحی شده تا فرآیند پرداخت را هم برای شما و هم برای مشتریانتان بهینهسازی کند. در ادامه به برخی از مهمترین مزیتهای آن اشاره میکنیم:
- 💳 یکپارچهسازی آسان: مستندات واضح و فرآیندهای استاندارد، اتصال به این API را بسیار سریع و آسان میکند.
- 🔒 امنیت بسیار بالا: تمام تراکنشها با پروتکلهای امنیتی پیشرفته محافظت میشوند. بنابراین، اطلاعات کاربران شما همیشه در امان خواهد بود.
- 📈 گزارشدهی دقیق: شما به گزارشهای کاملی از وضعیت تراکنشها دسترسی دارید. این موضوع به مدیریت مالی شما کمک شایانی میکند.
- ⚙️ انعطافپذیری بالا: API نکست پی با اکثر زبانهای برنامهنویسی محبوب سازگار است. همچنین امکانات متنوعی برای شخصیسازی فرآیند پرداخت فراهم میکند.
- 📞 پشتیبانی تخصصی: تیم پشتیبانی نکست پی همواره آماده پاسخگویی به سوالات فنی شماست.
پیشنیازهای اتصال به API نکست پی
قبل از شروع کدنویسی، باید چند پیشنیاز اساسی را فراهم کنید. این موارد برای برقراری ارتباط با سرورهای نکست پی ضروری هستند.
- حساب کاربری فعال: شما باید یک حساب کاربری تایید شده در نکست پی داشته باشید.
- کلید API یا
api_key: این کلید شناسایی منحصربهفرد شماست که از پنل کاربری قابل دریافت است. - آدرس بازگشتی یا
callback_uri: یک آدرس در وبسایت شما که کاربر پس از اتمام پرداخت به آنجا هدایت میشود.
مراحل ثبتنام و دریافت کلید API
اگر هنوز کلید API خود را دریافت نکردهاید، فرآیند آن بسیار ساده است. کافی است مراحل زیر را دنبال کنید:
- به وبسایت نکست پی مراجعه کرده و روی گزینه ثبتنام کلیک کنید.
- اطلاعات خواستهشده را تکمیل و حساب کاربری خود را ایجاد نمایید.
- وارد پنل کاربری خود در آدرس
p.api.irشوید. - از بخش مدیریت درگاههای پرداخت، کلید API (
api_key) اختصاصی خود را کپی کنید.
راهنمای ۴ مرحلهای تراکنش با API درگاه پرداخت نکست پی
چرخه کلی یک تراکنش موفق شامل چهار گام اصلی است. این مراحل از درخواست شما شروع شده و با تایید پرداخت به پایان میرسد. بیایید هر مرحله را با جزئیات بررسی کنیم.
گام اول: درخواست توکن پرداخت (ایجاد تراکنش)
این مرحله، نقطه شروع عملیات پرداخت است. در این گام، شما باید اطلاعات اولیه تراکنش را به سرور نکست پی ارسال کنید تا یک شناسه تراکنش (trans_id) یا توکن یکتا دریافت نمایید.
پارامترهای ارسالی:
| نام پارامتر | توضیحات |
|---|---|
api_key | کلید API که از پنل نکست پی دریافت کردهاید. |
order_id | شماره سفارش منحصربهفرد در سیستم شما. |
amount | مبلغ تراکنش به تومان. (عدد صحیح و بزرگتر از ۱۰۰) |
callback_uri | آدرس بازگشتی کاربر پس از پرداخت. |
این پارامترها باید از سمت سرور شما به اندپوینت https://api.nextpay.org/gateway/token.wsdl ارسال شوند.
پاسخ دریافتی:
خروجی شامل دو مقدار کلیدی است:
trans_id: کد یکتای تراکنش که در مراحل بعدی استفاده میشود.code: کد وضعیت. اگر مقدار آن-1باشد، یعنی توکن با موفقیت ایجاد شده است.
💡 نکته مهم: حتماً مقادیر order_id، amount و trans_id را در دیتابیس خود ذخیره کنید. این کار برای پیگیری و اعتبارسنجی تراکنش در آینده ضروری است.
مثال کد PHP برای ایجاد توکن:
<?php
$parameters = [
"api_key" => "YOUR_API_KEY", // کلید API شما
"order_id"=> $order_id,
"amount"=> $price,
"callback_uri"=> "https://your-domain.com/callback.php"
];
$client = new SoapClient('https://api.nextpay.org/gateway/token.wsdl');
$response = $client->TokenGenerator($parameters);
$trans_id = $response->TokenGeneratorResult->trans_id;
$code = $response->TokenGeneratorResult->code;
if ($code == '-1') {
// توکن با موفقیت ساخته شد، کاربر را به درگاه هدایت کنید
} else {
// خطا در ایجاد توکن
}
?>
گام دوم: هدایت کاربر به صفحه پرداخت
پس از دریافت موفقیتآمیز trans_id، باید کاربر را به صفحه پرداخت بانک هدایت کنید. این کار با استفاده از URL زیر انجام میشود:
https://api.nextpay.org/gateway/payment/{trans_id}
کافی است trans_id دریافت شده در مرحله قبل را جایگزین {trans_id} کنید.
مثال برای هدایت کاربر با جاوااسکریپت:
<script>
window.location = 'https://api.nextpay.org/gateway/payment/<?php echo $trans_id; ?>';
</script>گام سوم: تکمیل فرآیند پرداخت توسط مشتری
در این مرحله، کاربر به درگاه پرداخت شاپرک منتقل میشود. او اطلاعات کارت بانکی خود را وارد کرده و پرداخت را تکمیل میکند.
⚠️ توصیه امنیتی: همیشه به کاربران خود یادآوری کنید که آدرس صفحه پرداخت در مرورگر باید حاوی shaparak.ir باشد تا از حملات فیشینگ جلوگیری شود.
گام چهارم: بازگشت کاربر و اعتبارسنجی تراکنش (Verification)
پس از اتمام عملیات در صفحه بانک (موفق یا ناموفق)، کاربر به callback_uri شما بازگردانده میشود. در این مرحله، دو پارامتر trans_id و order_id از طریق متد POST به اسکریپت شما ارسال میشود.
اکنون وظیفه شماست که صحت و موفقیت تراکنش را از سرور نکست پی استعلام بگیرید. این کار برای جلوگیری از هرگونه تقلب یا خطا حیاتی است.
پارامترهای ارسالی برای اعتبارسنجی:
| نام پارامتر | توضیحات |
|---|---|
api_key | کلید API شما. |
order_id | شماره سفارش ارسال شده در مرحله اول. |
amount | مبلغ تراکنش ارسال شده در مرحله اول. |
trans_id | کد تراکنش که از درگاه بازگشته است. |
این پارامترها باید به اندپوینت https://api.nextpay.org/gateway/verify.wsdl ارسال شوند.
پاسخ دریافتی:
خروجی این تابع، یک پارامتر با نام code است.
- اگر
codeبرابر با0باشد، تراکنش موفقیتآمیز بوده است. ✅ - هر مقدار دیگری به معنای ناموفق بودن تراکنش یا وجود خطاست. ❌
مثال کد PHP برای اعتبارسنجی تراکنش:
<?php
$parameters = [
"api_key" => "YOUR_API_KEY", // کلید API شما
"order_id"=> $_POST['order_id'],
"amount"=> $price, // مبلغ را از دیتابیس خود بخوانید
"trans_id"=> $_POST['trans_id']
];
$client = new SoapClient('https://api.nextpay.org/gateway/verify.wsdl');
$response = $client->PaymentVerification($parameters);
$code = $response->PaymentVerificationResult->code;
if ($code == '0') {
// تراکنش موفق بود
// محصول یا خدمات را به کاربر تحویل دهید
echo "پرداخت با موفقیت انجام شد.";
} else {
// تراکنش ناموفق بود
echo "خطا در پرداخت. کد خطا: " . $code;
}
?>
کاربردهای API درگاه پرداخت نکست پی
این API قدرتمند را میتوان در انواع پلتفرمهای آنلاین به کار گرفت. برخی از رایجترین کاربردها عبارتند از:
- 🛒 فروشگاههای اینترنتی: برای فروش محصولات فیزیکی یا دیجیتال.
- 🎓 پلتفرمهای آموزشی: جهت فروش دورههای آنلاین و وبینارها.
- 📅 سیستمهای رزرو آنلاین: برای رزرو هتل، بلیط یا نوبت پزشک.
- ❤️ سایتهای خیریه: برای دریافت کمکهای مالی و دونیت.
- 갱 سرویسهای اشتراکی: جهت دریافت حق عضویت ماهانه یا سالانه.
جمعبندی و اقدام نهایی
همانطور که مشاهده کردید، مراحل تراکنش با API درگاه پرداخت نکست پی در یک چرخه چهار مرحلهای ساده و منطقی خلاصه میشود: درخواست توکن، هدایت به درگاه، پرداخت توسط کاربر و در نهایت، اعتبارسنجی تراکنش. با دنبال کردن این راهنما و استفاده از مثالهای ارائه شده، شما میتوانید به راحتی سیستم پرداخت آنلاین خود را راهاندازی کنید و تجربهای امن و سریع برای مشتریان خود فراهم آورید.
آیا تجربهای در زمینه اتصال به API نکست پی دارید؟ سوالات یا نظرات خود را در بخش دیدگاهها با ما و دیگران به اشتراک بگذارید. خوشحال میشویم به شما کمک کنیم! 👇