Saltar al contenido principal
Los pagos recurrentes de Google Pay siguen los mismos dos pasos que las tarjetas: una transacción iniciada por el cliente (CIT) que guarda el instrumento en la bóveda, y luego transacciones iniciadas por el comercio (MIT) sobre el vaulted_token resultante. La matriz completa de reason y usage está en Stored credentials.

Transacción iniciada por el cliente (CIT)

En la CIT, envía vault_on_success: true y coloca stored_credentials dentro de detail.wallet, porque en este punto el método de pago sigue siendo la billetera:
Los parámetros clave de una CIT son:
  • vault_on_success: true: guarda en la bóveda la tarjeta descifrada como un registro CARD con parent_payment_method_type: GOOGLE_PAY y devuelve su vaulted_token en la respuesta del pago. customer_payer.id debe hacer referencia a un cliente existente (créalo primero con Create Customer). Sin este parámetro, el pago igualmente es exitoso, pero no se guarda nada en la bóveda: la respuesta incluye un vaulted_token vacío y ningún error.
  • detail.wallet.stored_credentials.usage: "FIRST": marca la primera transacción de la serie recurrente. Yuno almacena en el registro guardado el network_transaction_id devuelto por el proveedor.
No coloques stored_credentials dentro de detail.card en la CIT. No se valida para un pago con billetera y puede descartarse, lo que deja el registro guardado sin los indicadores de credenciales almacenadas y sin network_transaction_id.
El vaulted_token se devuelve únicamente en la respuesta del pago de la CIT. Los instrumentos de billetera guardados en la bóveda no se incluyen intencionalmente en Retrieve Enrolled Payment Methods, por lo que debes almacenar el token de tu lado cuando la CIT sea exitosa.

Transacción iniciada por el comercio (MIT)

Los cobros posteriores usan el vaulted_token como una tarjeta almacenada. No se necesita ningún token de Google Pay ni ninguna sesión de checkout:
Los parámetros clave de una MIT son:
  • vaulted_token: el token devuelto en la respuesta de la CIT.
  • detail.card.stored_credentials.usage: "USED": marca una transacción posterior de la serie. Yuno adjunta automáticamente el network_transaction_id de la CIT.