ระบบจะกระบวนการชําระเงินเมื่อผู้ใช้สร้างรถเข็น เนื้อหาของรถเข็นของผู้ใช้และรายละเอียดเกี่ยวกับคําสั่งซื้อจะถูกส่งไปยังบริการเว็บของ Order with Google ข้อมูลนี้ได้รับการตรวจสอบโดยบริการบนเว็บของคุณ จากนั้นคุณจะดําเนินการต่อหรือทําการปรับเปลี่ยนรถเข็นได้ตามต้องการ
เครื่องจัดการการชําระเงินสําหรับบริการเว็บของคุณต้องตอบกลับคําขอ POST เมื่อลูกค้าเลือกชําระเงิน Google จะส่งเนื้อหาคําขอ JSON ไปยังบริการเว็บของ Order with Google ในรูปแบบ CheckoutRequestMessage ซึ่งมีรายละเอียด Cart ของลูกค้า บริการเว็บจะตอบกลับด้วย CheckoutResponseMessage แผนภาพต่อไปนี้จะแสดงกระบวนการดังกล่าว
เมื่อได้รับคําขอให้ชําระเงิน บริการสั่งซื้อผ่าน Google ของคุณจะต้องดําเนินการดังต่อไปนี้
- ตรวจสอบความถูกต้องของรถเข็นตามราคาสินค้า ความพร้อมจําหน่ายสินค้า และบริการปัจจุบัน
- คํานวณราคารวม (รวมส่วนลด ภาษี และค่าจัดส่ง)
- หากสําเร็จ ให้ตอบกลับด้วยรถเข็นที่ไม่มีการแก้ไข
- หากไม่สําเร็จ ให้ตอบกลับด้วยข้อความแสดงข้อผิดพลาดและคําสั่งซื้อใหม่ที่เสนอ
ก่อนที่จะเริ่มใช้การชําระเงิน เราขอแนะนําให้อ่านเอกสารภาพรวมการดําเนินการตามคําสั่งซื้อ
ข้อความคําขอชําระเงิน
Google จะส่งคําขอไปยังบริการเว็บโดยใช้เนื้อหา JSON ในรูปแบบของ CheckoutRequestMessage เพื่อยืนยันรถเข็นของลูกค้า ซึ่งเมื่อลูกค้าเลือกชําระเงิน จะไม่มีการส่งคําสั่งซื้อของลูกค้าจนกว่าจะถึงขั้นตอน
สั่งซื้อกับ Google ในภายหลัง
ข้อมูลที่อยู่ใน
CheckoutRequestMessage
มีดังนี้
- ความตั้งใจ: ช่อง
inputs[0].intentของเนื้อความคําขอการชําระเงินทุกรายการมีค่าสตริงactions.foodordering.intent.CHECKOUT - รถเข็น: ช่อง
inputs[0].arguments[0].extensionของคําขอการชําระเงิน มีออบเจ็กต์Cartที่แสดงถึงรถเข็นของลูกค้า - การส่งหรือการถ่ายโอน: ช่องส่วนขยายของออบเจ็กต์
Cartมีออบเจ็กต์FoodCartExtensionที่ระบุพร็อพเพอร์ตี้สําหรับการนําส่งหรือการถ่ายโอน- สําหรับคําสั่งซื้อที่นําส่ง ออบเจ็กต์
FoodCartExtensionจะรวมที่อยู่นําส่ง - สําหรับคําสั่งซื้อแบบไปรับเองหรือสั่งกลับบ้าน ออบเจ็กต์
FoodCartExtensionจะไม่มีข้อมูลตําแหน่ง
- สําหรับคําสั่งซื้อที่นําส่ง ออบเจ็กต์
- แซนด์บ็อกซ์: ช่อง
isInSandboxของคําขอการชําระเงินมีค่าบูลีนที่ระบุว่าธุรกรรมใช้การชําระเงินแบบแซนด์บ็อกซ์หรือไม่
ตัวอย่างคําขอชําระเงิน
ด้านล่างคือตัวอย่างของ CheckoutRequestMessage
{
"user": {},
"conversation": {
"conversationId": "CTZbZfUlHCybEdcz_5PB3Ttf"
},
"inputs": [
{
"intent": "actions.foodordering.intent.CHECKOUT",
"arguments": [
{
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.Cart",
"merchant": {
"id": "restaurant/Restaurant/QWERTY",
"name": "Tep Tep Chicken Club"
},
"lineItems": [
{
"name": "Spicy Fried Chicken",
"type": "REGULAR",
"id": "299977679",
"quantity": 2,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "AUD",
"units": "39",
"nanos": 600000000
}
},
"offerId": "MenuItemOffer/QWERTY/scheduleId/496/itemId/143",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
"fulfillmentPreference": {
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P0M"
}
}
},
"location": {
"coordinates": {
"latitude": -33.8376441,
"longitude": 151.0868736
},
"formattedAddress": "Killoola St, 1, Concord West NSW 2138",
"zipCode": "2138",
"city": "Concord West",
"postalAddress": {
"regionCode": "AU",
"postalCode": "2138",
"administrativeArea": "NSW",
"locality": "Concord West",
"addressLines": [
"Killoola St",
"1"
]
}
}
}
}
}
]
}
],
"directActionOnly": true,
"isInSandbox": true
}
ข้อความตอบกลับ Checkout
หลังจากได้รับคําขอจากบริการ "สั่งซื้อผ่าน Google" บริการชําระเงินแบบ Checkout ของคุณจะต้องดําเนินการกับคําขอนั้นและส่ง CheckoutResponseMessage CheckoutResponseMessage ต้องครอบคลุมคําขอทั้งที่สําเร็จและไม่สําเร็จ
คําขอสําเร็จ
หากคําขอชําระเงินสําเร็จ CheckoutResponseMessage จะต้องใส่ ProposedOrder และ PaymentOptions
ProposedOrdercart: ออบเจ็กต์cartเหมือนกับรถเข็นช็อปปิ้งที่ระบุไว้ในCheckoutRequestMessageหากจําเป็นต้องเปลี่ยนเนื้อหาในรถเข็นCheckoutResponseMessageควรมีFoodErrorExtensionที่มีProposedOrderที่มีการแก้ไขแทนotherItems: รายการที่ผู้ให้บริการเพิ่ม เช่น ค่าจัดส่ง ภาษี และค่าธรรมเนียมอื่นๆ อาจมีคําขอบคุณที่ผู้ใช้เพิ่มด้วยtotalPrice: ราคารวมของคําสั่งซื้อextension:FoodOrderExtensionที่ระบุข้อมูลการดําเนินการตามคําสั่งซื้อ เช่น เวลานําส่ง
PaymentOptions- เราจะกล่าวถึงการตั้งค่าการประมวลผลการชําระเงินในภายหลังในหัวข้อตั้งค่า Google Pay
คุณสามารถใช้ตัวยึดตําแหน่ง JSON ใน
CheckoutResponseMessageได้จนกว่าคุณจะพร้อมประมวลผลการชําระเงิน - ในการเพิ่มตัวเลือกการชําระเงินตัวยึดตําแหน่งใน
CheckoutResponseMessageโปรดดูตัวอย่างด้านล่าง ซึ่งใช้เกตเวย์การชําระเงินตัวอย่างสําหรับPaymentOptions
- เราจะกล่าวถึงการตั้งค่าการประมวลผลการชําระเงินในภายหลังในหัวข้อตั้งค่า Google Pay
คุณสามารถใช้ตัวยึดตําแหน่ง JSON ใน
ตัวอย่างการตอบกลับที่สําเร็จ
{
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"checkoutResponse": {
"proposedOrder": {
"cart": {
"merchant": {
"id": "restaurant/Restaurant/QWERTY",
"name": "Tep Tep Chicken Club"
},
"lineItems": [
{
"name": "Spicy Fried Chicken",
"type": "REGULAR",
"id": "299977679",
"quantity": 2,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "AUD",
"units": "39",
"nanos": 600000000
}
},
"offerId": "MenuItemOffer/QWERTY/scheduleId/496/itemId/143",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
"fulfillmentPreference": {
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P0M"
}
}
},
"location": {
"coordinates": {
"latitude": -33.8376441,
"longitude": 151.0868736
},
"formattedAddress": "Killoola St, 1, Concord West NSW 2138",
"zipCode": "2138",
"city": "Concord West",
"postalAddress": {
"regionCode": "AU",
"postalCode": "2138",
"administrativeArea": "NSW",
"locality": "Concord West",
"addressLines": [
"Killoola St",
"1"
]
}
}
}
},
"totalPrice": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "AUD",
"units": "43",
"nanos": 100000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
"availableFulfillmentOptions": [
{
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P0M"
}
}
}
]
},
"otherItems": [
{
"name": "Delivery fee",
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "AUD",
"units": "3",
"nanos": 500000000
}
},
"type": "DELIVERY"
}
]
},
"paymentOptions": {
"googleProvidedOptions": {
"facilitationSpecification": "{\"apiVersion\":2,\"apiVersionMinor\":0,\"merchantInfo\":{\"merchantName\":\"merchantName\"},\"allowedPaymentMethods\":[{\"type\":\"CARD\",\"parameters\":{\"allowedAuthMethods\":[\"PAN_ONLY\"],\"allowedCardNetworks\":[\"VISA\",\"MASTERCARD\"],\"billingAddressRequired\":true,\"cvcRequired\":false},\"tokenizationSpecification\":{\"type\":\"PAYMENT_GATEWAY\",\"parameters\":{\"gatewayMerchantId\":\"YOUR_MERCHANT_ID\",\"gateway\":\"cybersource\"}}}],\"transactionInfo\":{\"currencyCode\":\"AUD\",\"totalPriceStatus\":\"ESTIMATED\",\"totalPrice\":\"43.1\"}} "
}
},
"additionalPaymentOptions": [
{
"actionProvidedOptions": {
"paymentType": "ON_FULFILLMENT",
"displayName": "Pay when you get your food.",
"onFulfillmentPaymentData": {
"supportedPaymentOptions": []
}
}
}
]
}
}
}
]
}
}
}
คําขอไม่สําเร็จ
หากคําขอชําระเงินไม่สําเร็จ CheckoutResponseMessage จะต้องรวม FoodErrorExtension ซึ่งมีรายการ FoodOrderError ที่อธิบายข้อผิดพลาดที่เกิดขึ้น หากมีข้อผิดพลาดที่กู้คืนได้สําหรับคําสั่งซื้อ เช่น การเปลี่ยนแปลงราคาของรายการในรถเข็น FoodErrorExtension ต้องมี correctedProposedOrder
ตัวอย่างการตอบกลับที่ไม่สําเร็จ
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "CLOSED",
"description": "The restaurant is closed."
}
]
}
}
}
]
}
}
}