Square

A Square beágyazott kártyás űrlapot ad, átirányítás nélkül. Támogatja az ismétlődő előfizetéseket, és a webhookokon keresztül az automatikus visszatérítést is. Az Apple Pay, a Google Pay és a Cash App Pay jelenleg ki van kapcsolva, később lesz elérhető: a kártyás fizetés és az előfizetések teljes körűen működnek.

1. Aktiválás a FluentCartban

A Square prémium kiegészítő, amelyhez FluentCart Pro kell.

1. Nyisd meg a Beállítások → Fizetési beállítások oldalt.
2. Keresd meg a Square sorát, és kattints a Kezelés gombra.
3. A kiegészítő oldalán kattints a Kiegészítő telepítése gombra.

https://minta-bolt.hu/wp-admin/admin.php?page=fluent-cart

Az aktiválás után a Square beállítóoldala nyílik meg. Két fül van rajta: Test credentials és Live credentials; kezdd a teszttel. A teszt módhoz négy értéket kell megadnod: Test Application ID, Test Access Token, Test Location ID és Test Webhook Signature Key. Az oldal a webhook URL-t is mutatja, amelyet a Square-be kell beírnod.

2. Alkalmazás a Square fejlesztői felületén

1. Jelentkezz be a Square Developer Dashboardra.
2. Az Applications oldalon kattints a + kártyára új alkalmazás létrehozásához.
3. A Name your application ablakban add meg a nevét (például „FluentCart”), kattints a Next gombra, és fejezd be az alkalmazás létrehozását a további lépések szerint.

3. A hitelesítő adatok kimásolása

1. Nyisd meg az új alkalmazást, és ellenőrizd, hogy felül a Sandbox kapcsoló van kiválasztva (élesítéskor váltasz Production-re).
2. A bal oldali sávban kattints a Credentials pontra.
3. A másolás ikonnal másold ki a Sandbox Application ID értékét (ez a Test Application ID mezőbe kerül) és a Sandbox Access token értékét (a Test Access Token mezőbe; szükség esetén kattints előbb a Replace gombra).

A Sandbox adatokkal valódi pénz nélkül próbálhatod ki a tranzakciókat.

A Location ID

A Square „helyszínekkel” jelöli a rendelések forrását.

1. Az alkalmazásban kattints a bal oldali sáv Locations pontjára.
2. Keresd meg a Default Test Account (Main) sort.
3. Másold ki a Location ID oszlop értékét, és írd be a Test Location ID mezőbe.

4. Webhook a Square-ben

A webhookok révén kap a FluentCart értesítést a sikeres fizetésekről, a visszatérítésekről és az előfizetések megújításáról.

1. A FluentCart Square-oldalán, az űrlap alján másold ki a Webhook URL értékét.
2. A Square Developer Dashboard bal oldali sávjában nyisd ki a Webhooks részt, és kattints a Subscriptions pontra.
3. Kattints az Add subscription gombra.
4. Az Add a webhook subscription űrlapon:
   • Subscription name: ismerhető név, például FluentCart-WH.
   • Notification URL: illeszd be a másolt webcímet.
   • API version: hagyd az alapértelmezett (legújabb) értéken.
5. Az Events résznél keresd meg és jelöld be az öt szükséges eseményt: payment.updated, refund.updated, subscription.updated, invoice.payment_made, invoice.scheduled_charge_failed.
6. A jobb felső sarokban kattints a Save gombra. A webhook az Enabled állapottal és 5 kiválasztott eseménnyel jelenik meg a listában.

Az aláírókulcs

1. Kattints a listában a létrehozott webhookra, hogy megnyíljon a részletek panelje.
2. Másold ki a Signature key mező értékét a másolás ikonnal.
3. Illeszd be a FluentCart Test Webhook Signature Key mezőjébe.

5. Aktiválás és mentés

1. Ellenőrizd, hogy a Test credentials fülön mind a négy mező ki van töltve.
2. Kapcsold be a jobb felső sarokban a Fizetés aktiválása kapcsolót: így a Square elérhető lesz a pénztárban.
3. Kattints a lap alján a Beállítások mentése gombra.

Teszt módban próbáld ki egy Square-tesztkártyával, hogy minden jól működik-e.

6. Élesítés

1. A Square Developer Dashboardon váltsd a kapcsolót Sandbox-ról Production-re.
2. Ismételd meg a 3. és a 4. lépést, hogy megkapd az éles Application ID-t, az Access Tokent, a Location ID-t és a Webhook Signature Keyt.
3. A FluentCart Square-oldalán nyisd meg a Live credentials fület, írd be az éles adatokat, és kattints a Beállítások mentése gombra.
4. A Beállítások → Áruház beállításai oldalon állítsd éles módra a Rendelési mód beállítást.