feat(checkout): add CCAvenue payment provider and cookie-session retu… (#1291)

* feat(checkout): add CCAvenue payment provider and cookie-session return flow

- Add CCAvenue checkout button, icon, and return provider
- Wrap with CCAvenueReturnProvider only when ccavenueConfig.accessCodeId is set
- Use session from context (cookie) on CCAvenue return; remove sessionStorage token flow
- Register CCAvenue in lazy-payment-loader, payment-form, types, and GraphQL
- Update conditional-providers and use-confirm-checkout for CCAvenue
- Add ccavenue localizations across locales
- Update nextjs example and store actions

Co-authored-by: Cursor <cursoragent@cursor.com>

* feat(checkout): CCAvenue improvements and example config

- Pass ccavenueConfig from env in Next.js example (accessCodeId, redirectURL)
- CCAvenue button: user-friendly message for AUTHORIZATION_FAILED, remove debug logs
- CCAvenue return: use useConfirmCheckout.mutateAsync for redirect and error handling
- Remove Record typecasting for payment.methods.ccavenue and descriptions in payment-form

Co-authored-by: Cursor <cursoragent@cursor.com>

* feat(react): set CCAvenue redirect URL in payment component by environment

- Make CCAvenueConfig.redirectURL optional; derive gateway URL from apiHost
  (prod: secure.ccavenue.com, test: test.ccavenue.com) like Square CDN
- Consumer only passes accessCodeId; example checkout no longer needs
  NEXT_PUBLIC_CCAVENUE_REDIRECT_URL

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore(react): CCAvenue cleanup - remove redirectURL from config, debug log, and label fallback

- Remove optional redirectURL from CCAvenueConfig (always use derived gateway URL)
- Remove console.log from CCAvenue checkout button
- Use translation only for CCAvenue payment method label in payment form

Co-authored-by: Cursor <cursoragent@cursor.com>

* disable form and mutations if confirmingCheckout

* feat(ccavenue): add shipping validation and jwt auth support

- CCAvenueCheckoutButton: require shipping methods when delivery is SHIP before
  allowing payment; use env-based redirect URL
- CCAvenueReturnProvider: support jwt as auth fallback when session token
  unavailable for confirm checkout
- checkout-env: formatting (quotes)

Co-authored-by: Cursor <cursoragent@cursor.com>

* lint fix

* chore: add changeset for CCAvenue checkout improvements

Made-with: Cursor

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Phil Bennett <pbennett1@godaddy.com>
Co-authored-by: Phil Bennett <114938978+pbennett1-godaddy@users.noreply.github.com>

Author: 3 people

.changeset/ccavenue-checkout-improvements.md

@@ -0,0 +1,15 @@
+---
+"@godaddy/react": patch
+"@godaddy/localizations": patch
+---
+
+Add CCAvenue payment provider support and improvements
+
+**@godaddy/react**
+- Add CCAvenue checkout button with shipping validation (require shipping methods when delivery is SHIP)
+- Add CCAvenueReturnProvider for return flow with JWT auth support and confirm checkout loader
+- Use env-based redirect URL for CCAvenue gateway
+- Disable form and mutations when confirming checkout
+
+**@godaddy/localizations**
+- Add CCAvenue payment method labels and descriptions for all supported locales

examples/nextjs/app/checkout.tsx

@@ -60,6 +60,14 @@ export function CheckoutPage({ session }: { session: CheckoutSession }) {
             }
           : undefined
       }
+      ccavenueConfig={
+        process.env.NEXT_PUBLIC_CCAVENUE_ACCESS_CODE_ID
+          ? {
+              accessCodeId:
+                process.env.NEXT_PUBLIC_CCAVENUE_ACCESS_CODE_ID,
+            }
+          : undefined
+      }
     />
   );
 }

examples/nextjs/app/page.tsx

@@ -62,6 +62,10 @@ export default async function Home() {
           processor: 'mercadopago',
           checkoutTypes: ['standard'],
         },
+        ccavenue: {
+          processor: 'ccavenue',
+          checkoutTypes: ['standard'],
+        },
         paypal: {
           processor: 'paypal',
           checkoutTypes: ['express', 'standard'],

examples/nextjs/app/store/actions.ts

@@ -51,6 +51,10 @@ export async function checkoutWithOrder(orderId: string) {
           processor: 'godaddy',
           checkoutTypes: ['standard'],
         },
+        ccavenue: {
+          processor: 'ccavenue',
+          checkoutTypes: ['standard'],
+        },
         express: {
           processor: 'godaddy',
           checkoutTypes: ['express'],

packages/localizations/src/deDe.ts

@@ -107,6 +107,7 @@ export const deDe = {
       paze: 'Paze',
       offline: 'Offline-Zahlungen',
       mercadopago: 'Mercado Pago',
+      ccavenue: 'Mit CCAvenue bezahlen',
     },
     descriptions: {
       creditCard: '',
@@ -117,6 +118,7 @@ export const deDe = {
       offline: '',
       mercadopago:
         'Verwende das MercadoPago-Formular unten, um deinen Kauf sicher abzuschließen.',
+      ccavenue: '',
     },
     noMethodsAvailable: 'Keine Zahlungsmethoden verfügbar',
     cardNumber: 'Kartennummer',

packages/localizations/src/enIe.ts

@@ -107,6 +107,7 @@ export const enIe = {
       paze: 'Paze',
       offline: 'Offline payments',
       mercadopago: 'Mercado Pago',
+      ccavenue: 'Pay with CCAvenue',
     },
     descriptions: {
       creditCard: '',
@@ -117,6 +118,7 @@ export const enIe = {
       offline: '',
       mercadopago:
         'Use the MercadoPago form below to complete your purchase securely.',
+      ccavenue: '',
     },
     noMethodsAvailable: 'No payment methods available',
     cardNumber: 'Card number',

packages/localizations/src/enUs.ts

@@ -107,6 +107,7 @@ export const enUs = {
       paze: 'Paze',
       offline: 'Offline payments',
       mercadopago: 'Mercado Pago',
+      ccavenue: 'Pay with CCAvenue',
     },
     descriptions: {
       creditCard: '',
@@ -117,6 +118,7 @@ export const enUs = {
       offline: '',
       mercadopago:
         'Use the MercadoPago form below to complete your purchase securely.',
+      ccavenue: '',
     },
     noMethodsAvailable: 'No payment methods available',
     cardNumber: 'Card number',

packages/localizations/src/esAr.ts

@@ -108,6 +108,7 @@ export const esAr = {
       paze: 'Paze',
       offline: 'Pagos en efectivo',
       mercadopago: 'Mercado Pago',
+      ccavenue: 'الدفع عبر CCAvenue',
     },
     descriptions: {
       creditCard: '',
@@ -118,6 +119,7 @@ export const esAr = {
       offline: '',
       mercadopago:
         'Usa el formulario de MercadoPago a continuación para completar tu compra de forma segura.',
+      ccavenue: '',
     },
     noMethodsAvailable: 'No hay métodos de pago disponibles',
     cardNumber: 'Número de tarjeta',

packages/localizations/src/esCl.ts

@@ -108,6 +108,7 @@ export const esCl = {
       paze: 'Paze',
       offline: 'Pagos offline',
       mercadopago: 'Mercado Pago',
+      ccavenue: 'Pagar con CCAvenue',
     },
     descriptions: {
       creditCard: '',
@@ -118,6 +119,7 @@ export const esCl = {
       offline: '',
       mercadopago:
         'Usa el formulario de MercadoPago a continuación para completar tu compra de forma segura.',
+      ccavenue: '',
     },
     noMethodsAvailable: 'No hay métodos de pago disponibles',
     cardNumber: 'Número de tarjeta',

packages/localizations/src/esCo.ts

@@ -108,6 +108,7 @@ export const esCo = {
       paze: 'Paze',
       offline: 'Pagos sin conexión',
       mercadopago: 'Mercado Pago',
+      ccavenue: 'Pagar con CCAvenue',
     },
     descriptions: {
       creditCard: '',
@@ -118,6 +119,7 @@ export const esCo = {
       offline: '',
       mercadopago:
         'Usa el formulario de MercadoPago a continuación para completar tu compra de forma segura.',
+      ccavenue: '',
     },
     noMethodsAvailable: 'No hay métodos de pago disponibles',
     cardNumber: 'Número de tarjeta',