[YOLO-3035] support tips in unified checkout

.changeset/fruity-dots-jog.md

@@ -0,0 +1,15 @@
+---
+"@godaddy/react": patch
+---
+
+Support tips in unified checkout
+
+Adds the `tips` session config surface (`default` and threshold-based `amounts`/`percentages` presets) alongside `enableTips`, and includes the selected tip in wallet sheet totals and the authorized/confirmed amount.
+
+For redirect gateways (CCAvenue), the authorized tip is persisted across the redirect so the confirmation on the return leg records the tip the customer was actually charged. Checkout refuses to redirect when a non-zero tip cannot be persisted, rather than sending the customer to pay a tip the order would not include.
+
+Express checkout stays tip-free: its wallet sheets open on the item subtotal and add the shipping and taxes they calculate in their own event flows, and its confirmation records no tip.
+
+Presets worth more than the order total are not offered, and a selection a later discount puts out of reach is cleared. Percentages are a proportion of the item subtotal while the API bounds the tip by the order total, so on a discounted order a preset could be picked and then rejected at Pay; the option is now withheld instead. "No tip" and "Custom amount" are always available, and a custom amount is still left for the API to rule on.
+
+Also gives every `Button` a `cursor-pointer`, so buttons rendered as `<button>` show a pointer cursor on hover instead of the browser default.

.changeset/tip-api-error-translations.md

@@ -0,0 +1,5 @@
+---
+"@godaddy/localizations": patch
+---
+
+Add the missing tip `apiErrors` translations to every locale

examples/nextjs/app/checkout.tsx

@@ -63,8 +63,7 @@ export function CheckoutPage({ session }: { session: CheckoutSession }) {
       ccavenueConfig={
         process.env.NEXT_PUBLIC_CCAVENUE_ACCESS_CODE_ID
           ? {
-              accessCodeId:
-                process.env.NEXT_PUBLIC_CCAVENUE_ACCESS_CODE_ID,
+              accessCodeId: process.env.NEXT_PUBLIC_CCAVENUE_ACCESS_CODE_ID,
             }
           : undefined
       }

examples/nextjs/app/page.tsx

@@ -21,6 +21,19 @@ export default async function Home() {
       enableTaxCollection: true,
       enableNotesCollection: true,
       enablePromotionCodes: true,
+      enableTips: true,
+      tips: {
+        default: {
+          percentages: [20, 40, 60],
+        },
+        thresholds: [
+          {
+            minSubtotal: 0,
+            maxSubtotal: 1000,
+            amounts: [300, 500, 700],
+          },
+        ],
+      },
       shipping: {
         fulfillmentLocationId: 'default-location',
         originAddress: {

packages/localizations/src/deDe.ts

@@ -370,6 +370,13 @@ export const deDe = {
     DEPENDENCY_ERROR:
       'Wir können Ihre Bestellung derzeit nicht bearbeiten. Bitte warten Sie einen Moment und versuchen Sie es erneut',
     AUTHORIZATION_FAILED: 'Zahlungsautorisierung fehlgeschlagen',
+    TIP_EXCEEDS_LIMIT: 'Das Trinkgeld ist für diese Bestellung zu hoch',
+    INVALID_TIP_AMOUNT: 'Gültigen Trinkgeldbetrag eingeben',
+    TIPS_NOT_ENABLED: 'Für diese Bestellung wird kein Trinkgeld akzeptiert',
+    TIP_CHARGE_FAILED:
+      'Anderen Trinkgeldbetrag versuchen oder Kein Trinkgeld auswählen',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Trinkgeld ist bei Offline-Zahlungen nicht möglich',
   },
   storefront: {
     product: 'Produkt',

packages/localizations/src/enAu.ts

@@ -346,6 +346,12 @@ export const enAu = {
     DEPENDENCY_ERROR:
       "We're unable to process your order right now. Please wait a moment and try again",
     AUTHORIZATION_FAILED: 'Failed to authorise payment',
+    TIP_EXCEEDS_LIMIT: 'Tip is too large for this order',
+    INVALID_TIP_AMOUNT: 'Enter a valid tip amount',
+    TIPS_NOT_ENABLED: 'Tips are not accepted for this order',
+    TIP_CHARGE_FAILED: 'Try a different tip amount, or choose No Tip',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Tips are not supported for offline payments',
   },
   storefront: {
     product: 'Product',

packages/localizations/src/enIe.ts

@@ -346,6 +346,12 @@ export const enIe = {
     DEPENDENCY_ERROR:
       "We're unable to process your order right now. Please wait a moment and try again",
     AUTHORIZATION_FAILED: 'Failed to authorise payment',
+    TIP_EXCEEDS_LIMIT: 'Tip is too large for this order',
+    INVALID_TIP_AMOUNT: 'Enter a valid tip amount',
+    TIPS_NOT_ENABLED: 'Tips are not accepted for this order',
+    TIP_CHARGE_FAILED: 'Try a different tip amount, or choose No Tip',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Tips are not supported for offline payments',
   },
   storefront: {
     product: 'Product',

packages/localizations/src/enUs.ts

@@ -346,6 +346,12 @@ export const enUs = {
     DEPENDENCY_ERROR:
       "We're unable to process your order right now. Please wait a moment and try again",
     AUTHORIZATION_FAILED: 'Failed to authorize payment',
+    TIP_EXCEEDS_LIMIT: 'Tip is too large for this order',
+    INVALID_TIP_AMOUNT: 'Enter a valid tip amount',
+    TIPS_NOT_ENABLED: 'Tips are not accepted for this order',
+    TIP_CHARGE_FAILED: 'Try a different tip amount, or choose No Tip',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Tips are not supported for offline payments',
   },
   storefront: {
     product: 'Product',

packages/localizations/src/esAr.ts

@@ -353,6 +353,12 @@ export const esAr = {
     DEPENDENCY_ERROR:
       'No podemos procesar su pedido en este momento. Espere un momento e inténtelo de nuevo',
     AUTHORIZATION_FAILED: 'Error al autorizar el pago',
+    TIP_EXCEEDS_LIMIT: 'La propina es demasiado alta para este pedido',
+    INVALID_TIP_AMOUNT: 'Ingresá un monto de propina válido',
+    TIPS_NOT_ENABLED: 'No se aceptan propinas para este pedido',
+    TIP_CHARGE_FAILED: 'Probá otro monto de propina o elegí Sin Propina',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'No se aceptan propinas en los pagos en efectivo',
   },
   storefront: {
     product: 'Producto',

packages/localizations/src/esCl.ts

@@ -355,6 +355,12 @@ export const esCl = {
     DEPENDENCY_ERROR:
       'No podemos procesar su pedido en este momento. Espere un momento e inténtelo de nuevo',
     AUTHORIZATION_FAILED: 'Error al autorizar el pago',
+    TIP_EXCEEDS_LIMIT: 'La propina es demasiado alta para este pedido',
+    INVALID_TIP_AMOUNT: 'Ingresa un monto de propina válido',
+    TIPS_NOT_ENABLED: 'No se aceptan propinas para este pedido',
+    TIP_CHARGE_FAILED: 'Prueba otro monto de propina o elige Sin Propina',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'No se aceptan propinas en los pagos offline',
   },
   storefront: {
     product: 'Producto',

packages/localizations/src/esCo.ts

@@ -353,6 +353,12 @@ export const esCo = {
     DEPENDENCY_ERROR:
       'No podemos procesar su pedido en este momento. Espere un momento e inténtelo de nuevo',
     AUTHORIZATION_FAILED: 'Error al autorizar el pago',
+    TIP_EXCEEDS_LIMIT: 'La propina es demasiado alta para este pedido',
+    INVALID_TIP_AMOUNT: 'Ingresa un monto de propina válido',
+    TIPS_NOT_ENABLED: 'No se aceptan propinas para este pedido',
+    TIP_CHARGE_FAILED: 'Prueba otro monto de propina o elige Sin propina',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'No se aceptan propinas en los pagos sin conexión',
   },
   storefront: {
     product: 'Producto',

packages/localizations/src/esEs.ts

@@ -358,6 +358,12 @@ export const esEs = {
     DEPENDENCY_ERROR:
       'No podemos procesar su pedido en este momento. Espere un momento e inténtelo de nuevo',
     AUTHORIZATION_FAILED: 'Error al autorizar el pago',
+    TIP_EXCEEDS_LIMIT: 'La propina es demasiado alta para este pedido',
+    INVALID_TIP_AMOUNT: 'Introduce una cantidad de propina válida',
+    TIPS_NOT_ENABLED: 'No se aceptan propinas para este pedido',
+    TIP_CHARGE_FAILED: 'Prueba otra cantidad de propina o elige Sin propina',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'No se aceptan propinas en los pagos sin conexión',
   },
   storefront: {
     product: 'Producto',

packages/localizations/src/esMx.ts

@@ -354,6 +354,12 @@ export const esMx = {
     DEPENDENCY_ERROR:
       'No podemos procesar su pedido en este momento. Espere un momento e inténtelo de nuevo',
     AUTHORIZATION_FAILED: 'Error al autorizar el pago',
+    TIP_EXCEEDS_LIMIT: 'La propina es demasiado alta para este pedido',
+    INVALID_TIP_AMOUNT: 'Ingrese una cantidad de propina válida',
+    TIPS_NOT_ENABLED: 'No se aceptan propinas para este pedido',
+    TIP_CHARGE_FAILED: 'Pruebe otra cantidad de propina o elija Sin Propina',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'No se aceptan propinas en los pagos fuera de línea',
   },
   storefront: {
     product: 'Producto',

packages/localizations/src/esPe.ts

@@ -353,6 +353,12 @@ export const esPe = {
     DEPENDENCY_ERROR:
       'No podemos procesar su pedido en este momento. Espere un momento e inténtelo de nuevo',
     AUTHORIZATION_FAILED: 'Error al autorizar el pago',
+    TIP_EXCEEDS_LIMIT: 'La propina es demasiado alta para este pedido',
+    INVALID_TIP_AMOUNT: 'Ingrese un monto de propina válido',
+    TIPS_NOT_ENABLED: 'No se aceptan propinas para este pedido',
+    TIP_CHARGE_FAILED: 'Pruebe otro monto de propina o elija Sin Propina',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'No se aceptan propinas en los pagos en efectivo',
   },
   storefront: {
     product: 'Producto',

packages/localizations/src/esUs.ts

@@ -353,6 +353,12 @@ export const esUs = {
     DEPENDENCY_ERROR:
       'No podemos procesar su pedido en este momento. Espere un momento e inténtelo de nuevo',
     AUTHORIZATION_FAILED: 'Error al autorizar el pago',
+    TIP_EXCEEDS_LIMIT: 'La propina es demasiado alta para este pedido',
+    INVALID_TIP_AMOUNT: 'Ingrese una cantidad de propina válida',
+    TIPS_NOT_ENABLED: 'No se aceptan propinas para este pedido',
+    TIP_CHARGE_FAILED: 'Pruebe otra cantidad de propina o elija Sin Propina',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'No se aceptan propinas en los pagos offline',
   },
   storefront: {
     product: 'Producto',

packages/localizations/src/frCa.ts

@@ -370,6 +370,13 @@ export const frCa = {
     DEPENDENCY_ERROR:
       'Nous ne pouvons pas traiter votre commande actuellement. Veuillez patienter un moment et réessayer',
     AUTHORIZATION_FAILED: "Échec de l'autorisation du paiement",
+    TIP_EXCEEDS_LIMIT: 'Le pourboire est trop élevé pour cette commande',
+    INVALID_TIP_AMOUNT: 'Entrez un montant de pourboire valide',
+    TIPS_NOT_ENABLED: 'Les pourboires ne sont pas acceptés pour cette commande',
+    TIP_CHARGE_FAILED:
+      'Essayez un autre montant de pourboire ou choisissez Aucun pourboire',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Les pourboires ne sont pas acceptés pour les paiements hors ligne',
   },
   storefront: {
     product: 'Produit',

packages/localizations/src/frFr.ts

@@ -371,6 +371,13 @@ export const frFr = {
     DEPENDENCY_ERROR:
       'Nous ne pouvons pas traiter votre commande actuellement. Veuillez patienter un moment et réessayer',
     AUTHORIZATION_FAILED: "Échec de l'autorisation du paiement",
+    TIP_EXCEEDS_LIMIT: 'Le pourboire est trop élevé pour cette commande',
+    INVALID_TIP_AMOUNT: 'Entrez un montant de pourboire valide',
+    TIPS_NOT_ENABLED: 'Les pourboires ne sont pas acceptés pour cette commande',
+    TIP_CHARGE_FAILED:
+      'Essayez un autre montant de pourboire ou choisissez Aucun pourboire',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Les pourboires ne sont pas acceptés pour les paiements hors ligne',
   },
   storefront: {
     product: 'Produit',

packages/localizations/src/idId.ts

@@ -345,6 +345,12 @@ export const idId = {
     DEPENDENCY_ERROR:
       'Kami tidak dapat memproses pesanan Anda saat ini. Silakan tunggu sebentar dan coba lagi',
     AUTHORIZATION_FAILED: 'Gagal mengotorisasi pembayaran',
+    TIP_EXCEEDS_LIMIT: 'Tip terlalu besar untuk pesanan ini',
+    INVALID_TIP_AMOUNT: 'Masukkan jumlah tip yang valid',
+    TIPS_NOT_ENABLED: 'Tip tidak diterima untuk pesanan ini',
+    TIP_CHARGE_FAILED: 'Coba jumlah tip lain atau pilih Tanpa Tip',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Tip tidak didukung untuk pembayaran offline',
   },
   storefront: {
     product: 'Produk',

packages/localizations/src/itIt.ts

@@ -369,6 +369,13 @@ export const itIt = {
     DEPENDENCY_ERROR:
       'Non riusciamo a elaborare il tuo ordine in questo momento. Aspetta un momento e riprova',
     AUTHORIZATION_FAILED: "Errore nell'autorizzazione del pagamento",
+    TIP_EXCEEDS_LIMIT: 'La mancia è troppo alta per questo ordine',
+    INVALID_TIP_AMOUNT: 'Inserisci un importo della mancia valido',
+    TIPS_NOT_ENABLED: 'Le mance non sono accettate per questo ordine',
+    TIP_CHARGE_FAILED:
+      'Prova un altro importo della mancia o scegli Nessuna Mancia',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Le mance non sono supportate per i pagamenti offline',
   },
   storefront: {
     product: 'Prodotto',

packages/localizations/src/ptBr.ts

@@ -351,6 +351,12 @@ export const ptBr = {
     DEPENDENCY_ERROR:
       'Não conseguimos processar seu pedido no momento. Aguarde um momento e tente novamente',
     AUTHORIZATION_FAILED: 'Falha ao autorizar pagamento',
+    TIP_EXCEEDS_LIMIT: 'A gorjeta é muito alta para este pedido',
+    INVALID_TIP_AMOUNT: 'Digite um valor de gorjeta válido',
+    TIPS_NOT_ENABLED: 'Gorjetas não são aceitas para este pedido',
+    TIP_CHARGE_FAILED: 'Tente outro valor de gorjeta ou escolha Sem Gorjeta',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Gorjetas não são aceitas em pagamentos offline',
   },
   storefront: {
     product: 'Produto',

packages/localizations/src/qaPs.ts

@@ -355,6 +355,12 @@ export const qaPs = {
     DEPENDENCY_ERROR:
       'موږ اوس ستاسو امر پروسس نشو کولی. مهرباني وکړئ یو شېبه انتظار وکړئ او بیا هڅه وکړئ',
     AUTHORIZATION_FAILED: '[Fâîlëd ţö âüţhörîžë þâÿmëñţ]',
+    TIP_EXCEEDS_LIMIT: '[Ţîþ îš ţöö lârgë för ţhîš örðër]',
+    INVALID_TIP_AMOUNT: '[Ëñţër â vâlîd ţîþ âmöüñţ]',
+    TIPS_NOT_ENABLED: '[Ţîþš ârë ñöţ âççëþţëd för ţhîš örðër]',
+    TIP_CHARGE_FAILED: '[Ţrÿ â dîffërëñţ ţîþ âmöüñţ, ör çhööšë Ñö Ţîþ]',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      '[Ţîþš ârë ñöţ šüþþörţëd för öfflîñë þâÿmëñţš]',
   },
   storefront: {
     product: '[Product]',

packages/localizations/src/trTr.ts

@@ -346,6 +346,12 @@ export const trTr = {
     DEPENDENCY_ERROR:
       'Şu anda siparişinizi işleme alamıyoruz. Lütfen bir dakika bekleyin ve tekrar deneyin',
     AUTHORIZATION_FAILED: 'Ödeme yetkilendirmesi başarısız',
+    TIP_EXCEEDS_LIMIT: 'Bahşiş bu sipariş için çok yüksek',
+    INVALID_TIP_AMOUNT: 'Geçerli bir bahşiş tutarı girin',
+    TIPS_NOT_ENABLED: 'Bu sipariş için bahşiş kabul edilmiyor',
+    TIP_CHARGE_FAILED: 'Farklı bir bahşiş tutarı deneyin veya Bahşiş Yok seçin',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Çevrimdışı ödemelerde bahşiş desteklenmiyor',
   },
   storefront: {
     product: 'Ürün',

packages/localizations/src/viVn.ts

@@ -346,6 +346,12 @@ export const viVn = {
     DEPENDENCY_ERROR:
       'Chúng tôi không thể xử lý đơn hàng của bạn ngay bây giờ. Vui lòng đợi một chút và thử lại',
     AUTHORIZATION_FAILED: 'Không thể ủy quyền thanh toán',
+    TIP_EXCEEDS_LIMIT: 'Tiền tip quá lớn cho đơn hàng này',
+    INVALID_TIP_AMOUNT: 'Nhập số tiền tip hợp lệ',
+    TIPS_NOT_ENABLED: 'Đơn hàng này không nhận tiền tip',
+    TIP_CHARGE_FAILED: 'Hãy thử số tiền tip khác hoặc chọn Không tip',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT:
+      'Không hỗ trợ tiền tip cho thanh toán ngoại tuyến',
   },
   storefront: {
     product: 'Sản phẩm',

packages/localizations/src/zhCn.ts

@@ -333,6 +333,11 @@ export const zhCn = {
     MISSING_SHIPPING_INFO: '配送地址或方式应用失败',
     DEPENDENCY_ERROR: '我们目前无法处理您的订单。请稍等片刻再试',
     AUTHORIZATION_FAILED: '付款授权失败',
+    TIP_EXCEEDS_LIMIT: '小费金额超出此订单的上限',
+    INVALID_TIP_AMOUNT: '请输入有效的小费金额',
+    TIPS_NOT_ENABLED: '此订单不接受小费',
+    TIP_CHARGE_FAILED: '请尝试其他小费金额或选择无小费',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT: '线下付款不支持小费',
   },
   storefront: {
     product: '产品',

packages/localizations/src/zhSg.ts

@@ -333,6 +333,11 @@ export const zhSg = {
     MISSING_SHIPPING_INFO: '配送地址或方式应用失败',
     DEPENDENCY_ERROR: '我們目前無法處理您的訂單。請稍等片刻再試',
     AUTHORIZATION_FAILED: '付款授权失败',
+    TIP_EXCEEDS_LIMIT: '小费金额超出此订单的上限',
+    INVALID_TIP_AMOUNT: '输入有效的小费金额',
+    TIPS_NOT_ENABLED: '此订单不接受小费',
+    TIP_CHARGE_FAILED: '请尝试其他小费金额或选择无小费',
+    TIP_NOT_SUPPORTED_FOR_OFFLINE_PAYMENT: '线下付款不支持小费',
   },
   storefront: {
     product: '产品',