Proces płatności jest wywoływany, gdy użytkownik utworzy koszyk. Zawartość koszyka użytkownika i szczegółowe informacje o zamówieniu są wysyłane do usługi internetowej Zamów przez Google. Te informacje są weryfikowane przez usługę internetową, a następnie możesz kontynuować wprowadzanie zmian w koszyku lub je dostosowywać.
Moduł obsługi płatności w usłudze internetowej musi odpowiadać na żądania POST. Gdy klient zdecyduje się przejść do płatności, Google wysyła do usługi internetowej Zamów przez Google treść JSON w formacie CheckoutRequestMessage, który zawiera szczegółowe informacje o kliencie Cart. Otrzymasz wtedy odpowiedź z odpowiedzią CheckoutResponseMessage. Poniższy diagram ilustruje cały proces.
Po otrzymaniu żądania realizacji transakcji usługa internetowa Zamów przez Google musi wykonać te czynności:
- Sprawdź, czy cena koszyka jest prawidłowa na podstawie aktualnych cen, dostępności i usług dostawcy.
- Oblicz łączną cenę (razem z rabatami, podatkami i opłatami za dostawę).
- Jeśli operacja się uda, odpowiedz w niezmienionym koszyku.
- Jeśli się nie powiedzie, w odpowiedzi prześlij komunikat o błędzie i nowe proponowane zamówienie.
Zanim zaczniesz wdrażać proces płatności, zalecamy zapoznanie się z dokumentacją przeglądu realizacji zamówień.
Wiadomość z prośbą o płatność
Aby zweryfikować koszyk klienta, gdy klient zdecyduje się zapłacić, Google wysyła żądanie do Twojej usługi internetowej za pomocą treści JSON w formie CheckoutRequestMessage. Zamówienie klienta zostanie przesłane dopiero później w ramach procedury Zamów przez Google.
Dane zawarte w CheckoutRequestMessage obejmują:
- Intencja: pole
inputs[0].intentw każdej treści żądania płatności zawiera wartość ciągu znakówactions.foodordering.intent.CHECKOUT. - Koszyk: pole
inputs[0].arguments[0].extensionżądania płatności zawiera obiektCart, który reprezentuje koszyk klienta. - Dostawa lub pobieranie: pole rozszerzenia obiektu
Cartzawiera obiektFoodCartExtension, który określa właściwości dostawy lub odbioru:- W przypadku zamówień dostawy obiekt
FoodCartExtensionzawiera adres dostawy. - W przypadku zamówień z odbiorem lub na wynos obiekt
FoodCartExtensionnie zawiera żadnych informacji o lokalizacji.
- W przypadku zamówień dostawy obiekt
- Piaskownica: pole
isInSandboxżądania płatności zawiera wartość logiczną, która wskazuje, czy transakcja używa płatności piaskownicy.
Przykład żądania płatności
Oto przykład 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
}
Wiadomość w Google Checkout
Gdy otrzymasz żądanie z usługi Zamów przez Google, Twoja usługa płatności Google musi przetworzyć je i odpowiedzieć CheckoutResponseMessage. CheckoutResponseMessage musi uwzględniać żądanie zakończone powodzeniem lub niepowodzeniem.
Prośba została zrealizowana
Aby można było zrealizować płatność, CheckoutResponseMessage musi zawierać atrybuty ProposedOrder i PaymentOptions:
ProposedOrdercart: obiektcartidentyczny z koszykiem podanym w zasadzieCheckoutRequestMessage. Jeśli konieczna jest zmiana zawartości koszyka,CheckoutResponseMessagepowinna zamiast tego zawieraćFoodErrorExtensionz poprawioną wartościąProposedOrder.otherItems: elementy dodane przez dostawcę, takie jak opłaty za dostawę, podatki i inne opłaty. Może też zawierać bezpłatnie dodany przez użytkownika.totalPrice: łączna cena zamówienia.extension:FoodOrderExtension, który określa informacje o realizacji zamówienia, np. czas dostawy.
PaymentOptions- Konfigurowanie płatności znajduje się w dalszej części artykułu Konfigurowanie Google Pay.
W
CheckoutResponseMessagemożesz używać zastępczego pliku JSON, dopóki nie będziesz mieć gotowości do wdrożenia obsługi płatności. - Aby dodać opcje płatności zastępczych w
CheckoutResponseMessage, zapoznaj się z przykładem poniżej, w którym jest używana przykładowa brama płatności dlaPaymentOptions.
- Konfigurowanie płatności znajduje się w dalszej części artykułu Konfigurowanie Google Pay.
W
Przykład udanej odpowiedzi
{
"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": []
}
}
}
]
}
}
}
]
}
}
}
Nieudana prośba
Jeśli żądanie płatności się nie powiedzie, CheckoutResponseMessage musi zawierać element FoodErrorExtension, który zawiera listę elementów FoodOrderError opisujące błędy, które wystąpiły. Jeśli w zamówieniu występują błędy do odzyskania, np. zmiana ceny produktu w koszyku, wartość FoodErrorExtension musi zawierać właściwość correctedProposedOrder.
Przykład nieudanej odpowiedzi
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "CLOSED",
"description": "The restaurant is closed."
}
]
}
}
}
]
}
}
}