Project

General

Profile

Marketplace » History » Revision 21

Revision 20 (Ryan Supawarapong, 02/20/2026 04:16 AM) → Revision 21/36 (Ryan Supawarapong, 02/20/2026 04:18 AM)

# Marketplace 

 There are the following API: 
 - Get 
 - Sell 
 - Reserve 
 - Update 
   - Confirm 
   - Cancel 
   - Remove 

 ## Diagram 
 <img src="market_place.png"><br> 
 ``` 
 title Market Place 

 actor "customer" as c 
 actor "owner" as o 
 actor "admin" as a 
 participant "frontend" as fe 
 participant "admin" as adm 
 participant "backend" as be 
 database "database" as db 
 participant "notification" as n 

 o->fe: post sell asset 
 fe->be: verify asset and quantities 
 be<->db: query database 
 be->fe: true/false 
 fe->c: true: dispaly new post 
 c->fe: click "interest" button 
 fe->be: update status and count down 15 minutes 
 be<->db: update database 
 be->fe: true/false 
 fe->c: show status "locked" 
 be->n: update payment notification 
 n->c: email bank account info and payment noti within 15 minutes 
 c->n: click confirm payment 
 c->fe: totp to confirm payment 
 fe->be: update payment 
 fe->fe: update status to "pending payment confirm" 
 be<->db: update database 
 be->n: update payment confirmation 
 n->o: email payment acknowledge confirmation and pay service fees 
 o->n: click confirm service fees 
 o->fe: totp to confirm service fees 
 fe->be: update service fees transaction 
 fe->fe: update status to "pending service fees confirm" 
 be<->db: update database 
 be->n: send service fees notification 
 n->a: get noti for new service fees 
 adm<->be: get new service fees 
 a->adm: verify service fees 
 adm<->be: show service fees 
 a->adm: approved service fees 
 adm->be: update service fees status 
 be<->db: update database 
 be->n: send notification 
 n->o: get noti service fees approved 
 fe->fe: update status to "complete" 
 ``` 

 ## API route 

 ## Lists 


 | Type      | Value    | 
 | --------| ---- |  
 | API Path| `/marketplace/v1/marketplace/lists` | 
 | Request Type | `GET` | 
 | Content-Type | `application/json` | 

 ### Request Body 

 | Key | Type | Example | Required | 
 |-----|------|---------|----------| 

 



 #### Response 

 | JSON Path | Type | Example | Required | 
 |---|---|---|---| 
 | status | string | "success" | yes | 
 | xid | string | "xRequestID" | yes | 
 | data | object | {"transactions":[...]} | yes | 
 | data.transactions | array<object>| array<object| [ { ... } ] | yes | 


 ##### Example response body 
 | Body | Value | 
 |---|---| 
 | JSON | | 

 

 ### Sell