onShippingAddressChanged se invoca cada vez que el comprador selecciona o cambia la dirección de envío en la hoja de pago de la wallet, incluida la dirección predeterminada de la wallet cuando se abre la hoja. El SDK entrega la dirección censurada y aplica en vivo en la hoja lo que devuelvas: nuevos totales, opciones de envío o un error que bloquea el pago hasta que el comprador elija otra dirección. Sobrescribirlo es opcional. Sin él, el flujo de la wallet se comporta exactamente igual que sin callbacks.
Wallets compatibles
Solo flujos de pago. El callback no se dispara para tarjetas ni para ningún otro método de pago.
Qué recibes
Las wallets censuran la dirección hasta que se autoriza el pago, por lo que cualquiera de los campos de la dirección puede estar ausente.
Qué devuelves
UnShippingUpdate, o null (nil en iOS) para conservar lo que la hoja ya muestra. Todos los campos de la actualización son opcionales: omite uno para conservar su valor actual.
Los importes son valores
ShippingAmount (SummaryAmount en Android y React Native): value en la unidad principal de currency (12.34 para USD 12.34). currency debe coincidir con la moneda de la sesión de checkout; una discrepancia invalida toda la actualización. deliveryEstimate es un par from y to de fechas YYYY-MM-DD, que se muestra junto a la opción en iOS 15 y posteriores.
Tiempos
En iOS el SDK no establece un plazo propio, por lo que el único límite de tiempo es el de la wallet: la hoja permanece abierta mientras respondes. Si nunca respondes, se aplica el plazo propio de la wallet, la hoja se cierra y la transacción termina como cancelada.Firma
- Web
- iOS
- Android
- React Native
Web lo conecta dentro de
externalButtons en la configuración de la transacción. El SDK lo llama desde cada botón de Apple Pay y Google Pay que renderiza, incluidos los que montas con getPaymentMethodsViews(). Devuelve la actualización, o null para conservar lo que muestra la hoja. Un manejador que lanza una excepción también conserva los valores actuales.Relacionado
- Escuchar eventos. Los demás controladores informativos.
onStatus. El resultado final de la transacción.- Resumen de controladores. Cómo se conectan los controladores en cada plataforma.