Rezervasyonlar

Okutma anında ayrılan ve kapanan fişle onaylanan cashback.

Rezervasyon nesnesi

iduuid: Fişle birlikte hold_id olarak gönderin.
memberstring: Kart numarası.
amountinteger: Ayrılan cashback, en küçük para biriminde.
statusstring: active, captured, released veya expired.
captured_bystring veya null: Rezervasyonu kullanan fişin external_id değeri.
expires_atdatetime: Kullanılmayan rezervasyonun kendiliğinden kalkacağı zaman.

Parametre	Tür	Açıklama
id	uuid	Fişle birlikte `hold_id` olarak gönderin.
member	string	Kart numarası.
amount	integer	Ayrılan cashback, en küçük para biriminde.
status	string	`active`, `captured`, `released` veya `expired`.
captured_by	string veya null	Rezervasyonu kullanan fişin `external_id` değeri.
expires_at	datetime	Kullanılmayan rezervasyonun kendiliğinden kalkacağı zaman.

POST/v1/holds

İzin: transactions:write

Cashback ayırır. Fişteki limitlerin aynısı uygulanır. Daha fazlasını istemek 402 insufficient_balance ve limited_by ile reddedilir. Idempotency-Key gönderin.

memberstring, zorunlu: Kart numarası, okunan değer, seri numarası, üye id'si veya telefon.
amountinteger, zorunlu: Ayrılacak cashback.
check_amountinteger, zorunlu: Programın oranı ve kategori kuralları için fiş toplamı.
register_idstring: Kasanızın id'si.
line_itemsdizi: Kategori kuralları için.

Parametre	Tür	Açıklama
member	string, zorunlu	Kart numarası, okunan değer, seri numarası, üye id'si veya telefon.
amount	integer, zorunlu	Ayrılacak cashback.
check_amount	integer, zorunlu	Programın oranı ve kategori kuralları için fiş toplamı.
register_id	string	Kasanızın id'si.
line_items	dizi	Kategori kuralları için.

curl

curl https://loyaltyfy.io/api/v1/holds \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: hold-R3-000131" \
  -d '{ "member": "2000111703779", "amount": 3000, "check_amount": 20000, "register_id": "R3" }'

# at payment: the check captures it
curl https://loyaltyfy.io/api/v1/transactions \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "external_id": "000131", "register_id": "R3", "member": "2000111703779",
        "amount": 20000, "hold_id": "5b0d6c1e-8f3a-4d7e-9a61-2c4b8e0f7d19" }'

Yanıt · 201

{
  "object": "hold",
  "id": "5b0d6c1e-8f3a-4d7e-9a61-2c4b8e0f7d19",
  "member": "2000111703779",
  "amount": 3000,
  "check_amount": 20000,
  "status": "active",
  "register_id": "R3",
  "captured_by": null,
  "expires_at": "2026-10-06T19:02:11.000+00:00",
  "livemode": false,
  "created_at": "2026-10-06T18:32:11.000+00:00",
  "member_after": { "object": "member", "cashback": { "balance": 10200, "held": 3000, "available": 7200, ... }, ... }
}

GET/v1/holds/{id}

İzin: transactions:write

Güncel durumuyla tek bir rezervasyon.

POST/v1/holds/{id}/release

İzin: transactions:write

Parayı hemen geri verir. Kaldırılmış veya süresi dolmuş bir rezervasyonu kaldırmak zarar vermez. Onaylanmış bir rezervasyon 409 hold_captured yanıtı verir (bunun yerine fişi iptal edin).