ثبت‌نام کاربر در پی‌پینگ از طریق وب‌سرویس

 آموزش ارسال اطلاعات کاربر و ثبت نام در پی‌پینگ

برای استفاده از این سرویس باید دسترسی به آن از طریق پشتیبانی پی‌پینگ به توکن شما داده شود.

اگر کاربر پلتفرم شما در پی‌پینگ اکانت ندارد و اطلاعات آنها سمت شما موجود می‌باشد، می‌توانید با استفاده از فرآیند زیر اطلاعات آنها را برای ثبت‌نام سمت پی‌پینگ بفرستید تا با تایید خود کاربر ثبت‌نام آنها به روش ساده‌تری انجام شود:

1. چک کردن وجود کاربر در پی‌پینگ:

برای چک کردن اینکه آیا کاربر شما در پی پینگ اکانت دارد از API زیر استفاده کنید:

curl -X GET
'https://oauth.payping.ir/v1/client/EmailExist?Email={EMAIL}'
'H 'Authorization: Bearer {TOKEN}-

پاسخ این متد بشکل زیر است:

}


Exist" : true/false"


{

2. ارسال اطلاعات کاربر و در یافت کد ثبت نام:

اگر در مرحله قبل جواب false برگشت داده شد به این معنا است که کاربر در پی پینگ اکانت ندارد و شما می توانید با API زیر هر مشخصاتی از کاربر که دارید ارسال کنید:

curl -X POST https://oauth.payping.ir/v1/client/ClientRegisterInit
'H 'Accept: application/json-
'H 'Authorization: Bearer {TOKEN}-
'H 'Content-Type: application/json-
 } d- 
 ,"clientId": "string"
 ,"returnUrl": "string"
 ,"email": "string"
 ,"userName": "string"
 ,"phoneNumber": "string"
 ,"firstName": "string"
 ,"lastName": "string"
 ,"fatherName": "string"
 ,"nationalCode": "string"
 ,"birthCertificateNumber": "string"
 ,"birthDay": "2024-04-29T09:12:58.835Z"
 درصورتی که کسب و کار به صورت رسمی ثبت شده باشد//,"isLegal": true
 ,"companyName": "string"
 ,"businessDescription": "string"
 ,"registrationDate": "2024-04-29T09:12:58.835Z"
 ,"taxCode": "string"
 اگر  کسب و کار به صورت رسمی ثبت شده باشد (شناسه ملی شرکت)//,"nationalLegalCode": "string"
 شماره ثبت //,"sabtNumber": "string"
 ,"economicCode": "string"
 ,"site": "string"
 ," address": "string"
 ,"postalCode": "string"
 ,"localPhone": "string"
{

پاسخ این متد بشکل زیر است:

  } 
"Id" : "YOUR_REGISTER_ID"
 {

* `ReturnUrl` : آدرس صفحه‌ای که کاربر پس از ثبت نام به آن فرستاده می‌شود تا سرویس شما بلافاصله کاربر را به صفحه oAuth برای دریافت توکن هدایت کند.

توجه: در نظر داشته باشید جهت فعال شدن درگاه پرداخت توسط سامانه شاپرک، می‌بایست اطلاعات “کد پستی، شماره تلفن ثابت، کد ملی و تاریخ تولد ” وارد شده در حساب کاربری پی‌پینگ شما برابر با همین اطلاعات هنگام دریافت کد مالیاتی باشد. چنانچه حتی یکی از این موارد مشابه نباشد، ترمینال شما توسط سامانه شاپرک تایید نخواهد شد.

3. ارسال کاربر به پی پینگ:
در جواب مرحله ی قبل یک کد به شما بازگردانده می شود که باید کاربر را به آدرس زیر Redirect کنید.

https://oauth.payping.ir/Client/ClientRegister?registerId=YOUR_REGISTER_ID

4. پس از ارسال کاربر به این صفحه و ثبت کلمه عبور پنل پی‌پینگ خودش، کاربر به آدرس ReturnUrl داده شده شما برمی‌گردد.
معمولا برای سناریوهای زیادی نیاز هست بعد از ثبت‌نام برای آن کاربر توکن oauth دریافت شود، پس آدرس ReturnUrl شما باید شروع کننده فرآیند oauth برای کاربر مذکور باشد.

 خارج شدن از حساب کاربری پی‌پینگ:

برای اینکه پذیرندگان شما بتوانند از اکانت پی‌پینگ خود خارج بشوند(لاگ اوت کنند)، می‌توانید از متد زیر استفاده کنید:

به ورودی این متد، مقدار client id خود و در هدر درخواست هم توکن را قرار دهید.

https://api.payping.ir/v1/user/RevokeToken?clientid={CLIENT_ID}

Authorization: bearer {TOKEN}

 

 

مشاهده موجودی حساب کاربری:

می‌توانید از متد زیر جهت مشاهده موجودی حساب کاربری استفاده کنید:

Request URL: https://api.payping.ir/v1/report/Balance

[GET]

در صورت داشتن هرگونه سوال و نیاز به راهنمایی ، با پشتیبانی آنلاین سایت پی‌پینگ در ارتباط باشید.

به روز شده در: 1403/02/11