Pré-carregue as informações de compradores recorrentes no Zonos Checkout.
Os perfis de cliente simplificam a sua experiência de checkout, permitindo que os clientes com uma conta pré-carreguem o seu endereço e os seus dados de pagamento.
De momento, este recurso está disponível apenas para integrações personalizadas via API. Este recurso ainda não está disponível para comerciantes que usam plug-ins do Checkout.
Se vende para revendedores, organismos públicos ou organizações sem fins lucrativos, também pode sincronizar os seus certificados de isenção fiscal com um perfil de cliente.
1
Envie informações autenticadas do cliente
Para autenticar um perfil de cliente, o seu servidor backend deve fazer duas chamadas de API independentes, que recomendamos executar em paralelo para melhor desempenho:
createCart: Gera o carrinho Zonos. Para obter orientações detalhadas, consulte a secção Configurar o Zonos Checkout na documentação de integração personalizada.
checkoutCustomerProfileAuthenticate: Envia e valida as informações do cliente.
Ao validar a sessão do cliente, certifique-se de que o customerId que passa no pedido corresponde ao perfil correto, para que sejam apresentadas informações exatas do cliente no checkout. Tenha em conta que, ao criar um carrinho, não deve incluir o customerId nos metadados, pois será substituído.
Depois de o cliente ser autenticado e o pedido ser efetuado, o customerId estará disponível em order.references ao obter os detalhes do pedido através da consulta order, permitindo associar o pedido ao cliente correto.
2
Crie um carrinho com perfil de cliente
Depois de chamar ambas as mutações, obterá o seguinte:
cartId da mutação createCart para gerar o carrinho.
Um oneTimePassword da mutação checkoutCustomerProfileAuthenticate para autenticação do cliente.
Pode passar ambos os valores no callback createCartId da função Zonos.init para carregar no Checkout as informações do perfil de cliente fornecidas.
Na primeira vez que 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. Sempre que forem passados novos dados de endereço ou de método de pagamento, estes serão adicionados ao perfil do cliente.
Os endereços e métodos de pagamento só podem ser adicionados—os existentes não podem ser editados nem removidos. O nome, e-mail e telefone de um cliente podem ser atualizados com checkoutCustomerUpsert.
checkoutCustomerProfileAuthenticate exige a presença do comprador, já que emite uma palavra-passe de utilização única para essa sessão de checkout. Quando quiser criar ou atualizar um perfil fora de um checkout—para carregar antecipadamente a sua lista de clientes, sincronizar alterações de perfil a partir do seu próprio sistema ou anexar isenções fiscais antes do primeiro pedido de um cliente—use checkoutCustomerUpsert.
Os perfis são identificados pelo customerId, pelo que chamá-la repetidamente atualiza o mesmo perfil em vez de criar duplicados. É seguro executá-la periodicamente em toda a sua lista de clientes.
Três coisas a saber sobre como as atualizações são aplicadas:
Campos omitidos permanecem inalterados. Enviar apenas name atualiza 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, pelo que não é possível 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 omitidos no pedido não são removidos.
checkoutCustomerUpsert não devolve um oneTimePassword. Para carregar um perfil no Checkout,
continua a precisar do checkoutCustomerProfileAuthenticate, que emite um para essa sessão.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Perfis de clientes
Perfis de clientes
Pré-carregue as informações de compradores recorrentes no Zonos Checkout.
Os perfis de cliente simplificam a sua experiência de checkout, permitindo que os clientes com uma conta pré-carreguem o seu endereço e os seus dados de pagamento.
De momento, este recurso está disponível apenas para integrações personalizadas via API. Este recurso ainda não está disponível para comerciantes que usam plug-ins do Checkout.
Se vende para revendedores, organismos públicos ou organizações sem fins lucrativos, também pode sincronizar os seus certificados de isenção fiscal com um perfil de cliente.
Envie informações autenticadas do cliente
Para autenticar um perfil de cliente, o seu servidor backend deve fazer duas chamadas de API independentes, que recomendamos executar em paralelo para melhor desempenho:
createCart: Gera o carrinho Zonos. Para obter orientações detalhadas, consulte a secção Configurar o 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) {emailcustomerIdorganizationIdnamephonelocations {administrativeAreacountryCodelocalityline1line2postalCode}oneTimePassword}}Ao validar a sessão do cliente, certifique-se de que o
customerIdque passa no pedido corresponde ao perfil correto, para que sejam apresentadas informações exatas do cliente no checkout. Tenha em conta que, ao criar um carrinho, não deve incluir ocustomerIdnos metadados, pois será substituído.Depois de o cliente ser autenticado e o pedido ser efetuado, o customerId estará disponível em
order.referencesao obter os detalhes do pedido através da consulta order, permitindo associar o pedido ao cliente correto.Crie um carrinho com perfil de cliente
Depois de chamar ambas as mutações, obterá o seguinte:
cartIdda mutaçãocreateCartpara gerar o carrinho.Um
oneTimePasswordda mutaçãocheckoutCustomerProfileAuthenticatepara autenticação do cliente.Pode passar ambos os valores no callback
createCartIdda funçãoZonos.initpara carregar no Checkout as informações do perfil de cliente fornecidas.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 ||'',};}},}Gira perfis de clientes
Na primeira vez que 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. Sempre que forem passados novos dados de endereço ou de método de pagamento, estes serão adicionados ao perfil do cliente.
Os endereços e métodos de pagamento só podem ser adicionados—os existentes não podem ser editados nem removidos. O nome, e-mail e telefone de um cliente podem ser atualizados com
checkoutCustomerUpsert.Crie ou atualize um perfil sem um comprador
checkoutCustomerProfileAuthenticateexige a presença do comprador, já que emite uma palavra-passe de utilização única para essa sessão de checkout. Quando quiser criar ou atualizar um perfil fora de um checkout—para carregar antecipadamente a sua lista de clientes, sincronizar alterações de perfil a partir do seu próprio sistema ou anexar isenções fiscais antes do primeiro pedido de um cliente—usecheckoutCustomerUpsert.mutation checkoutCustomerUpsert($input: CheckoutCustomerProfileInput!) {checkoutCustomerUpsert(input: $input) {customerIdemailnamephonelocations {administrativeAreacountryCodeline1line2localitypostalCode}}}Os perfis são identificados pelo
customerId, pelo que chamá-la repetidamente atualiza o mesmo perfil em vez de criar duplicados. É seguro executá-la periodicamente em toda a sua lista de clientes.Três coisas a saber sobre como as atualizações são aplicadas:
nameatualiza o nome e mantém o e-mail e o telefone como estavam.checkoutCustomerUpsertnão devolve umoneTimePassword. Para carregar um perfil no Checkout, continua a precisar docheckoutCustomerProfileAuthenticate, que emite um para essa sessão.CheckoutCustomerProfileInput
checkoutCustomerUpsert
Esta página foi útil?