การเปลี่ยนแปลงใน API คำขอการชำระเงิน

Chrome 62

PaymentDetailsModifier เผยแพร่แล้ว

ในคำขอการชำระเงิน อาจมีกรณีที่คุณต้องการให้ส่วนลดหรือเรียกเก็บค่าบริการเพิ่มเติม ทั้งนี้ขึ้นอยู่กับวิธีการชำระเงินที่ลูกค้าเลือก PaymentDetailsModifier คือฟีเจอร์ที่คุณใช้เพื่อดำเนินการนี้ได้

เพิ่มพร็อพเพอร์ตี้ modifiers ลงในอาร์กิวเมนต์ที่ 2 ของคอนสตรักเตอร์ PaymentRequest พร้อมกับอาร์เรย์ของออบเจ็กต์ PaymentDetailsModifier ซึ่งเป็นกฎเชิงประกาศเกี่ยวกับวิธีแก้ไขรายการที่แสดงและยอดรวมโดยขึ้นอยู่กับวิธีการชำระเงินที่ลูกค้าเลือก

ตัวอย่างต่อไปนี้แสดงวิธีประกาศว่าผู้ใช้จะถูกเรียกเก็บค่าดำเนินการ $3 สำหรับการเลือกชำระเงินด้วยบัตรเครดิต

let methods = [{
 supportedMethods: 'basic-card',
 data: {
   supportedNetworks: ['visa', 'mastercard']
   supportedTypes: ['credit', 'debit']
 }
}];

let details = {
 displayItems: [{
   label: 'T-shirt',
   amount: { currency: 'USD', value: '68.00' }
 }],
 total: {
   label: 'Total price',
   amount: { currency: 'USD', value: '68.00' }
 },
 modifiers: [{
   supportedMethods: 'basic-card',
   data: {
     supportedTypes: ['credit']
   },
   additionalDisplayItems: [{
     label: 'Processing fee',
     amount: { currency: 'USD', value: '3.00' }
   }],
   total: {
     label: 'Credit card price',
     amount: {currency: ‘USD’, value: ‘71.00’}}
 }]
};

let options = {};

let request = new PaymentRequest(methods, details, options);

ในชีตคำขอการชำระเงินจริง ทันทีที่เลือกการชำระเงินด้วยบัตรเครดิต ผู้ใช้จะเห็นรายการที่แสดงเพิ่มเติมชื่อ "ค่าดำเนินการ" ซึ่งมีค่าใช้จ่าย $3 โดยมีราคารวม $71.00

PaymentDetailsModifier มีพารามิเตอร์ต่อไปนี้

ชื่อพร็อพเพอร์ตี้
supportedMethods ระบุวิธีการชำระเงินที่ใช้กฎนี้
additionalDisplayItems รายการที่แสดงเพิ่มเติมซึ่งคุณต้องการเพิ่มส่วนลดหรือค่าใช้จ่ายเพิ่มเติม
total ราคารวมหลังจากเพิ่ม additionalDisplayItems
data สำหรับการชำระเงิน basic-card ระบบจะใช้ข้อมูลนี้เป็นวิธีกรองประเภทบัตรที่เฉพาะเจาะจงด้วย supportedTypes มิฉะนั้น การใช้พารามิเตอร์นี้จะขึ้นอยู่กับวิธีการชำระเงิน (แอปการชำระเงิน) โปรดดูเอกสารประกอบที่วิธีการชำระเงินแต่ละวิธีมีให้

เมื่อมีตัวเลือกการจัดส่ง สิ่งต่างๆ จะซับซ้อนขึ้นเล็กน้อย เนื่องจากราคารวมของ modifiers ไม่สามารถเป็นค่าคงที่และต้องมีการแก้ไขแบบไดนามิก

เพื่อให้บรรลุเป้าหมายนี้ คุณจะต้องแก้ไข additionalDisplayItems และ total ของพร็อพเพอร์ตี้ modifiers เมื่อเกิดเหตุการณ์ shippingaddresschange และ shippingoptionchange เช่นเดียวกับที่คุณทำกับพร็อพเพอร์ตี้ displayItems ของออบเจ็กต์ PaymentDetails

ตอนนี้พร็อพเพอร์ตี้ supportedMethods จะใช้สตริง

พร็อพเพอร์ตี้ supportedMethods ในออบเจ็กต์ PaymentMethodData (อาร์กิวเมนต์แรกของคอนสตรักเตอร์ PaymentRequest) ได้รับอาร์เรย์ของสตริงที่ระบุวิธีการชำระเงิน ตอนนี้ระบบจะใช้สตริงเดียวเป็นอาร์กิวเมนต์

โปรดทราบว่าการระบุอาร์เรย์จะยังคงใช้งานได้ในขณะนี้

ไม่ควรทำ

เก่า - ยังคงใช้งานได้ในขณะนี้

var methodData = [{
     supportedMethods: ['basic-card'],
     data: {
       supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
         'diners', 'discover', 'mir', 'unionpay']
     }
}, {
    supportedMethods: ['https://bobpay.xyz']
}];
ควรทำ

ใหม่ - วิธีใหม่

var methodData = [{
     supportedMethods: 'basic-card',
     data: {
       supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
         'diners', 'discover', 'mir', 'unionpay']
     }
}, {
    supportedMethods: 'https://bobpay.xyz'
}];

Chrome 61

supportedTypes ในการ์ดพื้นฐานพร้อมใช้งานแล้ว

เมื่อ supportedMethods เป็น "basic-card" คุณจะระบุ supportedTypes เพื่อระบุประเภทบัตรที่รองรับระหว่าง "credit" "debit" และ "prepaid" ได้แล้ว

var methodData = [{
 supportedMethods: 'basic-card',
 data: {
   supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
     'diners', 'discover', 'mir', 'unionpay']
   supportedTypes: ['credit', 'debit', 'prepaid']
 }
}];

โปรดตรวจสอบประเภทบัตรกับ Payment Gateway อีกครั้ง เนื่องจากการกรองนี้อาจทำงานได้ไม่สมบูรณ์ ทั้งนี้ขึ้นอยู่กับแหล่งที่มา

Chrome 57

ตอนนี้ PaymentRequest พร้อมใช้งานภายใน iframe แล้ว

ตอนนี้คุณสามารถเรียกใช้ Payment Request API จากภายใน iframe ได้โดยเพิ่มแอตทริบิวต์ allowpaymentrequest ลงในองค์ประกอบ iframe

<iframe src="/totally/fake/url" allowpaymentrequest></iframe>

PaymentMethodData รองรับ "basic-card"

อาร์กิวเมนต์แรกของคอนสตรักเตอร์ PaymentRequest() คืออาร์เรย์ของข้อมูลวิธีการชำระเงิน มีการเปลี่ยนแปลงรูปแบบ PaymentMethodData ในรุ่นนี้

ไม่ควรทำ

เก่า - ยังคงใช้งานได้ในขณะนี้

var methodData = [{
     supportedMethods: ['visa', 'mastercard', 'amex', 'jcb']
}];
var request = new PaymentRequest(methodData, details, options);
ควรทำ

ใหม่ - โครงสร้างใหม่

var methodData = [{
     supportedMethods: ['basic-card'],
     data: {
       supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
         'diners', 'discover', 'mir', 'unionpay']
     }
}];
var request = new PaymentRequest(methodData, details, options);

รูปแบบของพร็อพเพอร์ตี้ data ขึ้นอยู่กับค่าใน supportedMethods และอิงตามข้อกำหนดของ Basic Card โปรดทราบว่าข้อกำหนดมี supportedTypes ซึ่งยอมรับ credit, debit หรือ prepaid แต่ Chrome 57 จะละเว้นพร็อพเพอร์ตี้นี้และถือว่าค่าใดๆ ใน supoprtedNetworks เป็นบัตรเครดิต

var methodData = [{
     supportedMethods: ['basic-card'],
     data: {
       supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
         'diners', 'discover', 'mir', 'unionpay'],
       supportedTypes: ['credit'] <= not available
     }
}];

Chrome 56

รอดำเนินการ

ในส่วนข้อมูลรายการการชำระเงิน นักพัฒนาแอปสามารถเพิ่ม pending เพื่อระบุว่าราคายังไม่แน่นอน ช่อง pending ยอมรับค่าบูลีน

    {
      label: "State tax",
      amount: { currency: "USD", value : "5.00" },
      pending: true
    },

ซึ่งมักใช้เพื่อแสดงบรรทัดรายการ เช่น จำนวนเงินค่าจัดส่งหรือภาษีที่ขึ้นอยู่กับการเลือกที่อยู่สำหรับจัดส่งหรือตัวเลือกการจัดส่ง Chrome จะระบุช่องที่รอดำเนินการใน UI สำหรับคำขอการชำระเงิน

requestPayerName

ในส่วนของตัวเลือกการจัดส่ง (อาร์กิวเมนต์ที่ 3 สำหรับ PaymentRequest) ตอนนี้นักพัฒนาแอปสามารถเพิ่ม requestPayerName เพื่อขอชื่อผู้ชำระเงินแยกจากข้อมูลที่อยู่สำหรับจัดส่งได้แล้ว requestPayerName ยอมรับค่าบูลีน

shippingType

ในส่วนของตัวเลือกการจัดส่ง (อาร์กิวเมนต์ที่ 3 สำหรับ PaymentRequest) ตอนนี้นักพัฒนาแอปสามารถเพิ่ม shippingType เพื่อขอให้ UI แสดง "การนำส่ง" หรือ "การรับสินค้า" แทน "การจัดส่ง" ได้แล้ว shippingType ยอมรับสตริง shipping (ค่าเริ่มต้น), delivery หรือ pickup

shippingType='delivery'
shippingType="delivery"
shippingType='pickup'
shippingType="pickup"

ฟังก์ชัน Serializer พร้อมใช้งานสำหรับ PaymentResponse และ PaymentAddress

ตอนนี้ออบเจ็กต์ PaymentResponse และออบเจ็กต์ PaymentAddress สามารถแปลงเป็น JSON ได้แล้ว นักพัฒนาแอปสามารถแปลงสตริงเป็นออบเจ็กต์ JSON ได้โดยเรียกใช้ฟังก์ชัน toJSON() และหลีกเลี่ยงการสร้างฟังก์ชัน toDict() ที่ยุ่งยาก

request.show().then(response => {
     let res = response.toJSON();
});

canMakePayment

นอกเหนือจากความพร้อมใช้งานของ API แล้ว คุณยังตรวจสอบได้ว่าผู้ใช้มีวิธีการชำระเงินที่ใช้งานอยู่หรือไม่ก่อนที่จะเรียกใช้ Payment Request API โปรดทราบว่าขั้นตอนนี้เป็นขั้นตอนที่ไม่บังคับ เนื่องจากผู้ใช้ยังคงเพิ่มวิธีการชำระเงินใหม่ใน UI การชำระเงินได้

let request = new PaymentRequest(methods, details, options);
if (request.canMakePayment) {
     request.canMakePayment().then(result => {
       if (result) {
         // Payment methods are available.
       } else {
         // Payment methods are not available, but users can still add
        // a new payment method in Payment UI.
       }
     }).catch(error => {
       // Unable to determine.
     });
}