Saltar al contenido principal

Google Pay

Google Pay permite cobrar con las tarjetas que el comprador tiene guardadas en su cuenta de Google, desde Chrome y dispositivos Android. Hay dos maneras de aceptarlo:

  • Checkout de ONVO: activá Google Pay en el Dashboard y el botón aparece en tu Checkout, sin código.
  • Tu propio sitio o app: integrá Google Pay con tu propia cuenta de Google, convertí el pago en un método de pago de ONVO y cobrá con intenciones de pago.

Google Pay acepta las mismas redes de tarjeta que tu cuenta.

Referencia API relacionada​

PasoReferenciaPayloads
Crear el método de pagoPOST /v1/confirmation-tokensSolicitud · Respuesta
Crear la intenciónPOST /v1/payment-intentsSolicitud · Respuesta
Confirmar la intenciónPOST /v1/payment-intents/{id}/confirmSolicitud · Respuesta

Antes de empezar​

  • Activá Google Pay en el Dashboard, en Configuración → Métodos de pago. Requiere pagos con tarjeta activos, y el interruptor aplica por modo: prueba y producción se activan por separado.
  • Si no ves Google Pay entre tus métodos de pago, contactá a soporte para que lo habiliten en tu cuenta.
  • El botón aparece en Chrome y en dispositivos Android cuando el comprador tiene una tarjeta compatible en su cuenta de Google.

Checkout de ONVO (sin código)​

Si cobrás con Checkout, basta con activar Google Pay en el Dashboard. ONVO ya está registrado ante Google para su Checkout, así que el botón aparece sin que tengas que registrar nada. No necesitás nada más de esta guía.

Google Pay en tu propio sitio o app​

Cuatro pasos: registrá tu comercio ante Google, configurá Google Pay con ONVO como pasarela, convertí la respuesta de Google en un método de pago de ONVO y cobrá desde tu servidor con una intención de pago.

1. Registrá tu comercio ante Google​

En tu propio sitio o app, el comercio ante Google sos vos, no ONVO:

  • Registrate en la Google Pay & Wallet Console como comercio y aceptá los términos de Google Pay. Google te asigna un ID de comercio de Google (merchantId).
  • Para producción, creá la integración de Google Pay en la consola. Elegí el tipo de integración Gateway y ONVO como procesador de pagos.
  • Cargá cada dominio completo donde vas a mostrar el botón, o el paquete de tu app Android, junto con las capturas de tu flujo de compra que Google pide. ejemplo.com y tienda.ejemplo.com son dos dominios.
  • Enviá la integración a aprobación. Google la revisa manualmente antes de habilitar el acceso a producción, así que pedila con tiempo.
  • Mientras desarrollás, usá el entorno TEST de Google, que no requiere registro ni aprobación.

Los requisitos y el proceso de aprobación los define Google; consultá su guía de acceso a producción para sitios web o para apps Android.

Si tu cuenta tiene Google Pay entre sus métodos de pago, ONVO ya acepta credenciales de Google desde tu propio sitio o app. Pedí a soporte de ONVO que te confirme el ID de tu cuenta de ONVO, que vas a usar en el paso siguiente.

2. Configurá Google Pay con ONVO como pasarela​

En la solicitud de Google Pay, indicá onvopay como pasarela y el ID de tu cuenta de ONVO como gatewayMerchantId:

const cardPaymentMethod = {
type: "CARD",
parameters: {
allowedAuthMethods: ["PAN_ONLY", "CRYPTOGRAM_3DS"],
allowedCardNetworks: ["MASTERCARD", "VISA", "AMEX"],
},
tokenizationSpecification: {
type: "PAYMENT_GATEWAY",
parameters: {
gateway: "onvopay",
gatewayMerchantId: "<ID_DE_TU_CUENTA_ONVO>",
},
},
};

const paymentsClient = new google.payments.api.PaymentsClient({
environment: "TEST", // "PRODUCTION" con tu acceso aprobado y llaves live de ONVO
});

const paymentData = await paymentsClient.loadPaymentData({
apiVersion: 2,
apiVersionMinor: 0,
allowedPaymentMethods: [cardPaymentMethod],
merchantInfo: {
merchantId: "<TU_ID_DE_COMERCIO_DE_GOOGLE>",
merchantName: "Mi tienda",
},
transactionInfo: {
totalPriceStatus: "FINAL",
totalPrice: "5000.00",
currencyCode: "CRC",
countryCode: "CR",
},
});
  • ONVO verifica que cada credencial de Google venga emitida para el ID de tu cuenta. Una credencial emitida para otra cuenta se rechaza.
  • Anunciá solo las redes de tarjeta que acepta tu cuenta.
  • Llamá loadPaymentData desde la interacción del comprador con el botón de Google Pay, siguiendo las pautas de marca de Google.

3. Creá el método de pago en ONVO​

Enviá la respuesta de Google (paymentData) a ONVO sin modificar, parsear ni registrar en logs el token cifrado de paymentMethodData.tokenizationData.token.

En el navegador, con ONVO.js y tu llave pública:

<script src="https://js.onvopay.com/v1/"></script>
<script>
const onvo = ONVO("onvo_live_publishable_key_...");

// Llamala desde el click del botón de Google Pay, con la respuesta completa
// de loadPaymentData.
async function payWithGooglePay(paymentData) {
const { paymentMethodId } = await onvo.createGooglePayPaymentMethod({
paymentData,
});

// Enviá el paymentMethodId a tu propio servidor: esta ruta es tuya, no de ONVO.
// Tu servidor crea y confirma la intención con tu llave secreta (paso 4).
const response = await fetch("/orders/1001/pay", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ paymentMethodId }),
});
return response.json();
}
</script>

Desde tu servidor (por ejemplo, desde una app Android que envía paymentData a tu backend), con tu llave secreta:

curl https://api.onvopay.com/v1/confirmation-tokens \
-X POST \
-H "Authorization: Bearer $ONVO_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "google_pay",
"payload": {
"apiVersion": 2,
"apiVersionMinor": 0,
"paymentMethodData": {
"type": "CARD",
"description": "Visa •••• 1234",
"info": { "cardNetwork": "VISA", "cardDetails": "1234" },
"tokenizationData": {
"type": "PAYMENT_GATEWAY",
"token": "<tokenizationData.token de Google, sin modificar>"
}
}
},
"customer": { "name": "Ana Pérez", "email": "ana@ejemplo.com" }
}'
{
"paymentMethodId": "cl502zv0d0127ebdp3zt27651",
"cardWalletId": "cm2wal3t0000108l5c6r1h2kq"
}
  • Usá los valores reales de la respuesta de Google. Si Google retorna info.cardFundingSource o info.assuranceDetails, podés enviarlos; los demás campos no se aceptan.
  • customer es opcional. ONVO.js no reenvía el correo ni las direcciones que Google haya recolectado: asociá el cliente desde tu servidor si lo necesitás.
  • Crear el método de pago no cobra al comprador.
  • Si usás el monitoreo de fraude, llamá onvo.startSignalSession({ paymentIntentId }) antes de confirmar la intención, igual que con tarjetas.

4. Cobrá desde tu servidor​

Creá la intención de pago con tu llave secreta. El monto va en la unidad mínima de la moneda: 500000 representa ₡5,000.00 y debe coincidir con el total de la hoja de Google Pay (totalPrice: "5000.00" en el ejemplo anterior).

curl https://api.onvopay.com/v1/payment-intents \
-X POST \
-H "Authorization: Bearer $ONVO_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 500000,
"currency": "CRC",
"description": "Orden #1001"
}'

Confirmá la intención con el paymentMethodId:

curl https://api.onvopay.com/v1/payment-intents/$PAYMENT_INTENT_ID/confirm \
-X POST \
-H "Authorization: Bearer $ONVO_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"paymentMethodId": "cl502zv0d0127ebdp3zt27651"
}'

Manejá el resultado como cualquier intención de pago. Si status es succeeded, el pago está aprobado. Si la intención requiere autenticación (requires_action), presentala con onvo.handleNextAction({ paymentIntentId }), como se explica en 3D Secure. Si la confirmación falla, la intención vuelve a requires_payment_method con el detalle en lastPaymentError. Verificá el estado final de la intención en tu servidor antes de entregar la orden.

Identificá un pago con Google Pay​

La intención de pago indica que el cobro vino de Google Pay en paymentMethod.card.wallet:

{
"paymentMethod": {
"type": "card",
"card": {
"brand": "Visa",
"last4": "1234",
"wallet": { "type": "google_pay" }
}
}
}

Cuando el pago no vino de un wallet, wallet es null.

Tarjetas de dispositivo​

Con CRYPTOGRAM_3DS, Google puede entregar una tarjeta de dispositivo: un número de tarjeta propio del teléfono que viene con un criptograma que ya autentica el pago. ONVO decide cómo cobrarla según tu cuenta; no tenés que configurar nada. Cuando ONVO cobra con el criptograma:

  • El método de pago es de un solo uso: sirve para confirmar una sola intención.
  • ONVO cobra con el criptograma y el indicador de comercio electrónico (ECI) que entrega Google, sin un paso adicional de 3D Secure.
  • El last4 de la intención es el del número del dispositivo, no el de la tarjeta física del comprador. La marca (brand) sí es la real.

Por eso, tratá cada método de pago de Google Pay como de un solo uso: confirmá la intención de inmediato, mientras la credencial de Google sigue vigente, y si necesitás reintentar, pedí al comprador un pago nuevo en Google Pay.

Importante​

No modifiqués la respuesta de Google

Enviá paymentMethodData.tokenizationData.token exactamente como lo entrega Google, como texto JSON dentro de la solicitud: no lo parseés, no lo codifiqués en Base64 y no lo guardés en logs. Las credenciales de Google expiran: creá el método de pago y confirmá la intención sin demoras.

Errores comunes y su causa:

CódigoCausa
payment_methods.google_pay_not_enabledGoogle Pay no está habilitado para tu cuenta, o los pagos con tarjeta o Google Pay están desactivados en ese modo.
payment_methods.invalid_google_pay_tokenLa credencial de Google es inválida, expiró o fue emitida para otra cuenta. Pedí un pago nuevo en Google Pay.
payment_methods.google_pay_unavailableGoogle Pay no está disponible en este momento. Reintentá más tarde; si persiste, contactá a soporte.
google_pay_token_replayedEsa tarjeta de dispositivo ya se usó; pedí un pago nuevo en Google Pay.
google_pay_credential_unavailableEl método de pago de un solo uso ya se usó o ya no tiene credencial; creá uno nuevo.
google_pay_unsupported_networkONVO no acepta tarjetas de dispositivo de esa red; pedí al comprador otra tarjeta.
google_pay_not_supported_by_processorTu cuenta no puede cobrar esa tarjeta de dispositivo en este momento; pedí un pago nuevo en Google Pay y, si persiste, contactá a soporte.

Pruebas​

En modo de prueba, con llaves onvo_test_ y el entorno TEST de Google, los cargos se simulan y no se mueve dinero. No necesitás registro ni aprobación de Google para probar. En TEST, Google entrega tarjetas de prueba aunque el comprador elija una tarjeta real de su cuenta.

Para producción usá el entorno PRODUCTION de Google con tu ID de comercio aprobado y llaves onvo_live_. Las llaves live funcionan cuando tu cuenta de ONVO está activada.