ตั้งค่าการชำระเงิน

ระบบจะเรียกใช้กระบวนการชําระเงินเมื่อผู้ใช้สร้างรถเข็น ระบบจะส่งเนื้อหาในรถเข็นของผู้ใช้และรายละเอียดเกี่ยวกับคำสั่งซื้อไปยังบริการเว็บแบบครบวงจรสำหรับการสั่งซื้อ ข้อมูลนี้ได้รับการตรวจสอบโดยบริการเว็บ จากนั้นคุณก็ดำเนินการต่อหรือปรับรถเข็นได้ตามต้องการ

แฮนเดิลการชำระเงินสำหรับบริการเว็บของคุณต้องตอบกลับคำขอ POST เมื่อลูกค้าเลือกชำระเงิน Google จะส่งข้อความของคำขอ JSON ในรูปแบบ CheckoutRequestMessage ไปยังเว็บเซอร์วิสการสั่งซื้อแบบ End-to-End ซึ่งมีรายละเอียดของ Cart ของลูกค้า จากนั้นเว็บเซอร์วิสจะตอบกลับด้วย CheckoutResponseMessage แผนภาพต่อไปนี้แสดงกระบวนการ

เมื่อได้รับคำขอชำระเงิน เว็บเซอร์วิสแบบ End-to-End สำหรับการสั่งซื้อของคุณต้องทำดังนี้

• ตรวจสอบความถูกต้องของรถเข็นโดยพิจารณาจากราคา ความพร้อมจำหน่าย และบริการของผู้ให้บริการปัจจุบัน
• คำนวณราคารวม (รวมส่วนลด ภาษี และค่าธรรมเนียมการนำส่ง)
• หากสำเร็จ ให้ตอบกลับด้วยรถเข็นที่ไม่มีการแก้ไข
• หากไม่สำเร็จ ให้ตอบกลับพร้อมข้อความแสดงข้อผิดพลาดและคำสั่งซื้อใหม่ที่เสนอ

ก่อนเริ่มใช้งานการชำระเงิน เราขอแนะนำให้อ่านเอกสารภาพรวมการดำเนินการตามคำสั่งซื้อ

ข้อความคำขอชำระเงิน

เมื่อลูกค้าเลือกชำระเงิน Google จะส่งคำขอไปยังเว็บเซอร์วิสของคุณพร้อมเนื้อหา JSON ในรูปแบบ CheckoutRequestMessage เพื่อตรวจสอบรถเข็นของลูกค้า ระบบจะไม่ส่งคำสั่งซื้อของลูกค้าจนกว่าจะถึงขั้นตอนถัดไปในขั้นตอนการสั่งซื้อแบบครบวงจร

ข้อมูลที่อยู่ใน 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
}

ข้อความตอบกลับการชำระเงิน

หลังจากได้รับคำขอจากบริการสั่งสินค้าจากต้นทางถึงปลายทางแล้ว เว็บบริการชำระเงินของคุณต้องประมวลผลคำขอและตอบกลับด้วย CheckoutResponseMessage CheckoutResponseMessage ต้องมีคำขอที่สำเร็จหรือไม่สำเร็จ

คำขอสำเร็จ

หากคำขอเช็คเอาต์สำเร็จ CheckoutResponseMessage ต้องมี ProposedOrder และ PaymentOptions

• ProposedOrder

  • cart: ออบเจ็กต์ cart ที่เหมือนกับรถเข็นที่ระบุไว้ใน CheckoutRequestMessage หากเนื้อหาในรถเข็นต้องเปลี่ยนแปลง CheckoutResponseMessage ควรมี FoodErrorExtension ที่มี ProposedOrder ที่แก้ไขแล้วแทน
  • otherItems: รายการที่ผู้ให้บริการเพิ่ม เช่น ค่าธรรมเนียมการนำส่ง ภาษี และค่าธรรมเนียมอื่นๆ และอาจมีทิปที่ผู้ใช้เพิ่มเข้ามาด้วย
  • totalPrice: ราคารวมของคำสั่งซื้อ
  • extension: FoodOrderExtension ที่กําหนดข้อมูลการดําเนินการตามคําสั่งซื้อ เช่น เวลานำส่ง

• PaymentOptions

  • การตั้งค่าการประมวลผลการชำระเงินจะกล่าวถึงในภายหลังในส่วนตั้งค่า Google Pay คุณสามารถใช้ตัวยึดตำแหน่ง JSON ใน CheckoutResponseMessage ได้จนกว่าจะพร้อมใช้งานการประมวลผลการชำระเงิน
  • หากต้องการเพิ่มตัวเลือกการชำระเงินที่ใช้เป็นตัวยึดตําแหน่งใน CheckoutResponseMessage ให้ดูตัวอย่างด้านล่าง ซึ่งใช้เกตเวย์การชำระเงินตัวอย่างสําหรับ PaymentOptions

ตัวอย่างการตอบกลับที่สำเร็จ

{
    "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."
                }
              ]
            }
          }
        }
      ]
    }
  }
}

การติดตั้งใช้งานจุดชำระเงิน

คุณควรทำตามขั้นตอนต่อไปนี้เมื่อติดตั้งใช้งานการชำระเงิน

ตรวจสอบบริการ

แสดงผล FoodOrderError สำหรับเงื่อนไขข้อผิดพลาดของบริการรายการแรกที่มี ข้อผิดพลาดเหล่านี้ไม่สามารถกู้คืนได้ ดังนั้นระบบจึงควรแสดงข้อผิดพลาดแรกที่พบ ดูคำอธิบายข้อผิดพลาดที่กู้คืนได้ในส่วนการจัดการข้อผิดพลาด

1. อ่านพร็อพเพอร์ตี้ FulfillmentOptionInfo ในคำขอเพื่อดูว่าประเภทการจำหน่ายสำหรับ delivery หรือ pickup

2. แสดงผลข้อผิดพลาดประเภทต่อไปนี้ หากจำเป็น

   ประเภทข้อผิดพลาด	กรณีการใช้งาน
   INVALID	ประเภทการดำเนินการตามคำสั่งซื้อไม่ถูกต้อง
   NOT_FOUND	ไม่พบประเภทการจำหน่าย
   ปิดแล้ว	ไม่มีกรอบเวลา OperationHours สำหรับคำสั่งซื้อ คำสั่งซื้อนี้เป็นคำสั่งซื้อที่ต้องทำโดยเร็วที่สุดและไม่มี ServiceHours ที่พร้อมใช้งานสำหรับเวลาปัจจุบัน มีการปิดฉุกเฉินหรือบริการ isDisabled เป็นจริง โปรดทราบว่ากรอบเวลาพิเศษจะมีความสําคัญเหนือกว่ากรอบเวลาปกติ ดูตัวอย่างในการตรวจสอบกรอบเวลาการสั่งซื้อและนำเอนทิตีบริการออกชั่วคราว
   UNAVAILABLE_SLOT	ไม่สามารถดำเนินการตามเวลาการสั่งซื้อล่วงหน้าได้
   NO_CAPACITY	ร้านอาหารไม่ว่างและยังไม่รับคำสั่งซื้อในขณะนี้
   OUT_OF_SERVICE_AREA	ไม่สามารถนำส่งคำสั่งซื้อไปยังที่อยู่ของผู้ใช้ ดูตัวอย่างได้ที่การตรวจสอบที่อยู่สำหรับจัดส่ง
   NO_COURIER_AVAILABLE	นำส่งคำสั่งซื้อไม่ได้เนื่องจากเจ้าหน้าที่นำส่งมีจำนวนจำกัด

ตรวจสอบและกำหนดราคารถเข็น

1. ค้นหารถเข็นแต่ละรายการlineItemsและตรวจสอบกับข้อมูลปัจจุบันในระบบของคุณหรือในระบบของผู้ขาย ค่า MenuItemOffer.sku จากเอนทิตีฟีดจะรวมอยู่ใน LineItem.offerId สร้าง FoodOrderError สำหรับรายการโฆษณาแต่ละรายการ หากจำเป็น สร้างข้อผิดพลาดได้สูงสุด 1 รายการสำหรับแต่ละรายการ แสดงผลข้อผิดพลาดประเภทต่อไปนี้หากจําเป็น

   ประเภทข้อผิดพลาด	กรณีการใช้งาน	กู้คืนได้
   INVALID	ข้อมูลสินค้าหรือข้อมูลตัวเลือกไม่ถูกต้อง	ไม่ได้
   NOT_FOUND	ไม่พบรายการหรือตัวเลือกใดๆ	ไม่ได้
   PRICE_CHANGED	ราคาของสินค้าหรือชุดค่าผสมของส่วนเสริมมีการเปลี่ยนแปลง ข้อผิดพลาดนี้ถือว่ากู้คืนได้	ใช่
   AVAILABILITY_CHANGED	จำนวนเงินที่ขอสำหรับรายการโฆษณาหรือตัวเลือกใดๆ ไม่พร้อมใช้งาน	ใช่
   REQUIREMENTS_NOT_MET	สั่งซื้อไม่ถึงมูลค่าขั้นต่ำหรือสูงสุด ซึ่งสามารถตรวจสอบได้โดยดูว่าราคาในรถเข็นต่ำกว่าค่าธรรมเนียมeligibleTransactionVolumeMin หรือสูงกว่าค่าธรรมเนียมeligibleTransactionVolumeMax ดูตัวอย่างในการตรวจสอบมูลค่าการสั่งซื้อขั้นต่ำ	ไม่ได้

   หมายเหตุ: เมื่อคำนวณราคาของ LineItem ที่มีส่วนเสริม ราคาของ LineItem จะรวมราคาของ MenuItemOption ด้วย หากมีการระบุ numberOfFreeAddOns ในส่วนเสริม MenuSection ราคาของส่วนเสริมแต่ละรายการจะรวมอยู่ในราคา FoodItemOption แต่ระบบจะไม่เพิ่มราคาของตัวเลือกที่ไม่มีค่าใช้จ่ายลงในราคา LineItem หากตัวเลือกที่เลือกมีจำนวนมากกว่า numberOfFreeAddOns ระบบจะนับส่วนเสริมที่มีราคาสูงสุดเป็นส่วนเสริมที่ไม่มีค่าใช้จ่าย

2. แสดงรายการบรรทัดรายการที่ตรวจสอบแล้วซึ่งมี LineItemType REGULAR ผลรวมของราคารายการโฆษณาในรถเข็นทั้งหมดคือราคารถเข็นหรือ SUBTOTAL

ดูตัวอย่างในการตรวจสอบรายการในรถเข็น

คำนวณค่าบริการ

1. ค้นหาเอนทิตีค่าธรรมเนียมที่ถูกต้องสำหรับบริการตาม eligibleRegion, validFrom, validThrough และ priority
2. คำนวณจำนวนค่าธรรมเนียมโดยพิจารณาว่าเอนทิตีได้รับการกำหนดด้วยพร็อพเพอร์ตี้ price, percentageOfCart หรือ pricePerMeter หรือไม่
3. คืนค่าธรรมเนียมบริการจัดส่งหรือบริการซื้อกลับบ้านเป็น LineItem ที่มี LineItemType DELIVERY หรือ FEE ตามลำดับ เพิ่มค่าธรรมเนียมลงในรายการรถเข็นotherItems

ใช้โปรโมชัน

1. ค้นหาเอนทิตี Deal โดยอิงตามการจับคู่ค่า Promotion.coupon กับ Deal.dealCode

2. ตรวจสอบดีลและแสดงผล FoodOrderError หากจำเป็น ข้อผิดพลาดเหล่านี้ถือว่าแก้ไขได้ แสดงผลข้อผิดพลาดประเภทต่อไปนี้หากจําเป็น

   ประเภทข้อผิดพลาด	กรณีการใช้งาน
   PROMO_NOT_RECOGNIZED	ระบบไม่รู้จักรหัสคูปอง
   PROMO_EXPIRED	ดีลหมดอายุแล้ว
   PROMO_ORDER_INELIGIBLE	คำสั่งซื้อไม่มีสิทธิ์ใช้คูปอง
   PROMO_NOT_APPLICABLE	เหตุผลอื่นๆ

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

3. คำนวณจำนวนเงินราคาดีลตาม Dealdiscount หรือ DealdiscountPercentage

4. ใช้จำนวนเงินราคาดีลโดยใช้ยอดรวมในรถเข็นหรือยอดรวมค่าธรรมเนียม ทั้งนี้ขึ้นอยู่กับดีลdealType

5. กลับไปที่รถเข็นpromotionsที่มีโปรโมชันที่ใช้

6. แสดงโปรโมชันเป็น LineItem ที่มี LineItemType DISCOUNT เพิ่มส่วนลดลงในรายการ CartotherItems ที่มีราคาติดลบ

ส่งคำตอบ

1. สร้าง ProposedOrdercart รถเข็นคำตอบจะเหมือนกับรถเข็นคำขอหากไม่พบข้อผิดพลาดระหว่างการตรวจสอบ
2. แสดงรายการ ProposedOrder.otherItems พร้อมภาษี ค่าธรรมเนียม ทิป และส่วนลด (หากมี) ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีกำหนดค่ารายการทิปได้ที่ทิป
3. ใส่ ProposedOrdertotalPrice โดยเพิ่มรถเข็นช้อปปิ้ง ราคา ค่าธรรมเนียม ส่วนลด ภาษี และค่าบริการ
4. แสดงFoodOrderExtensionavailableFulfillmentOptions พร้อมFulfillmentOption ที่เกี่ยวข้อง อัปเดตเวลารับหรือนำส่งโดยประมาณเป็นเวลาที่คาดไว้
5. หากมี FoodOrderErrors ที่สร้างขึ้นจากการตรวจสอบความถูกต้องครั้งก่อนหน้า ให้ทำดังนี้
   • รวม StructuredResponseerror และรายการข้อผิดพลาดใน FoodErrorExtensionfoodOrderErrors
   • แสดงผล ProposedOrder ในช่อง correctedProposedOrder หากแก้ไขข้อผิดพลาดทั้งหมดได้
   • แสดงผล PaymentOptions ในช่อง paymentOptions หากแก้ไขข้อผิดพลาดทั้งหมดได้
   • (ไม่บังคับ) ใส่ additionalPaymentOptions หากมีตัวเลือกการชำระเงินอื่นๆ ที่ใช้ได้และข้อผิดพลาดทั้งหมดแก้ไขได้
6. หากไม่มีข้อผิดพลาดในการตรวจสอบ ให้แสดงผล proposedOrder, paymentOptions ในแออบเจ็กต์ CheckoutResponse (ไม่บังคับ) ใส่ additionalPaymentOptions หากมีตัวเลือกการชำระเงินอื่นๆ