Finansia Portal

# 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/fullname/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| [ { ... } ] | yes |

| data.marketplace[].id | integer | 1 | yes |

| data.marketplace[].icoCode | string | "product1" | yes |

| data.marketplace[].from | integer | 90000004 | yes |

| data.marketplace[].to | integer | 0 | yes |

| data.marketplace[].unitAmount | integer | 10 | yes |

| data.marketplace[].unitPrice | number | 2 | yes |

| data.marketplace[].totalPrice | number | 20 | yes |

| data.marketplace[].status | integer | 0 | yes |

| data.marketplace[].CreatedAt | string (date-time) | "2024-06-01T00:00:00Z" | yes |

| data.marketplace[].UpdatedAt | string (date-time) | "0001-01-01T00:00:00Z" | yes |

| data.marketplace[].DeletedAt | null/object | null | yes |

##### Example response body

| Body | Value |

|---|---|

| JSON | {"status":"success","xid":"xRequestID","data":{"marketplace":[{"id":1,"icoCode":"product1","from":90000004,"to":0,"unitAmount":10,"unitPrice":2,"totalPrice":20,"status":0,"CreatedAt":"2024-06-01T00:00:00Z","UpdatedAt":"0001-01-01T00:00:00Z","DeletedAt":null},{"id":2,"icoCode":"product2","from":90000005,"to":0,"unitAmount":5,"unitPrice":3,"totalPrice":15,"status":0,"CreatedAt":"2024-06-01T00:00:10Z","UpdatedAt":"0001-01-01T00:00:00Z","DeletedAt":null},{"id":3,"icoCode":"product3","from":90000006,"to":90000005,"unitAmount":8,"unitPrice":1.5,"totalPrice":12,"status":2,"CreatedAt":"2024-06-01T00:00:20Z","UpdatedAt":"0001-01-01T00:00:00Z","DeletedAt":null}]}} |

### Sell