Face-to-face Transaction Lifecycle
This page details the lifecycle of face-to-face transactions in terms of their different states and how they transition from one state to the next. The lifecycle is presented as a state machine.
Lifecycle Diagram
Here we present a diagrammatic overview of the face-to-face transaction lifecycle. The colours of the edges indicate the actors that initiate those state transitions.
States
Created
Face-to-face transactions start off in the created state, and will have
either a "seller" or a "buyer" user (the user who created the transaction)
linked to it. Face-to-face transactions have a "join code" while in this state.
Transitions: A Trustap user other than the creator can
join
or
reject
a created transaction using its join code.
The creator of the transaction can
cancel a
created transaction using its id.
Rejected
A rejected transaction is considered to be completed.
Joined
A joined transaction is one that has both a seller and a buyer user linked to
it, and requires payment before moving on to the next state.
Transitions: The buyer can
pay a deposit
for, or
cancel,
a joined transaction.
Cancelled
A cancelled transaction is considered to be completed.
Deposit paid
A deposit_paid transaction waits for the seller to accept the buyer's deposit
before progressing.
Transitions: The seller can
accept a deposit
for, or
cancel,
a deposit_paid transaction.
Cancelled with deposit
A cancelled_with_deposit transaction is one that has been cancelled after its
deposit has been paid.
Transitions: The Trustap platform updates the state of a
cancelled_with_deposit transaction to deposit_refunded once the deposit has
been refunded to the buyer.
Deposit Refunded
A deposit_refunded transaction is considered to be completed.
Deposit Accepted
A deposit_accepted transaction waits for the seller to set the pricing for
the transaction before progressing.
Transitions:
- The seller can skip the remainder
step
after the deposit is accepted, instead of setting a price for the transaction.
If the transaction was created with
"skip_remainder": true, then this transition occurs automatically as soon as the deposit is accepted. - The seller can set the
pricing
of the transaction, or
cancel,
a
deposit_acceptedtransaction.
Priced
A priced transaction is one that has had pricing information set, and
requires payment before moving on to the next state.
Transitions: The buyer can
pay the remainder
of the transaction, or
cancel,
a joined transaction.
Remainder Paid
A remainder_paid transaction is one that is pending handover confirmation,
primarily from the seller. Once the seller has confirmed the handover, the buyer
has an opportunity to submit a complaint.
Transitions: The buyer and seller can both confirm the handover of the goods.
Remainder skipped
A remainder_skipped transaction is one that is pending handover confirmation,
primarily from the seller. Once the seller has confirmed the handover, the buyer
has an opportunity to submit a complaint.
Transitions: The buyer and seller can both confirm the handover of the goods.
Buyer handover confirmed
A buyer_handover_confirmed transaction is one that is still pending the seller
handover confirmation.
Transitions:
- The buyer can
complain
about a
deliveredtransaction before the complaints period ends. - The seller can confirm the handover of the goods.
Seller handover confirmed
A seller_handover_confirmed transaction gives the buyer an opportunity to
verify the item they have received. Once the item has been delivered, the
Trustap platform begins a "complaints period".
Transitions:
- The buyer can
complain
about a
deliveredtransaction before the complaints period ends. - If no such complaint occurs before the complaints period ends then the Trustap
platform will release the funds for the transaction to the seller and will
update the state to
funds_released. - The buyer can confirm the handover of the goods, if they haven't done so already.
Complained
A complained transaction is registered with Trustap for conflict resolution.
Transitions: After arbitration, Trustap will release the funds to the buyer
and/or seller in a certain ratio and will update the state to funds_released.
Funds released
A funds_released transaction is considered to be completed.