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

با نحوه ادغام برنامه‌های پرداخت توسط فروشندگان و نحوه عملکرد تراکنش‌های پرداخت با Payment Request API آشنا شوید.

میاناهای برنامه‌سازی کاربردی Web Payments ویژگی‌های پرداخت اختصاصی هستند که برای اولین‌بار در مرورگر تعبیه شده‌اند. با «پرداخت‌های وب»، ادغام تاجر با برنامه‌های پرداخت ساده‌تر می‌شود و تجربه مشتری ساده‌تر و ایمن‌تر می‌شود.

برای کسب اطلاعات بیشتر درباره مزایای استفاده از Web Payments، به توانمندسازی برنامه‌های پرداخت با Web Payments مراجعه کنید.

این مقاله شما را با تراکنش پرداخت در وب‌سایت فروشنده آشنا می‌کند و کمک می‌کند تا با نحوه عملکرد ادغام برنامه پرداخت آشنا شوید.

این فرایند شامل ۶ مرحله است:

  1. فروشنده تراکنش پرداخت را آغاز می‌کند.
  2. فروشنده دکمه پرداخت را نشان می‌دهد.
  3. مشتری دکمه پرداخت را فشار می‌دهد.

    نموداری از وب‌سایت فروشگاه پنیر با دکمه BobPay (برنامه پرداخت).

  4. مرورگر برنامه پرداخت را راه‌اندازی می‌کند.

    نموداری از وب‌سایت فروشگاه پنیر با برنامه BobPay که در یک مدال راه‌اندازی شده است. این مدال گزینه‌های ارسال و هزینه کل را نشان می‌دهد.

  5. اگر مشتری جزئیاتی را تغییر دهد (مثل گزینه‌های ارسال یا نشانی)، فروشنده جزئیات تراکنش را به‌روز می‌کند تا تغییرات را منعکس کند.

    نموداری که نشان می‌دهد مشتری گزینه ارسال دیگری را در پنجره برنامه BobPay انتخاب می‌کند. نمودار دوم نشان می‌دهد که فروشنده هزینه کل نمایش‌داده‌شده در BobPay را به‌روز می‌کند.

  6. پس‌از اینکه مشتری خرید را تأیید کرد، فروشنده پرداخت را اعتبارسنجی می‌کند و تراکنش را تکمیل می‌کند.

    نموداری که نشان می‌دهد مشتری دکمه

مرحله ۱: فروشنده تراکنش پرداخت را آغاز می‌کند

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

  • روش‌های پرداخت قابل‌قبول و داده‌های آن‌ها برای پردازش تراکنش.
  • جزئیاتی مانند قیمت کل (الزامی) و اطلاعات مربوط به موارد.
  • گزینه‌هایی که فروشندگان می‌توانند اطلاعات ارسال کالا مانند نشانی ارسال کالا و گزینه ارسال کالا را درخواست کنند.
  • فروشندگان همچنین می‌توانند نشانی صورت‌حساب، نام پرداخت‌کننده، ایمیل، و شماره تلفن را درخواست کنند.
  • فروشندگان همچنین می‌توانند نوع ارسال اختیاری (shipping، delivery، یا pickup) را در PaymentRequest اضافه کنند. برنامه پرداخت می‌تواند از آن به‌عنوان راهنمایی برای نمایش برچسب‌های صحیح در واسط کاربر خود استفاده کند.
const request = new PaymentRequest([{
  supportedMethods: 'https://bobpay.xyz/pay',
  data: {
    transactionId: '****'
  }
}], {
  displayItems: [{
    label: 'Anvil L/S Crew Neck - Grey M x1',
    amount: { currency: 'USD', value: '22.15' }
  }],
  total: {
    label: 'Total due',
    amount: { currency: 'USD', value : '22.15' }
  }
}, {
  requestShipping: true,
  requestBillingAddress: true,
  requestPayerEmail: true,
  requestPayerPhone: true,
  requestPayerName: true,
  shippingType: 'delivery'
});
شامل شناسه تراکنش

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

فروشنده می‌تواند شناسه تراکنش را به‌عنوان بخشی از ویژگی data شیء PaymentMethodData ارسال کند.

با ارائه اطلاعات تراکنش، مرورگر فرایند کشف برنامه‌های پرداخت مشخص‌شده در PaymentRequest را براساس شناسه‌های روش پرداخت طی می‌کند. به‌این‌ترتیب، مرورگر می‌تواند برنامه پرداخت را برای راه‌اندازی تعیین کند به‌محض اینکه فروشنده آماده ادامه تراکنش باشد.

برای آشنایی با جزئیات نحوه عملکرد فرایند شناسایی، راه‌اندازی روش پرداخت را بررسی کنید.

مرحله ۲: فروشنده دکمه پرداخت را نشان می‌دهد

فروشندگان می‌توانند از روش‌های پرداخت متعددی پشتیبانی کنند، اما باید فقط دکمه‌های پرداخت را برای روش‌هایی ارائه دهند که مشتری واقعاً می‌تواند از آن‌ها استفاده کند. نشان دادن دکمه پرداختی که قابل‌استفاده نیست تجربه کاربری بدی است. اگر فروشنده بتواند پیش‌بینی کند که روش پرداخت مشخص‌شده در شیء PaymentRequest برای مشتری کار نخواهد کرد، می‌تواند راه‌حل جایگزینی ارائه دهد یا اصلاً آن دکمه را نشان ندهد.

بااستفاده از نمونه PaymentRequest، فروشنده می‌تواند پرس‌وجو کند که آیا مشتری برنامه پرداخت را دردسترس دارد یا نه.

آیا برنامه پرداخت برای مشتری دردسترس است؟

اگر برنامه پرداخت در دستگاه مشتری دردسترس باشد، روش canMakePayment() PaymentRequest مقدار true را برمی‌گرداند. «دردسترس» یعنی برنامه پرداختی که از روش پرداخت پشتیبانی می‌کند پیدا شده است و برنامه پرداخت مختص پلاتفرم نصب شده است یا برنامه پرداخت مبتنی بر وب آماده ثبت شدن است.

const canMakePayment = await request.canMakePayment();
if (!canMakePayment) {
  // Fallback to other means of payment or hide the button.
}

مرحله ۳: مشتری دکمه پرداخت را فشار می‌دهد

وقتی مشتری دکمه پرداخت را فشار می‌دهد، فروشنده روش show() نمونه PaymentRequest را فراخوانی می‌کند که بلافاصله راه‌اندازی رابط کاربری پرداخت را راه‌اندازی می‌کند.

درصورتی‌که قیمت کل نهایی به‌صورت پویا تنظیم شود (برای مثال، از سرور بازیابی شود)، فروشنده می‌تواند راه‌اندازی میانای کاربری پرداخت را تا زمانی که کل مبلغ مشخص شود به‌تعویق بیندازد.

به‌تعویق انداختن راه‌اندازی واسط کاربر پرداخت

نمونه نمایشی به‌تعویق انداختن پرداخت تا زمانی که قیمت نهایی تعیین شود را بررسی کنید.

برای به‌تعویق انداختن واسط کاربر پرداخت، فروشنده یک Promise به روش show() ارسال می‌کند. مرورگر تا زمانی که وعده حل شود و تراکنش آماده شروع باشد، نشانگر بارگیری را نشان می‌دهد.

const getTotalAmount = async () => {
  // Fetch the total amount from the server, etc.
};

try {
  const result = await request.show(getTotalAmount());
  // Process the result…
} catch(e) {
  handleError(e);
}

اگر هیچ قولی به‌عنوان آرگومان برای show() مشخص نشده باشد، مرورگر فوراً واسط کاربری پرداخت را راه‌اندازی خواهد کرد.

مرحله ۴: مرورگر برنامه پرداخت را راه‌اندازی می‌کند

مرورگر می‌تواند برنامه پرداخت مبتنی بر وب یا مختص پلاتفرم را راه‌اندازی کند. (می‌توانید درباره نحوه تعیین برنامه پرداخت برای راه‌اندازی توسط Chrome بیشتر بدانید.)

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

وقتی برنامه پرداخت راه‌اندازی می‌شود، اطلاعات تراکنش را که در مرحله ۱ به شیء PaymentRequest ارسال شده است دریافت می‌کند. این اطلاعات شامل موارد زیر است:

  • داده‌های روش پرداخت
  • قیمت کلی
  • گزینه‌های پرداخت

برنامه پرداخت از اطلاعات تراکنش برای برچسب‌گذاری واسط کاربر خود استفاده می‌کند.

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

مشتریان می‌توانند جزئیات تراکنش مثل روش پرداخت و گزینه ارسال را در برنامه پرداخت تغییر دهند. وقتی مشتری تغییرات را اعمال می‌کند، فروشنده رویدادهای تغییر را دریافت می‌کند و جزئیات تراکنش را به‌روز می‌کند.

چهار نوع رویداد وجود دارد که فروشنده می‌تواند دریافت کند:

  • رویداد تغییر روش پرداخت
  • رویداد تغییر نشانی ارسال کالا
  • رویداد تغییر گزینه ارسال کالا
  • رویداد اعتبارسنجی فروشنده

رویداد تغییر روش پرداخت

برنامه پرداخت می‌تواند از چندین روش پرداخت پشتیبانی کند و فروشنده ممکن است بسته به انتخاب مشتری، تخفیف ویژه‌ای ارائه دهد. برای پوشش دادن این مورد استفاده، رویداد تغییر روش پرداخت می‌تواند روش پرداخت جدید را به فروشنده اطلاع دهد تا او بتواند قیمت کل را با تخفیف به‌روز کند و آن را به برنامه پرداخت برگرداند.

request.addEventListener('paymentmethodchange', e => {
  e.updateWith({
    // Add discount etc.
  });
});

رویداد تغییر نشانی ارسال کالا

برنامه پرداخت می‌تواند به‌صورت اختیاری نشانی ارسال کالا را برای مشتری ارائه دهد. این کار برای مشتریان راحت است زیرا لازم نیست جزئیات را به‌صورت دستی در فرم وارد کنند و می‌توانند نشانی ارسال کالا را به‌جای چندین وب‌سایت فروشنده مختلف، در برنامه‌های پرداخت دلخواهشان ذخیره کنند.

اگر مشتری نشانی ارسال کالا را در برنامه پرداخت پس‌از شروع تراکنش به‌روز کند، رویداد 'shippingaddresschange' به فروشنده ارسال خواهد شد. این رویداد به فروشنده کمک می‌کند هزینه ارسال را براساس نشانی جدید تعیین کند، قیمت کل را به‌روز کند، و آن را به برنامه پرداخت برگرداند.

request.addEventListener('shippingaddresschange', e => {
  e.updateWith({
    // Update the details
  });
});

اگر فروشنده نتواند به نشانی به‌روزشده ارسال کند، می‌تواند با افزودن پارامتر خطا به جزئیات تراکنش برگردانده‌شده به برنامه پرداخت، پیام خطا ارائه دهد.

رویداد تغییر گزینه ارسال کالا

فروشنده می‌تواند چندین گزینه ارسال به مشتری ارائه دهد و می‌تواند این انتخاب را به برنامه پرداخت واگذار کند. گزینه‌های ارسال به‌صورت فهرستی از قیمت‌ها و نام‌های سرویس نمایش داده می‌شود که مشتری می‌تواند از بین آن‌ها انتخاب کند. برای مثال:

  • ارسال معمولی - رایگان
  • ارسال سریع - ۵ دلار امریکا

وقتی مشتری گزینه ارسال را در برنامه پرداخت به‌روز می‌کند، رویداد 'shippingoptionchange' به فروشنده ارسال می‌شود. سپس فروشنده می‌تواند هزینه ارسال را تعیین کند، قیمت کل را به‌روز کند، و آن را به برنامه پرداخت برگرداند.

request.addEventListener('shippingoptionchange', e => {
  e.updateWith({
    // Update the details
  });
});

فروشنده می‌تواند گزینه‌های ارسال کالا را به‌طور پویا براساس نشانی ارسال کالا مشتری نیز تغییر دهد. این ویژگی زمانی مفید است که فروشنده بخواهد مجموعه‌های مختلفی از گزینه‌های ارسال را برای مشتریان داخلی و بین‌المللی ارائه دهد.

رویداد اعتبارسنجی فروشنده

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

request.addEventListener('merchantvalidation', e => {
  e.updateWith({
    // Use `e.validateURL` to validate
  });
});

مرحله ۶: فروشنده پرداخت را اعتبارسنجی می‌کند و تراکنش را تکمیل می‌کند

وقتی مشتری پرداخت را باموفقیت مجاز می‌کند، روش show() یک promise برمی‌گرداند که به PaymentResponse تبدیل می‌شود. شیء PaymentResponse شامل اطلاعات زیر است:

  • جزئیات نتیجه پرداخت
  • نشانی ارسال کالا
  • گزینه ارسال کالا
  • اطلاعات تماس

در این مرحله، میانای کاربری مرورگر ممکن است همچنان نشانگر بار کردن را نشان دهد که یعنی تراکنش هنوز تکمیل نشده است.

اگر برنامه پرداخت به‌دلیل خطا یا عدم موفقیت در پرداخت متوقف شود، promise برگردانده‌شده از show() رد می‌شود و مرورگر تراکنش پرداخت را متوقف می‌کند.

درحال پردازش و اعتبارسنجی پرداخت

details در PaymentResponse شیء اطلاعات کاربری پرداخت است که از برنامه پرداخت برگردانده شده است. فروشنده می‌تواند از این اطلاعات کاربری برای پردازش یا اعتبارسنجی پرداخت استفاده کند. نحوه عملکرد این فرایند حیاتی به گرداننده پرداخت بستگی دارد.

درحال تکمیل یا امتحان مجدد تراکنش

پس‌از اینکه فروشنده تعیین کرد تراکنش موفق بوده است یا ناموفق، می‌تواند یکی از کارهای زیر را انجام دهد:

  • برای تکمیل تراکنش و بستن نشانگر بار کردن، روش .complete() را فراخوانی کنید.
  • با فراخوانی روش retry()، به مشتری اجازه دهید دوباره امتحان کند.
async function doPaymentRequest() {
  try {
    const request = new PaymentRequest(methodData, details, options);
    const response = await request.show();
    await validateResponse(response);
  } catch (err) {
    // AbortError, SecurityError
    console.error(err);
  }
}

async function validateResponse(response) {
  try {
    const errors = await checkAllValuesAreGood(response);
    if (errors.length) {
      await response.retry(errors);
      return validateResponse(response);
    }
    await response.complete("success");
  } catch (err) {
    // Something went wrong…
    await response.complete("fail");
  }
}
// Must be called as a result of a click
// or some explicit user action.
doPaymentRequest();

مراحل بعدی