Send autentisert kundeinformasjon
For å autentisere en kundeprofil, må backendserveren din foreta to uavhengige API-kall, som vi anbefaler å kjøre parallelt for bedre ytelse:
-
createCart: Genererer Zonos-handlekurven. For detaljert veiledning, se Sett opp Zonos Checkout-delen innenfor dokumentasjonen for egendefinert integrasjon. -
checkoutCustomerProfileAuthenticate: Sender og validerer kundens informasjon.
Når du validerer kundesesjonen, må du sørge for at customerId du sender inn i forespørselen stemmer med riktig profil for å vise nøyaktig kundeinformasjon ved kassen. Husk at når du oppretter en handlekurv, bør du ikke inkludere customerId i metadataene, da den vil bli overskrevet.
Etter at kunden er autentisert og bestillingen er plassert, vil customerId være tilgjengelig i order.references når du henter ordredetaljer via order-spørringen, slik at du kan knytte ordren til riktig kunde.
Opprett handlekurv med kundeprofil
Etter at du kaller begge mutasjonene, vil du få følgende tilbake:
-
cartIdfracreateCart-mutasjonen for å generere handlekurven. -
En
oneTimePasswordfracheckoutCustomerProfileAuthenticate-mutasjonen for kundeautentiseringen.
Du kan sende begge disse verdiene i createCartId-tilbakekallet i Zonos.init-funksjonen for å laste inn den oppgitte kundeprofilen i 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 || '', }; } },}Administrer kundeprofiler
Første gang du sender inn kundeinformasjon, vil Zonos lagre den oppgitte kundeinformasjonen. Betalingsmetoder lagres sikkert i Stripe. Hver gang nye adresse- eller betalingsmetodedetaljer sendes inn, blir de lagt til kundens profil.
Adresser og betalingsmetoder kan bare legges til – eksisterende kan ikke redigeres eller fjernes. En kundes navn, e-post og telefonnummer kan oppdateres med checkoutCustomerUpsert.
Opprett eller oppdater en profil uten en kjøper
checkoutCustomerProfileAuthenticate krever at kjøperen er til stede, siden mutasjonen utsteder et engangspassord for den aktuelle betalingsøkten. Når du vil opprette eller oppdatere en profil utenfor en betalingsøkt – for eksempel ved å laste inn kundelisten din på forhånd, synkronisere profilendringer fra ditt eget system, eller legge til skattefritak før en kundes første bestilling – bruker du checkoutCustomerUpsert i stedet.
mutation checkoutCustomerUpsert($input: CheckoutCustomerProfileInput!) { checkoutCustomerUpsert(input: $input) { customerId email name phone locations { administrativeArea countryCode line1 line2 locality postalCode } }}Profiler matches via customerId, så gjentatte kall oppdaterer den samme profilen i stedet for å opprette duplikater. Det er trygt å kjøre dette mot hele kundelisten din etter en fast tidsplan.
Tre ting du bør vite om hvordan oppdateringer fungerer:
- Utelatte felt forblir urørt. Hvis du bare sender
name, oppdateres navnet, mens e-post og telefon forblir som de var. - Verdier kan ikke fjernes. Å sende en tom verdi behandles på samme måte som å utelate feltet, så det finnes ingen måte å fjerne et navn, en e-post eller et telefonnummer som allerede er satt.
- Adresser legges bare til. En adresse som allerede finnes på profilen, blir ikke duplisert, og adresser som utelates fra forespørselen, blir ikke fjernet.
Kundeprofiler
Forhåndslast gjentakende kjøperinformasjon inn i Zonos Checkout.
Kundeprofiler forenkler betalingsopplevelsen din ved å la kunder med en konto forhåndslaste adresse og betalingsinformasjon.
Denne funksjonen er for øyeblikket kun tilgjengelig for egendefinerte API-integrasjoner. Denne funksjonen er ennå ikke tilgjengelig for kjøpmenn som bruker Checkout-plugins.
Hvis du selger til forhandlere, offentlige etater eller ideelle organisasjoner, kan du også synkronisere skattefritaksattestene deres til en kundeprofil.