Wat u nodig hebt
| Veld | Wat het doet |
|---|---|
| Access token | Laat ons Square aanroepen om de checkout-link aan te maken. Geheim. |
| Webhook signature key | Bevestigt dat een webhook echt van Square kwam. Geheim. |
| Location ID | De Square-locatie die de betaling ontvangt. Stelt de valuta in. |
| Success-URL / Cancel-URL | Waar de koper belandt na het betalen of afhaken. |
Waarom we om elk veld vragen
Access token
Autoriseert het aanmaken van de checkout-link, zodat de afschrijving via uw account loopt.
Webhook signature key
Bewijst dat een inkomende webhook echt van Square is, zodat niemand een "betaald"-event kan vervalsen. Het is een aparte waarde van de access token.
Location ID
Vertelt Square welke locatie het geld ontvangt, en stelt de checkout-valuta in. Niet geheim.
Success- en Cancel-URL
Gewone instellingen: waar de koper belandt na het betalen of afhaken. Niet geheim.
Instellen
- Open het Square Developer-dashboard
Log in op developer.squareup.com. Elke applicatie heeft zijn eigen inloggegevens, en er wordt gratis een Sandbox naast aangemaakt voor testen. Deze gids loopt de Sandbox door; de Live-stroom is identiek, wissel gewoon de schakelaar Sandbox / Production om en gebruik uw productie-inloggegevens. Klik op het +-tegeltje op het scherm Applications om een nieuwe app te maken.
Square Developer → Applications - Geef uw applicatie een naam
Geef de applicatie een naam die u herkent (bijvoorbeeld "Coin Moebius"), klik dan op Next.
Square → Geef uw applicatie een naam - Kopieer uw access token
Open de app en ga naar Credentials. Bevestig dat de schakelaar Sandbox / Production bovenaan overeenkomt met de omgeving die u instelt. Klik op het kopiëericoon naast de Access token en zet hem opzij.
Square → Credentials De access token is geheim, behandel hem als een wachtwoord. Sandbox en Production hebben aparte tokens, haal ze niet door elkaar.
- Kopieer uw Location ID
Open Locations in het linker menu. Kopieer de Location ID van de locatie die betalingen moet ontvangen. Die stelt de afrekenvaluta in, dus kies de locatie waarvan u de valuta wilt berekenen.
Square → Locations - Open Webhooks → Subscriptions
Square noemt een webhook-endpoint een "subscription." Vouw in het linker menu Webhooks uit, open Subscriptions, en klik op Add subscription.
Square → Webhooks → Subscriptions → Add subscription - Voeg de subscription toe en selecteer events
Geef hem een naam (zoals "coin-moebius"). Plak in Notification URL uw Square-webhookadres van het project (hieronder). Zoek en vink vervolgens onder Events de events aan waar Coin Moebius op luistert, en klik op Save.
- Eenmalige betalingen: payment.created, payment.updated, refund.created, refund.updated, dispute.created, dispute.state.updated.
- Abonnementen (alleen als u die verkoopt): subscription.created, subscription.updated, subscription.canceled, subscription.deactivated, invoice.payment_made, invoice.scheduled_charge_failed. Als u niet op terugkerende basis factureert, sla deze dan over.
https://api.coinmoebius.com/webhook/square/<your project id>Square → Add a webhook subscription Uw project-id staat onder de projectnaam in het Coin Moebius-dashboard; voeg het in het bovenstaande adres in. Extra events zijn onschadelijk, we negeren alles wat we niet gebruiken. De verbonden providerkaart (laatste stap) toont dezelfde URL ter referentie.
- Open de subscription die u zojuist aanmaakte
Square slaat de subscription op en vermeld hem onder Webhooks met de status Enabled. Klik op zijn naam om het detailvenster te openen waar de ondertekeningssleutel zich bevindt.
Square → Webhooks → uw subscription (Enabled) - Kopieer de Signature key
Klik in het venster Properties van de subscription op het kopiëericoon naast Signature key. Dit is de waarde die Coin Moebius gebruikt om te bevestigen dat elke webhook echt van Square afkomstig is. Hij bestaat pas zodra de subscription is aangemaakt, wat de reden is dat de webhook voor de verbindingsstap komt.
Square → uw subscription → Signature key - Terug in Coin Moebius: Provider toevoegen → Square
Open in uw project het tabblad Providers, klik op Provider toevoegen, kies Een dienst verbinden, en kies Square. Stel uw Success-URL en Cancel-URL in. Plak op het tabblad Live uw Access token, Webhook signature key en Location ID, klik dan op Opslaan. Wilt u eerst met sandbox-inloggegevens instellen? Plak die dan op het tabblad Test, en voeg live-inloggegevens later toe vanuit Bewerken.
Coin Moebius → Provider toevoegen → Square - U bent verbonden
Square verschijnt nu op uw tabblad Providers met de datum waarop het verbonden werd. De kaart toont dezelfde webhook-URL die u in Square heeft geplakt, plus Bewerken en Verbreken. Gebruik de schakelaar Testmodus om een sandbox-bestelling end-to-end door te lopen voordat u live gaat.
Coin Moebius → Providers → Square (verbonden) Sandbox-kaarten belasten nooit een echte kaart. Gebruik kaart 4111 1111 1111 1111, CVV 111, een willekeurige toekomstige vervaldatum, een willekeurige geldige postcode (bijvoorbeeld 94103).
Nadat u verbindt
Voer één testbetaling uit voordat u live gaat:
- Maak een product aan en zet zijn Omgeving op Testing. Dat draait het product op uw sandbox-inloggegevens, zodat u een volledige bestelling kunt plaatsen zonder geld te verplaatsen. (Als u de sandbox-set oversloeg, valt een Testing-product terug op live, dus voeg hem eerst toe.)
- Plaats de buy button op een pagina (een lokaal HTML-bestand werkt) gericht op uw project.
- Rond de checkout af met de sandbox-testkaart van hierboven.
- Open het tabblad Transacties. Een nieuwe rij verschijnt, gemarkeerd als Testing. Wanneer zijn status succeeded bereikt, werken zowel uw inloggegevens als webhook end-to-end.
Zet de Omgeving van het product op Live wanneer u klaar bent voor echte betalingen.
Problemen oplossen
Begin met Verifiëren. Klik in het dashboard op Verifiëren (of Testinloggegevens verifiëren) om uw access token en locatie te controleren.
Verifiëren mislukt.
Kopieer de access token en Location ID opnieuw. Production en Sandbox hebben aparte tokens, dus haal ze niet door elkaar.
Handtekeningverificatie mislukt, of de bestelling blijft in behandeling.
Square ondertekent over de exacte notification-URL plus de body. De URL die u in Square registreert moet teken voor teken overeenkomen met uw webhook-URL, zonder afsluitende slash en zonder extra query-string. Kopieer daarna de signature key opnieuw van diezelfde endpoint.
Bevestig het end-to-end.
Square Developer Console → Webhooks → uw subscription → Send Test Event, en kijk dan hoe de bestelling bijwerkt.
Goed om te weten
Valuta volgt de locatie. De checkout belast in de valuta van de locatie waarvan u het id opgeeft.
Secrets roteren. Roteer de access token of signature key wanneer u maar wilt, plak dan de nieuwe waarde. Geheime velden blijven leeg bij bewerken.
Vragen? Join our Discord