Payment-v3

تایید نهایی پرداخت-نسخه 3

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

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

در صورت دریافت کدهای وضعیت 202 یا 502، عملیات تأیید تراکنش هنوز در حال پردازش است. در این حالت از تلاش برای پرداخت مجدد خودداری کنید و متد Verify را مجدداً فراخوانی نمایید تا نتیجه نهایی تراکنش دریافت شود.

در صورتی که پاسخ 409 دریافت کردید و مقدار 'metaData.code' برابر با 110 باشد، به معنای این است که تراکنش قبلاً وریفای شده است و نیازی به تأیید مجدد ندارد.

post/v3/pay/verify

Request

  • Base URL: https://api.payping.ir
  • URL: https://api.payping.ir/v3/pay/verify
  • 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)

Request body

paymentRefIdinteger required

کد رهگیری پرداخت (در مرحله ارسال اطلاعات پرداخت برای پذیرنده ارسال شده است)

paymentCodestring required

کد پرداخت

amountinteger required

مبلغ دستور پرداخت

Response

Success

amountinteger

مبلغ دستور پرداخت

cardNumberstring nullable

شماره کارت پرداخت کننده

cardHashPanstring nullable

شماره کارت هش شده پرداخت کننده

clientRefIdstring nullable

شناسه ارجاع پذیرنده

paymentRefIdinteger

کد رهگیری پرداخت

codestring nullable

کد پرداخت

payedDatestring nullable

تاریخ و ساعت پرداخت (UTC)

payerWageinteger

مبلغ کارمزد پرداخت کننده

businessWageinteger

مبلغ کارمزد پذیرنده

gatewayAmountinteger

مبلغ نهایی پرداخت

paypingVatinteger

مبلغ مالیات بر ارزش افزوده (Value-Added Tax)

Changes

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