پرداخت تضمینی

در صورتی که کسب‌و‌کار شما بصورتی است که پذیرنده شما باید برای دریافت پول ابتدا ضمانت انجام کاری را بدهد، این سرویس به شما کمک می‌کند تا پول را بصورت مسدود شده ثبت کنید تا کاربر نتواند تسویه کند و پس از انجام تعهد خود از طریق فراخوانی متد رفع مسدودی پول را از حالت مسدود در آورده و به کاربر اجازه تسویه بدهید.

فرآیند پرداخت بر روی درگاه‌های اینترنتی 4 مرحله دارد :

ساخت پرداخت : مشخصات پرداختی که می خواهد انجام شود را مانند مبلغ پرداخت و redirectUrl که آدرسی از سایت شماست که کاربر پس از پرداخت باید به آن هدایت شود را مشخص می کنید و در قبال آن یک code دریافت می کنید
هدایت به درگاه : کاربر را بهمراه کدی که در مرحله قبلی دریافت شده است به آدرس درگاه redirect می‌کنید
برگشت از درگاه بانکی (تکمیل فرایند پرداخت) : پس از اینکه پرداخت توسط کاربر انجام شد، کاربر را به همراه یک refid که کد تراکنش است به آدرس redirectUrl شما ارسال می کنیم و شما باید از طرف سرور خودتان آن شماره پرداخت را تایید کنید
تایید پرداخت در این مرحله باید refid را به همراه مبلغ تراکنش به متد تایید پرداخت ارسال کرده و فرایند پرداخت را نهایی نمایید

برای انجام یک پرداخت کامل نیاز است حتما هر ۳ مرحله انجام شود. در صورتی که مرحله سوم یعنی تایید پرداخت تا ۱۵ دقیقه پس از پرداخت مشتری انجام نشود پول به حساب آنها برگشت داده می‌شود

ذخیره شناسه لاگ پی‌پینگ برای پشتیبانی بهتر

در هر درخواست REST که به پی‌پینگ ارسال می‌کنید در پاسخ هر کدام هدری با نام X-PayPingRequest-ID وجود دارد که در صورت ذخیره کردن این شناسه در دیتابیس خود می‌توانید در صورت وجود مشکل با دادن این شناسه به پشتیبانی فنی بهتر کمک کنید. نمونه آن در عکس زیر در POSTMAN نشان داده شده است.



پرداخت مسدود شده

برای ساخت یک پرداخت مسدود شده می‌توانید از فرآیند زیر استفاده کنید :

1. ساخت پرداخت مسدود شده

برای ساخت پرداخت می‌بایست از متد POST /v2/pay/BlockMoney استفاده کنید.

آدرس مستند

در پاسخ این متد code را دریافت می‌کنید

{
"code": "xxxx"
}


2. هدایت کاربر به درگاه

کدی در مرحله قبل دریافت کرده‌اید را بصورت زیر در url اضافه کنید و کاربر را به آدرس زیر Redirect کنید

https://api.payping.ir/v2/pay/gotoipg/{code}

3. برگشت از درگاه بانکی (تکمیل فرایند پرداخت)

پس از پرداخت، اطلاعات پرداخت به آدرس returnUrl که در مرحله اول (ساخت پرداخت) مشخص شده است در بدنه درخواست بصورت زیر فرستاده می‌شود :‌

curl --location --request POST 'returnUrl' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'code=' \
--data-urlencode 'refid=' \
--data-urlencode 'clientrefid=' \
--data-urlencode 'cardnumber=' \
--data-urlencode 'cardhashpan='


4. تایید پرداخت

شما با استفاده از متد POST /v2/pay/verify و ارسال refid پرداخت را تایید می‌کنید

curl -X POST /https://api.payping.ir/v2/pay/verify \
-H 'Accept: application/json' \
-H 'Authorization: bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"refId": "string",
"amount": int
}'


در پاسخ این متد ViewModel زیر را دریافت می‌کنید

{
"amount": مبلغ,
"cardNumber": شماره کارت ماسک شده,
"cardHashPan": مقدار شماره کارت هش شده,
"merchants": [
{
"amount": مبلغ,
"code": کد پرداخت,
"userName": نام کاربری
}
]
}


هر درگاه ممکن است شماره ماسک شده کارت و یا هش شماره کارت پرداخت کننده را در اختیار شما قراردهند. بنابراین حتما در صورتی که چک کردن شماره کارت برای شما اهمیت دارد هر ۲ پارامتر را چک کنید تا در صورت نبود یک مورد با پارامتر دیگر اطمینان حاصل کنید

رفع مسدودی

برای خارج کردن پول از حالت مسدود شده باید از متد POST /v2/pay/UnBlockMoney و با ارسال code پرداخت ،آن پرداخت را از بلوکه در بیاورید.

در صورت داشتن هرگونه سوال و نیاز به راهنمایی ، با پشتیبانی آنلاین سایت پی‌پینگ در ارتباط باشید.
این مقاله مفید بود؟
لغو
خیلی ممنون!