Coletar endereços físicos e números de telefone

Para coletar endereços completos para cobrança ou envio, use o Address Element. Por exemplo, pode ser necessário coletar um endereço de cobrança completo para calcular impostos. O Payment Element coleta apenas os dados do endereço de cobrança necessários para concluir o pagamento, mas você pode configurá-lo para coletar outros dados de cobrança.

Outros motivos pelos quais você pode querer usar o Address Element:

• Para coletar números de telefone do cliente
• Para habilitar o preenchimento automático
• Para preencher os dados de cobrança no Payment Element passando um endereço de entrega

A Stripe combina os dados de endereço coletados e a forma de pagamento para criar um PaymentIntent.

Criar um Address Element

Ao criar um Address Element, você especifica um modo shipping ou billing. O modo Address Element determina se o endereço de entrega ou cobrança é passado para confirmar o PaymentIntent.

Quando você criar um Address Element, especifique se deseja usá-lo no modo de envio ou cobrança.

const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx');

const appearance = { /* appearance */ };
const options = { mode: 'shipping' };
const elements = stripe.elements({ 
clientSecret, appearance });
const addressElement = elements.create('address', options);
addressElement.mount('#address-element');

Usar o Address Element com outros elementos

Você pode coletar endereços de entrega e cobrança usando vários Address Elements, um de cada modo, em sua página.

Se você precisa coletar endereços de entrega e cobrança e só quer usar um Address Element, use o Address Element no modo de envio e use o Payment Element para coletar somente os dados necessários do endereço de cobrança.

Ao usar o Address Element com outros elementos, alguns comportamentos automáticos são esperados ao confirmar o PaymentIntent ou SetupIntent. O Address Element valida a integridade ao confirmar o PaymentIntent ou SetupIntent e exibe erros para cada campo se houver erros de validação.