Payment-v3

ارسال اطلاعات پرداخت به پذیرنده

این متد بصورت خودکار پس از بازگشت از درگاه فراخوانی می شود و نیاز به فراخوانی از سمت پذیرنده نمی باشد.

پس از اتمام فرایند در این متد، اطلاعات پرداخت به آدرس ReturnUrl که در مرحله اول (ساخت پرداخت) مشخص شده است در بدنه درخواست بصورت POST ("Content-Type": "application/x-www-form-urlencoded") ارسال می شود.

نکته مهم: اگر وضعیت تراکنش موفق بود، پذیرنده میبایست " شناسه ارجاع پذیرنده" یا clientRefId را در پایگاه داده خود جستجو نماید و صحت اطلاعات paymentCode و amount ارسالی از پی‌پینگ را با پایگاه داده خود مقایسه نماید. در صورت بروز هرگونه مغایرت، از ادامه تراکنش صرف نظر نمایید.

نمونه خروجی تولید شده در وضعیت موفق یک پرداخت:

  • status (integer): مقدار '1' به معنی موفق، مقدار '0' به معنی عدم پرداخت
  • errorCode (integer): کد خطای بازگشتی - در صورت موفق بودن پرداخت، خالی است
  • data (Json):
    • clientRefId (string): شناسه ارجاع پذیرنده
    • paymentCode (string): کد پرداخت
    • paymentRefId (int64): کد رهگیری پرداخت - این فیلد تنها در پرداخت موفق ارسال خواهد شد
    • amount (integer): مبلغ دستور پرداخت
    • gatewayAmount (integer): مبلغ نهایی پرداخت
    • cardNumber (string): شماره کارت پرداخت‌کننده - این فیلد تنها در پرداخت موفق ارسال خواهد شد
    • cardHashPan (string): هش کارت پرداخت‌کننده - این فیلد تنها در پرداخت موفق ارسال خواهد شد

ممکن است با توجه به نوع درگاه پرداختی، شماره کارت و شماره کارت هش شده، ارسال نشوند. در این صورت این مقادیر حتما در مرحله تایید نهایی پرداخت ارسال خواهند شد.

post/v3/pay/paid/{refId}/{paymentCode}

Request

  • Base URL: https://api.payping.ir
  • URL: https://api.payping.ir/v3/pay/paid/{refId}/{paymentCode}
  • Auth: one of:
    • API key in header Authorization
    • OAuth 2 (authorization code, authorization URL https://oauth.payping.ir/connect/authorize, token URL https://oauth.payping.ir/connect/token, scopes: profile, email, nationalcode, birthday, shaba, phone, pay:read, pay:write, product:read, product:write, coupon:read, coupon:write, customer:read, customer:write, invoice:read, invoice:write, upload:write, inquiry:bankInquiry, inquiry:identityInquiry, inquiry:facilityInquiry, bnpl:merchantread, bnpl:merchantwrite)

Path parameters

refIdinteger required
paymentCodestring required

Response

Error

typestring nullable
titlestring nullable
statusinteger nullable
detailstring nullable
instancestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.