Google Pay

Google Pay deja que el comprador pague con una tarjeta guardada en su cuenta de Google, con un toque y sin llenar el formulario de tarjeta. Google entrega un token cifrado: ni tu sitio ni tu servidor ven el número de tarjeta. Tonder gestiona la relación con Google: el pago corre con el perfil de Google Pay de Tonder, envías tus dominios y el botón aparece en el Web SDK o en Hosted Checkout 2.0. No necesitas cuenta en Google Pay & Wallet Console. Google tiene que aprobar tu negocio, y tu representante de Tonder te lo confirma. El resultado es una transacción de Tonder con los webhooks que ya manejas.

Cómo funciona

1. El comprador toca el botón de Google Pay y elige una tarjeta en la hoja de pago de Google.
2. Google cifra la tarjeta en un token que solo puede abrir el procesador de Tonder.
3. El Web SDK o Hosted Checkout envía el token a Tonder.
4. Tonder procesa el pago como un pago con tarjeta y responde con el estado.
5. Si el banco pide autenticación 3DS, el comprador la completa antes de que el pago termine. El Web SDK y Hosted Checkout se encargan de ese paso.

¿Cuándo hay 3DS? Las tarjetas guardadas en la cuenta de Google del comprador (PAN_ONLY) siempre pasan por 3DS. Las tarjetas guardadas en un dispositivo Android (CRYPTOGRAM_3DS) ya traen su propia autenticación y responden con un estado final.

Moneda: MXN. Redes: Visa y Mastercard.

Antes de empezar

• Google Pay habilitado en tu cuenta de Tonder. Lo activa tu representante.
• La aprobación de Google para tu negocio, que te confirma tu representante.
• La lista de dominios donde aparecerá el botón.
• Tu checkout en el Web SDK de Tonder o en Hosted Checkout 2.0.

Paso 1: pide a Tonder que lo habilite y registre tus dominios

Envía a tu representante de Tonder los dominios donde se mostrará el botón, sin rutas (por ejemplo checkout.tucomercio.com). Tonder los registra en su perfil de Google Pay y habilita el método en tu cuenta.

Paso 2: muestra el botón

El botón solo aparece cuando Google Pay está habilitado en tu cuenta y el navegador del comprador puede pagar con Google Pay: Google lo verifica antes de mostrarlo. No necesitas integrar la librería de Google. Mantén el pago con tarjeta en tu checkout para los compradores que no vean el botón.

Hosted Checkout 2.0

Agrega google_pay a payment_method_types al crear la sesión. Igual que Apple Pay, se muestra en el diseño v2, para cuentas que procesan por la API Direct.

curl -X POST 'https://api-stage.tonder.io/checkout/v1/sessions' \
  -H 'Authorization: Token YOUR_TEST_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "customer": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane.doe@example.com"
    },
    "amount_total": 150.00,
    "currency": "MXN",
    "line_items": [
      { "name": "Test Product", "quantity": 1, "unit_price": 150.00, "product_id": "your internal product id" }
    ],
    "payment_method_types": ["card", "google_pay"],
    "return_url": "https://your-store.com/checkout/complete",
    "external_id": "ORD-001",
    "metadata": { "external_id": "ORD-001" }
  }'

curl -X POST 'https://api.tonder.io/checkout/v1/sessions' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "customer": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane.doe@example.com"
    },
    "amount_total": 150.00,
    "currency": "MXN",
    "line_items": [
      { "name": "Test Product", "quantity": 1, "unit_price": 150.00, "product_id": "your internal product id" }
    ],
    "payment_method_types": ["card", "google_pay"],
    "return_url": "https://your-store.com/checkout/complete",
    "external_id": "ORD-001",
    "metadata": { "external_id": "ORD-001" }
  }'

Redirige al comprador a la url de la respuesta, como en el inicio rápido. La página alojada muestra la hoja de Google Pay, se encarga de 3DS cuando el banco lo pide y regresa al comprador a tu return_url.

Web SDK

El Web SDK muestra el botón por ti, así que no agregas código de Google. Cuando el banco pide 3DS, el Web SDK lo abre igual que en un pago con tarjeta, según tu modo de presentación.

Paso 3: confirma el pago

Los pagos con Google Pay son transacciones de Tonder. Aparecen en el dashboard y en los reportes, y envían los webhooks de pago que ya manejas, con payment_method_type: "GOOGLE_PAY". Concilia con metadata.external_id. Un evento payment_Success:

{
  "id": "3b8f6a2e-7c41-4d9a-9e15-2f0c8d4b6a73",
  "event_type": "payment_Success",
  "operation_type": "payment",
  "status": "Success",
  "amount": "150.00",
  "currency": "MXN",
  "country": "MX",
  "client_reference": "ORD-001",
  "transaction_id": "1465",
  "payment_method_type": "GOOGLE_PAY",
  "decline_code": null,
  "decline_reason": null,
  "created": "2026-11-13T18:20:41Z",
  "metadata": { "external_id": "ORD-001" },
  "action": "MODIFY"
}

• event_type sigue siendo payment_<estado>. Un pago rechazado termina como Declined, igual que un pago con tarjeta rechazado: ofrece al comprador otro método de pago.
• Si tu sistema valida payment_method_type contra una lista cerrada, agrega GOOGLE_PAY.
• Cada evento y campo está en el catálogo de eventos, y un handler que los verifica y confirma está en Escuchar webhooks.

Antes de completar el pedido, confirma el resultado desde tu servidor. Con Hosted Checkout, consulta la sesión y lee su transaction_status. Con un id de transacción (el id del webhook, el direct_transaction_id de una sesión o el que recibe tu integración con el Web SDK), consulta la transacción:

curl 'https://stage.tonder.io/api/v1/transactions/3b8f6a2e-7c41-4d9a-9e15-2f0c8d4b6a73/' \
  -H 'Authorization: Token YOUR_TEST_API_KEY'

curl 'https://app.tonder.io/api/v1/transactions/3b8f6a2e-7c41-4d9a-9e15-2f0c8d4b6a73/' \
  -H 'Authorization: Token YOUR_API_KEY'

{
  "id": "3b8f6a2e-7c41-4d9a-9e15-2f0c8d4b6a73",
  "operation_type": "payment",
  "status": "Success",
  "amount": 150.00,
  "currency": "MXN",
  "client_reference": "ORD-001",
  "payment_method_type": "GOOGLE_PAY",
  "created_at": "2026-11-13T18:20:35Z",
  "updated_at": "2026-11-13T18:20:41Z"
}

Los reembolsos y contracargos funcionan como con tarjeta: consulta Reembolsos. Si los pagos siguen fallando, contacta a soporte.

Pruebas

• En el sandbox de Tonder, Google Pay corre en el ambiente de pruebas de Google: Google entrega tokens de prueba y no se cobra ninguna tarjeta real.
• El comprador de prueba necesita una sesión de Google iniciada en el navegador. Para ver las tarjetas de prueba de Google en la hoja de pago, únete al grupo indicado en la suite de tarjetas de prueba de Google.
• La suite de tarjetas de prueba de Google no tiene tarjetas propias del procesador de Tonder, así que pregunta a tu representante qué resultados devuelve el sandbox.
• Las tarjetas guardadas en la cuenta (PAN_ONLY) pasan por 3DS. En sandbox la página de 3DS es simulada.

Checklist previo a producción

• La aprobación de Google para tu negocio, confirmada por tu representante.
• Dominios enviados a Tonder y registrados.
• Google Pay habilitado en tu cuenta de producción.
• Un pago de prueba aprobado en sandbox.

Siguientes pasos