Shop Escrow: Ligtas na Payout para mga May-ari ng Tindahan
Kapag bumili ang isang manlalaro ng produkto mula sa tindahan na pag-aari ng isang user, hindi na agad na ipinapadala ang bayad sa may-ari ng tindahan. Sa halip, ang mga barya ay pinipigilan ng server sa escrow hanggang sa kumpirmahin ng mamimili ang pagtanggap ng mga kalakal. Doon lang tatanggapin ng may-ari ng tindahan ang kanilang payout — 98% on-chain, na may 2% komisyon ng server.
Bakit Escrow?
Kung walang escrow, makakatanggap ang may-ari ng tindahan ng bayad at hindi kailanman maghatid ng mga kalakal. Wala sanang magagawa ang mamimili. Pinoprotektahan ng escrow ang magkabilang panig:
- Mga mamimili ay maaaring maghabol ng order kung hindi naihatid ang mga kalakal o hindi tumutugma sa deskripsyon. Ang payout ay nagyeyelo hanggang suriin ng isang admin ang kaso.
- Mga may-ari ng tindahan ay garantisadong makakatanggap ng kanilang payout kapag kumpirmahin ng mamimili — o awtomatiko pagkatapos ng 7 araw kung hindi kikilos ang mamimili.
Paano Ito Gumagana
1 Nagbabayad ang mamimili
Nagpapadala ang mamimili ng buong bayad sa operator Wallet ng server. Ang mga barya ay pinipigilan sa escrow. Ang status ng order ay itinatakda sa escrow.
2 Kinukumpirma ng mamimili ang pagtanggap
Tinatawag ng mamimili ang POST /shop/confirm-receipt upang kumpirmahin na natanggap nila ang mga kalakal. Agad na nagpapadala ang server ng 98% ng bayad sa Wallet ng may-ari ng tindahan on-chain. Pinapanatili ng server ang 2% komisyon.
3 Awtomatikong pagpapakawala pagkatapos ng 7 araw
Kung hindi kukumpirma o maghahabol ang mamimili sa loob ng 7 araw, ang payout ay awtomatikong ipinapakawala sa may-ari ng tindahan. Isang background worker ang sumusuri tuwing oras para sa mga expired na escrow.
4 Paglutas ng dispute
Kung hindi nasisiyahan ang mamimili, maaari nilang tawagin ang POST /shop/dispute upang i-freeze ang payout. Susuriin ng isang admin ang kaso sa pamamagitan ng POST /shop/admin/resolve-payout at alinman sa:
- Ipinapakawala ang payout sa may-ari ng tindahan, o
- Nagre-refund — ang payout ay kinansela at ang mga barya ay mananatili sa server (ang mamimili ay maaaring kompensahin nang mano-mano).
Sanggunian ng Status ng Payout
| Status | Meaning |
|---|---|
none | Opisyal na tindahan o walang order |
escrow | Pinipigilan ng server ang mga barya, naghihintay ng kumpirmasyon ng mamimili |
disputed | Naghabol ang mamimili, naghihintay ng pagsusuri ng admin |
paid | 98% naipadala sa may-ari on-chain |
refunded | Kinansela ng admin ang payout, mananatili ang mga barya sa server |
failed | Nabigo ang on-chain transfer |
API Endpoints
| Endpoint | Who | Purpose |
|---|---|---|
POST /shop/confirm-receipt | Mamimili | Kumpirmahin ang pagtanggap → pakawalan ang escrow |
POST /shop/dispute | Mamimili | Habol ang order → i-freeze ang escrow |
POST /shop/admin/resolve-payout | Admin | Lutasin ang dispute (pakawalan o refund) |
GET /shop/my-payouts | May-ari ng tindahan | Tingnan ang escrow + kabuuang nabayaran at kasaysayan |
Pagpili ng Wallet
Ang payout ay ipinapadala sa Wallet ng may-ari ng tindahan sa parehong chain tulad ng bayad:
| Payment Currency | Owner Wallet Used |
|---|---|
| CC (Cash Coins) | CC wallet (fallback: KC wallet) |
| KC (Keshe Coins) | KC wallet |
Pagbabahagi ng Kita
| Recipient | Share |
|---|---|
| May-ari ng tindahan | 98% |
| Komisyon ng server | 2% |
Sinasaklaw ng 2% komisyon ang mga gastos sa imprastraktura: gas ng blockchain (kung naaangkop), hosting ng server, at ang escrow service mismo.
Mga Opisyal na Tindahan
Ang mga opisyal na tindahan ng Erleuchtung (pag-aari ng server, owner_id IS NULL) ay hindi kasama sa sistema ng escrow. Ang mga bayad para sa mga produkto ng opisyal na tindahan ay pupunta nang direkta sa server nang walang paghahati ng payout.
Anong Susunod?
Ang sistema ng escrow ay buhay na ngayon. Maaaring subaybayan ng mga may-ari ng tindahan ang kanilang mga nakabinbing balanse ng escrow at mga kita na nabayaran sa pamamagitan ng endpoint na GET /shop/my-payouts. Isang frontend dashboard para sa pamamahala ng mga payout, pagkumpirma ng mga pagtanggap, at paghahabol ng mga dispute ay susunod sa paparating na release.