API: fizetések

A fizetések végpontjaival időpontokhoz, eseményekhez és csomagokhoz tartozó fizetéseket hozhatsz létre, módosíthatsz, kérdezhetsz le, téríthetsz vissza és törölhetsz.

Az API az Elite licenchez tartozik, használatához programozási ismeret kell, a szokásos támogatás nem terjed ki rá. A hitelesítés az Amelia fejlécben küldött API-kulccsal történik (részletek). Az alap útvonal: {{az_oldalad_URL-je}}/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1.

Művelet	Metódus	Útvonal
Fizetés hozzáadása foglaláshoz	POST	/payments
Fizetés módosítása	POST	/payments/{{fizetes_id}}
Egy fizetés lekérése	GET	/payments/{{fizetes_id}}
Fizetések listázása	GET	/payments
Tranzakció összegének lekérése	GET	/payments/transaction/{{fizetes_id}}
Fizetendő összeg kiszámítása	POST	/payments/amount
Fizetési link létrehozása	POST	/payments/link
Visszatérítés	POST	/payments/refund/{{fizetes_id}}
Fizetés törlése	POST	/payments/delete/{{fizetes_id}}

Fizetés hozzáadása foglaláshoz

Fizetési rekordot hoz létre egy meglévő foglaláshoz.

Kötelező tulajdonságok

Tulajdonság	Típus	Leírás
customerBookingId	egész	A foglalás azonosítója, amelyhez a fizetés tartozik.
amount	szám	A fizetés összege.
gateway	szöveg	onSite, payPal, stripe, wc, mollie vagy razorpay.
status	szöveg	paid, pending, partiallyPaid vagy refunded.
packageCustomerId	egész	Csomagvásárláshoz tartozó fizetésnél kötelező.
entity	szöveg	appointment, event vagy package.

Opcionális tulajdonságok

Tulajdonság	Típus	Leírás
dateTime	szöveg	A fizetés ideje ÉÉÉÉ-HH-NN ÓÓ:PP formában.
gatewayTitle	szöveg	WooCommerce-fizetési módoknál a mód neve (például Stripe, utánvét, banki átutalás).
actionsCompleted	logikai	Lefutottak-e a foglalás utáni műveletek.
wcOrderId	egész	A WooCommerce-rendelés azonosítója.
transactionId	szöveg	Az online fizetési szolgáltató tranzakcióazonosítója, WooCommerce nélküli visszatérítéshez kell.

curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/payments' \
--header 'Content-Type: application/json' \
--header 'Amelia: AZ_API_KULCSOD' \
--data '{
  "customerBookingId": 268,
  "amount": 10,
  "dateTime": "2026-01-14 15:00:00",
  "status": "paid",
  "gateway": "stripe",
  "data": {},
  "packageCustomerId": null,
  "entity": "appointment"
}'

Fizetés módosítása

A /payments/{{fizetes_id}} végpont egy vagy több tulajdonságot módosít: csak azokat küldd el, amelyeket változtatni akarsz. Ugyanazok a mezők használhatók, mint a létrehozásnál (customerBookingId, amount, gateway, status, packageCustomerId, entity, dateTime, gatewayTitle, actionsCompleted, wcOrderId, transactionId), mindegyik opcionális.

curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/payments/280' \
--header 'Content-Type: application/json' \
--header 'Amelia: AZ_API_KULCSOD' \
--data '{
  "customerBookingId": 268,
  "amount": 15,
  "dateTime": "2026-02-03 15:00:00",
  "status": "paid",
  "gateway": "stripe",
  "actionsCompleted": 1
}'

Fizetés és fizetések lekérése

Egy fizetést a GET /payments/{{fizetes_id}} ad vissza. A listát a GET /payments adja, ezekkel a lekérdezési paraméterekkel szűrhetsz:

Paraméter	Típus	Leírás
dates	szöveg	Kezdő és záró dátum vesszővel elválasztva, például 2026-02-01,2026-02-28.
page	egész	Az oldalszám. Az oldalankénti találatok számát az Amelia beállításai adják.
customers	szöveg	Vásárlóazonosítók vesszővel elválasztva.
providers	szöveg	Munkavállalóazonosítók vesszővel elválasztva.
services	szöveg	Szolgáltatásazonosítók vesszővel elválasztva.
events	szöveg	Eseményazonosítók vesszővel elválasztva.
bookingTypes	szöveg	Foglalástípusok vesszővel elválasztva (appointment, package, event).

curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/payments&page=1&dates=2026-02-01,2026-02-28' \
--header 'Amelia: AZ_API_KULCSOD'

Tranzakció összegének lekérése

A GET /payments/transaction/{{fizetes_id}} az online fizetési szolgáltatónál rögzített tranzakció összegét adja vissza az adott fizetéshez.

Fizetendő összeg kiszámítása

A POST /payments/amount egy foglalási adatcsomagból kiszámítja a fizetendő összeget és a pénznemet.

Tulajdonság	Típus	Leírás
type	szöveg	Kötelező. appointment, event vagy package.
bookings	tömb	Kötelező. A foglalások adatai (extrák, létszám, előleg, időtartam).
bookingStart	szöveg	Kötelező. A foglalás kezdete.
locationId	egész	Kötelező. A helyszín azonosítója.
providerId	egész	Kötelező. A munkavállaló azonosítója.
serviceId	egész	Kötelező. A szolgáltatás azonosítója.
recurring	tömb	Ismétlődő foglalásnál kötelező.
couponCode	szöveg	Opcionális. Kuponkód.

curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/payments/amount' \
--header 'Content-Type: application/json' \
--header 'Amelia: AZ_API_KULCSOD' \
--data '{
  "type": "appointment",
  "bookings": [ { "extras": [ { "extraId": 4, "quantity": 1 } ], "deposit": true, "persons": 2, "duration": 1800 } ],
  "bookingStart": "2026-01-22 19:00",
  "locationId": 2,
  "providerId": 1,
  "serviceId": 1,
  "recurring": [],
  "couponCode": null
}'

Fizetési link létrehozása

A POST /payments/link egy foglaláshoz és egy támogatott fizetési módhoz hoz létre fizetési linket.

Tulajdonság	Típus	Leírás
data	objektum	Kötelező. Tartalmazza a type mezőt (appointment, event, package), és időpontnál vagy eseménynél a bookingId, csomagnál a packageCustomerId mezőt.
paymentMethod	szöveg	Kötelező. payPal, stripe, mollie, razorpay vagy wc.
redirectUrl	szöveg	Opcionális. Sikeres fizetés után ide irányít át; alapértelmezetten az Amelia beállításaiban megadott vásárlói felület címe.

curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/payments/link' \
--header 'Content-Type: application/json' \
--header 'Amelia: AZ_API_KULCSOD' \
--data '{ "data": { "type": "appointment", "bookingId": 901 }, "paymentMethod": "payPal", "redirectUrl": null }'

Visszatérítés

A POST /payments/refund/{{fizetes_id}} online fizetés visszatérítését kéri a fizetési szolgáltatón keresztül, a tárolt tranzakcióazonosító alapján.

A visszatérítés csak online fizetésekre vonatkozik. A helyszíni fizetést és a tranzakcióazonosító nélküli fizetést nem lehet a szolgáltatón keresztül visszatéríteni.

curl --location --request POST 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/payments/refund/917' \
--header 'Amelia: AZ_API_KULCSOD'

Fizetés törlése

A POST /payments/delete/{{fizetes_id}} törli a fizetési rekordot.

Csak a fizetés törlődik, a hozzá tartozó foglalás nem. Ha a folyamatot nem kezeled helyesen, ez hibákhoz vezethet.

curl --location --request POST 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/payments/delete/313' \
--header 'Amelia: AZ_API_KULCSOD'