Docs/Operate your integration/Lifecycle

Lifecycle

The reward paths Loyfin coordinates: program creation, Add to wallet, customer transfers, Add from wallet, and updates.

Five paths#

Loyfin separates program identity, Add to wallet, movement, Add from wallet, and updates.

01

First issue

The first valid issuance can create the Loyalty Token and initial customer balance.

02

Add to wallet

A brand-signed issuance tokenizes eligible points into a customer wallet balance in the selected expiry bucket.

03

Transfer

Customers can send tokenized points to another wallet before expiry.

04

Add from wallet

A redemption burns wallet tokens so the backend can credit matching points to the customer’s brand account.

05

Program updates

The admin updates artwork, descriptions, or royalties. These changes do not move customer balances.

Status model#

A checkout without a customer signature begins as requires_wallet_authorization, shown as Awaiting wallet authorization. After authorization it becomes pending, shown as Created. It can move through submitted to mined, shown as Completed. Your backend still verifies finalized completion before crediting points. Rejected or cancelled attempts need reconciliation; verified expiry has separate reservation-release rules. These API statuses are distinct from your internal ledger states.