state— where the escrow is in its lifecycle:AWAITING_PAYMENT→OPENED→CLOSED.status— the business outcome:PENDING,ONGOING,COMPLETED,REFUNDED,CLAIMED,DISPUTED, orINVESTIGATING.
The happy path
AWAITING_PAYMENT / PENDING
The escrow was created via Create escrow.
It can still be edited or
deleted by the seller while in this state.
OPENED / ONGOING
The buyer funded the escrow via Pay escrow.
Funds are held by Payluk. The delivery window (
maxDelivery + deliveryTimeline) starts counting.CLOSED / COMPLETED
The buyer confirms delivery,
releasing funds to the seller. Commission is charged on completion.
Alternate outcomes
Seller claims funds (CLAIMED)
Seller claims funds (CLAIMED)
If the delivery window elapses and the buyer hasn’t confirmed, the seller
can call Claim funds. This is only
allowed when the escrow is
OPENED and the window has passed.Dispute opened (DISPUTED / INVESTIGATING)
Dispute opened (DISPUTED / INVESTIGATING)
Only the buyer can open a dispute
while the escrow is
OPENED; the seller can only respond once one is raised.
The merchant then resolves it.
Milestone escrows can’t be disputed.Refunded (REFUNDED)
Refunded (REFUNDED)
When a merchant resolves a dispute in the buyer’s favour, funds are returned
to the buyer and the escrow closes as
REFUNDED.State reference
| State | Meaning |
|---|---|
AWAITING_PAYMENT | Created but not yet funded. Editable/deletable. |
OPENED | Funded and held. Delivery in progress. |
CLOSED | Terminal. Settled, refunded, or otherwise finalised. |
status
values combine with each state, and How it works (end-to-end)
for the exact endpoints to call at each stage. If you sell more than one unit off
a single link, read Multi-quantity escrows.