Envie informações autenticadas do cliente
Para autenticar um perfil de cliente, seu servidor backend deve fazer duas chamadas API independentes, que recomendamos executar em paralelo para melhor desempenho:
-
createCart: Gera o carrinho Zonos. Para obter orientações detalhadas, consulte a seção Configurar Zonos Checkout na documentação de integração personalizada. -
checkoutCustomerProfileAuthenticate: Envia e valida as informações do cliente.
mutation checkoutCustomerProfileAuthenticate($input: CheckoutCustomerProfileAuthenticateInput!) { checkoutCustomerProfileAuthenticate(input: $input) { email customerId organizationId name phone locations { administrativeArea countryCode locality line1 line2 postalCode } oneTimePassword }}Ao validar a sessão do cliente, certifique-se de que o customerId que foi passado na solicitação corresponde ao perfil correto para exibir informações precisas do cliente na finalização da compra. Observe que ao criar um carrinho, você não deve incluir customerId nos metadados, pois será substituído.
Depois que o cliente for autenticado e o pedido for feito, o customerId estará disponível em order.references ao recuperar os detalhes do pedido usando a consulta do pedido, permitindo associar o pedido ao cliente correto.
Crie carrinho com perfil de cliente
Depois de chamar ambas as mutações, você obterá o seguinte:
-
cartIdda mutaçãocreateCartpara gerar o carrinho. -
Um
oneTimePasswordda mutaçãocheckoutCustomerProfileAuthenticatepara autenticação do cliente.
Você pode passar os dois valores no callback createCartId na função Zonos.init para carregar as informações do perfil do cliente fornecidas no Checkout.
Zonos.init({ ... checkoutSettings: { ... createCartId: async () => { const result = await fetch( 'https://api.merchant.com/api/get-cart-info', { body: JSON.stringify(payload), method: 'POST', }, ); const json = await result.json(); return { cartId: json.cartId, customerAuthenticationToken: json.customerProfileAuthenticate ?.checkoutCustomerProfileAuthenticate.oneTimePassword || '', }; } },}Gerencie perfis de clientes
Na primeira vez que você enviar informações do cliente, a Zonos armazenará as informações fornecidas. Os métodos de pagamento serão armazenados de forma segura no Stripe. Cada vez que novos dados de endereço ou forma de pagamento forem passados, eles serão adicionados ao perfil do cliente.
Endereços e formas de pagamento só podem ser adicionados—os já existentes não podem ser editados ou removidos. O nome, e-mail e telefone de um cliente podem ser atualizados com checkoutCustomerUpsert.
Crie ou atualize um perfil sem um comprador
checkoutCustomerProfileAuthenticate exige a presença do comprador, já que emite uma senha de uso único para essa sessão de checkout. Quando você quiser criar ou atualizar um perfil fora de um checkout—carregando sua lista de clientes com antecedência, sincronizando alterações de perfil a partir do seu próprio sistema ou anexando isenções fiscais antes do primeiro pedido de um cliente—use checkoutCustomerUpsert.
mutation checkoutCustomerUpsert($input: CheckoutCustomerProfileInput!) { checkoutCustomerUpsert(input: $input) { customerId email name phone locations { administrativeArea countryCode line1 line2 locality postalCode } }}Os perfis são combinados pelo customerId, portanto, chamar isso repetidamente atualiza o mesmo perfil em vez de criar duplicatas. É seguro executar isso em toda a sua lista de clientes de forma programada.
Três coisas a saber sobre como as atualizações são aplicadas:
- Campos omitidos permanecem inalterados. Enviar apenas
nameatualiza o nome e mantém o e-mail e o telefone como estavam. - Os valores não podem ser apagados. Enviar um valor vazio é tratado da mesma forma que omitir o campo, portanto não há como remover um nome, e-mail ou telefone depois de definido.
- Os endereços só são adicionados. Um endereço que já existe no perfil não é duplicado, e os endereços deixados de fora da solicitação não são removidos.
Perfis de clientes
Pré-carregue as informações do comprador recorrente no Zonos Checkout.
Os perfis de cliente simplificam sua experiência de checkout, permitindo que os clientes com uma conta preencham previamente seu endereço e detalhes de pagamento.
No momento, esse recurso está disponível apenas para integrações personalizadas da API. Este recurso ainda não está disponível para comerciantes que usam plug-ins Checkout.
Se você vende para revendedores, órgãos públicos ou organizações sem fins lucrativos, também é possível sincronizar seus certificados de isenção fiscal com um perfil de cliente.