For the complete documentation index, see llms.txt. This page is also available as Markdown.

Buy a Listing (Product)

Definition

This page describes the purchase flow for a Product listing, from checkout to final confirmation of receipt.

Triggering the purchase

From the listing page, clicking BUY opens the purchase flow, provided the vendor has enabled Allow online purchase on this listing (see Edit a Listing (Product), Price & conditions). If online purchase is not enabled, only the Contact me button is available (see Show a Listing (Product)).


Order summary

Page: "Buy this item β€” Order summary"

  • Recap of the listing (thumbnail, title, price)

  • Delivery section β€” delivery availability for this item

  • Shipping address:

    • Address street number and name

    • Additional location information

  • Product price

  • Platform fees

  • Required checkbox: "I accept the marketplace terms and conditions"

  • Buttons: Edit / Confirm purchase

Step 2 β€” Payment

Page: "Your order β€” Payment"

  • Card entry form (Visa / Mastercard / CB) β€” a Test card button is available in test environments

  • Notice: "No amounts will be charged until your booking request is accepted. Additionally, the platform will hold the amount paid until the service is rendered."

  • Total to pay + Pay button

πŸ’‘ Confirmed business rule β€” Payment is authorized, not captured, at checkout. The platform holds the funds until the vendor accepts the order, and only releases them to the vendor once the buyer confirms receipt.

Step 3 β€” Confirmation

Page: "Thank you!" β€” "Your payment has been accepted, you will be redirected to the order details." The buyer is redirected to the order, which starts at status Pending.


Order lifecycle

Status
Triggered by
Effect

Pending

End of the purchase flow (payment authorized, not captured)

A countdown to expiration is displayed (e.g. Expires in 32h); the vendor must Accept or Decline

Paid

Vendor clicks Accept

Payment is captured; contact information is revealed to both parties

Completed

Buyer clicks Mark as received

End of the cycle; the listing itself switches to status Sold

Declined

Vendor clicks Decline

End of the cycle; the listing itself still published

Expired

Vendor didn't confirm in time

End of the cycle; the listing itself still published

Vendor view before decision

On a Pending order, the vendor sees:

Accepting the sale

Clicking Accept opens a modal, "Accept this sale #[id]":

  • Delivery address recap

  • Buyer profile

  • Free-text field: "Your message" (optional message to the buyer)

  • Total (vendor amount)

  • Required checkbox: "I accept the marketplace terms and conditions"

  • Button: Accept this sale

Once confirmed: notification "This booking has successfully been accepted." β€” the order moves directly to status Paid, confirming that acceptance triggers the capture of the held payment.

Once Paid, a Contact information section appears on both sides:

  • The vendor sees the buyer's name and email (and phone, where available)

  • The buyer sees the vendor's name, email, and phone

The listing's address and additional location information (see Edit a Listing (Product)) are revealed at this same point β€” both follow the same "revealed after acceptance" rule.

On the buyer's side, two additional actions appear:

  • Mark as received

  • Download Confirmation

Confirming receipt β†’ Completed

Clicking Mark as received as the asker triggers :

  • a confirmation dialog ("Are you sure you received this item?").

  • the payout to the offerer (to be confirmed via the SBO by the administrators)

Once confirmed:

  • Notification: "The item has been marked as received."

  • Order status: Completed

  • The buyer's Has completed X booking(s) counter increases

Listing status: Sold

Once the associated order reaches Completed, the listing itself switches to status Sold in the vendor's listings. This reflects the "single unit" nature of Product listings β€” unlike Time Based / Seat Based / Flat Rate listings, which remain bookable after a transaction.

Last updated

Was this helpful?