چطور می توانیم کمکتان کنیم؟
Generic selectors
جستجو
جستجو در عنوان
جستجو در محتوا
Post Type Selectors
ثبت‌نام کاربر در پی‌پینگ از طریق وب‌سرویس


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

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

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

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-
,"UserName": "string"
اجباری//  ,"Email": "string" 
,"FirstName": "string"
,"LastName": "string"
,"PhoneNumber": "string"
,"NationalCode": "string"
,"BirthDay": "2000-02-02"
,"Sheba": "string"
اجباری//  ,"ReturnUrl": "[AuthorizationUrl]"
,"Address": "string"
,"PostalCode": "2315468970"
,"LocalPhone": "05138420884"
,"TaxCode": "9876543210"
اگر کسب و کار به صورت رسمی ثبت شده است//  ,"IsOfficialSubmited": true" 
شناسه ملی شرکت(در صورت رسمی ثبت شدن اجباری) //  ,"BNationalCode": "18564852364"
شماره ثبت//  ,"SabtNumber": "668751" 
کد اقتصادی//  ,"EconomicCode": "57654" 
 { '

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



  } 
"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]



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