Square

Vad du behöver

Varför vi ber om varje fält

Access token

Auktoriserar skapandet av checkout-länken, så att debiteringen körs genom ditt konto.

Webhook signature key

Bevisar att en inkommande webhook genuint är från Square, så att ingen kan förfalska en "paid"-händelse. Det är ett separat värde från access token.

Location ID

Talar om för Square vilken plats som tar emot pengarna, och sätter checkout-valutan. Inte hemlig.

Success and Cancel URL

Vanliga inställningar: dit köparen landar efter att ha betalat eller backat ur. Inte hemliga.

Sätt upp

1. Öppna Square Developer-instrumentpanelen

   Logga in på developer.squareup.com. Varje applikation har sina egna inloggningsuppgifter, och en gratis Sandbox skapas bredvid den för testning. Den här guiden går igenom Sandbox; Live-flödet är identiskt, bara byt Sandbox / Production-omkopplaren och använd dina produktionsuppgifter. För att skapa en ny app klickar du på +-panelen på skärmen Applications.

   ⤢
2. Namnge din applikation

   Ge applikationen ett namn du känner igen (till exempel "Coin Moebius") och klicka sedan på Nästa.

   ⤢
3. Kopiera din access token

   Öppna appen och gå till Credentials. Bekräfta att Sandbox / Production-omkopplaren högst upp stämmer med den miljö du ställer in. Klicka på kopieringsikonen bredvid Access token och lägg den åt sidan.

   ⤢

   Access token är hemlig, behandla den som ett lösenord. Sandbox och Production har separata tokens, så blanda inte dem.

4. Kopiera ditt Location ID

   I den vänstra menyn öppnar du Locations. Kopiera Location ID för den plats som ska ta emot betalningar. Det sätter utcheckningsvalutan, så välj den vars valuta du vill debitera i.

   ⤢
5. Öppna Webhooks → Subscriptions

   Square kallar en webhook-endpoint för en "prenumeration." I den vänstra menyn expanderar du Webhooks, öppnar Subscriptions och klickar på Add subscription.

   ⤢
6. Lägg till prenumerationen och välj händelser

   Ge den ett namn (som "coin-moebius"). I Notification URL klistrar du in din projekts Square-webhookadress (nedan). Under Events söker du efter och bockar i de händelser Coin Moebius lyssnar på och klickar på Spara.

   • Engångsbetalningar: payment.created, payment.updated, refund.created, refund.updated, dispute.created, dispute.state.updated.
   • Prenumerationer (bara om du säljer dem): subscription.created, subscription.updated, subscription.canceled, subscription.deactivated, invoice.payment_made, invoice.scheduled_charge_failed. Om du inte fakturerar på återkommande basis hoppar du över dessa.

   https://api.coinmoebius.com/webhook/square/<your project id>

   ⤢

   Ditt projekt-id finns under projektnamnet i Coin Moebius-instrumentpanelen; infoga det i adressen ovan. Extra händelser är ofarliga, vi ignorerar allt vi inte använder. Det anslutna leverantörskortet (sista steget) visar samma URL som referens.

7. Öppna prenumerationen du just skapade

   Square sparar prenumerationen och listar den under Webhooks med statusen Aktiverad. Klicka på dess namn för att öppna detaljpanelen där signeringsnyckeln finns.

   ⤢
8. Kopiera Signature key

   I prenumerationens Egenskaper-panel klickar du på kopieringsikonen bredvid Signature key. Det är värdet Coin Moebius använder för att bekräfta att varje webhook verkligen kom från Square. Det existerar bara när prenumerationen har skapats, vilket är varför webhooken kom före anslutningssteget.

   ⤢
9. Tillbaka i Coin Moebius: Lägg till leverantör → Square

   Öppna fliken Leverantörer i ditt projekt, klicka på Lägg till leverantör, välj Anslut en tjänst och välj Square. Ange din Success URL och Cancel URL. På Live-fliken klistrar du in din Access token, Webhook signature key och Location ID och klickar sedan på Spara. Ställer du in med sandbox-uppgifter först? Klistra in dem på Test-fliken istället och lägg sedan till live-uppgifter senare via Redigera.

   ⤢
10. Du är ansluten

    Square visas nu på fliken Leverantörer med datumet det anslöts. Kortet visar samma webhook-URL som du klistrade in i Square, plus Redigera och Koppla från. Använd testlägesomkopplaren för att köra en sandbox-beställning från början till slut innan du går live.

    ⤢

    Sandbox-kort debiterar aldrig ett riktigt kort. Använd kort 4111 1111 1111 1111, CVV 111, valfritt framtida utgångsdatum, valfritt giltigt postnummer (till exempel 94103).

Efter att du anslutit

Kör en testbetalning innan du går live:

1. Skapa en produkt och ställ in dess Environment till Testing. Det kör produkten på dina sandbox-uppgifter, så att du kan lägga en hel beställning utan att flytta pengar. (Om du hoppade över sandbox-uppsättningen faller en Testing-produkt tillbaka till live, så lägg till den först.)
2. Placera köpknappen på en sida (en lokal HTML-fil fungerar) som pekar mot ditt projekt.
3. Slutför checkouten med sandbox-testkortet ovanifrån.
4. Öppna Transaktioner-fliken. En ny rad dyker upp, märkt Testing. När dess status når succeeded fungerar både dina uppgifter och din webhook från början till slut.

Byt produktens Environment till Live när du är redo för riktiga betalningar.

Felsökning

Börja med Verify. I instrumentpanelen, klicka på Verify (eller Verify test credentials) för att kontrollera din access token och plats.

Verify misslyckas.

Kopiera om access token och Location ID. Production och Sandbox har separata tokens, så blanda inte dem.

Signaturverifiering misslyckas, eller beställningen förblir väntande.

Square signerar över den exakta notification-URL:en plus kroppen. URL:en du registrerar i Square måste matcha din webhook-URL tecken för tecken, utan avslutande snedstreck och utan extra query-sträng. Kopiera sedan om signature key från samma endpoint.

Bekräfta det från början till slut.

Square Developer Console → Webhooks → your subscription → Send Test Event, och se sedan beställningen uppdateras.

Bra att veta

Valutan följer platsen. Checkouten debiterar i valutan för platsen vars id du anger.

Rotera hemligheter. Rotera access token eller signature key när som helst, klistra sedan in det nya värdet. Hemliga fält förblir tomma vid redigering.

Frågor? Join our Discord