Demo Partner Shop a reference integration, built from the partner package

My orders

One row per purchase attempt this shop started, on either channel. The status comes from webhooks, which are the only authoritative statement that an order completed; the “from” tag says which source each row believes. An order with no status yet is waiting for its webhook, and that is the normal state of an order a minute old.

Our reference Channel What Amount Price Status From
DEMO-261110-C10318AD
2026-11-10T13:00:27Z
partner_api USDT
usdt-10
10 USDT 526.00 TRY
locked
created api

Reading this table

created
The price is locked and nobody has paid. Send the customer to payment_url.
payment_pending
The customer is at the payment page.
paid
The money is in. Delivery has not happened yet -- do not act on this.
fulfilling
Being delivered.
completed
Delivered. Act on this, not on paid.
expired
The locked price ran out before payment. Nothing was charged.
payment_failed
Declined. Nothing was charged, and there is no requote.
needs_review
Something needs a human. Neither success nor failure; another event will come.
manually_refunded
An operator refunded the customer. This reverses a settled sale.

Only payment_failed and manually_refunded are states the platform does not expect to leave. needs_review is a waiting room an operator moves, and even a completed order can be refunded later — so this shop never stops listening to an order it has already seen finish.