# Square

> A Square prémium kiegészítő aktiválása, az alkalmazás, a hitelesítő adatok és a webhook beállítása.

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.

![A Square fizetési átjáró oldala a telepítés gombbal](./kepek/fizetes-square-telepites.webp)

*A Square fizetési átjáró oldala a telepítés gombbal* (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.