WP-RENT-DEPOSIT-01 — Cọc phòng + hợp đồng online (WELIFE chứng kiến)
Domain: D-RENTAL · Surfaces: CON · PAR · API · Status: IMP · Date: 2026-08-17
Product
Thanh toán cọc cho hai bên qua ví WELIFE (escrow): khách trừ ví → công ty vận hành giữ hộ → chủ nhà nhận khi đủ chữ ký và giải ngân. Không invent VNPay/MoMo.
Văn bản hợp đồng điện tử (tiếng Việt) giữa Bên A (thuê) và Bên B (cho thuê), Bên chứng kiến = Công ty vận hành WELIFE. Chữ ký = xác nhận trên app. Dấu chứng kiến đóng tự động khi chủ nhà ký.
Luồng
| Bước | Ai | API | Ví |
|---|---|---|---|
| Dự thảo | Tenant CON | GET /rentals/deposits/preview |
— |
| Ký + trả cọc | Tenant | POST /rentals/deposits |
RENTAL_DEPOSIT_ESCROW debit |
| Ký + chứng kiến | Landlord PAR | POST /rentals/deposits/:id/sign |
giữ hộ (HOLDING) |
| Giải ngân | Landlord | POST /rentals/deposits/:id/release |
credit ví chủ nhà |
| Hoàn (trước khi chủ ký) | Tenant hoặc landlord từ chối | POST /rentals/deposits/:id/refund |
credit ví khách |
Default số tiền = priceMonth (1 tháng). Một tin + một tenant chỉ một cọc PAID_ESCROW/HOLDING.
Files
api/prisma/schema.prisma+migrations/20260817120000_rental_deposit/api/src/modules/rentals/rental-deposit.ts+.spec.tsapi/src/modules/rentals/rentals.service.ts·rentals.controller.ts·dto/rentals.dto.ts·rentals.module.ts(WalletModule)api/src/modules/wallet/wallet.service.ts— debit escrow / refund / release- CON:
RentalDepositScreen·RentalDepositsScreen· CTA chi tiết + icon list - PAR: tab Khách thuê — ký / hoàn / giải ngân + xem văn bản
N/A
- Cổng VNPay/MoMo cho cọc (OWNER Pay riêng)
- PDF ướt mực / chữ ký số CA / eKYC
- Hợp đồng thuê nhà đầy đủ (chỉ cọc)
- Admin dispute UI
- Dashboard ADM inbox cọc