Payments, Subscriptions, And Stripe¶
Last audited: 2026-06-26.
Current Screens¶
Rent payment routes:
/property/[propertyId]/leases/[leaseId]/payments/property/[propertyId]/leases/[leaseId]/payments/add/property/[propertyId]/leases/[leaseId]/payments/[requestId]/property/[propertyId]/leases/[leaseId]/payments/[requestId]/edit/property/[propertyId]/leases/[leaseId]/schedules/[scheduleId]/edit/rent-payment/success/rent-payment/cancel
Stripe Connect routes:
/connect/return/connect/refresh
Subscription routes:
/subscription/subscription/plans/subscription/[...slug]/account/payment
Bank account routes:
/account/bank-account/account/bank-account/add/account/bank-account/[accountId]
Current Behavior¶
Payment request flows cover list, detail, create, edit, cancel, mark-paid, deferral request, deferral approval/rejection, receipt listing, and receipt upload. Payment schedule editing exists for lease schedules.
Tenant payment details allow manual transfer review, IBAN copy, deferral requests, and receipt/proof submission for unpaid requests. Owner payment details reflect tenant deferral requests, allow approval/rejection, and show submitted receipts after upload. Tenant direct links to owner-only payment create/edit routes redirect back to read-only payment list/detail routes.
Tenant Stripe checkout starts through the rent checkout hook and returns through success or cancel routes. Return screens reconcile route context and redirect back to payment request detail when property, lease, and request identifiers are present.
Stripe Connect onboarding is exposed through owner account/payment and payment request surfaces. Return and refresh routes redirect to account payment for owner billing/payout setup.
Subscriptions support plan listing, web checkout, native store purchase confirmation, plan changes, cancellation, and portal access for owner accounts. Subscription catch-all routes redirect toward account payment or plans.
Tenant accounts do not get the owner billing, payout, Stripe Connect, or bank-account management surfaces. Tenant deep links to /account/payment, /account/bank-account, or /account/bank-account/add redirect to account profile.
Current Backend Touchpoints¶
GET /v1/leases/{leaseId}/payment-schedulesPOST /v1/leases/{leaseId}/payment-schedulesPUT /v1/leases/{leaseId}/payment-schedules/{scheduleId}DELETE /v1/leases/{leaseId}/payment-schedules/{scheduleId}GET /v1/leases/{leaseId}/payment-requestsPOST /v1/leases/{leaseId}/payment-requestsGET /v1/leases/{leaseId}/payment-requests/{requestId}PUT /v1/leases/{leaseId}/payment-requests/{requestId}POST /v1/leases/{leaseId}/payment-requests/{requestId}/cancelPOST /v1/leases/{leaseId}/payment-requests/{requestId}/mark-paidPOST /v1/leases/{leaseId}/payment-requests/{requestId}/request-deferralPOST /v1/leases/{leaseId}/payment-requests/{requestId}/approve-deferralPOST /v1/leases/{leaseId}/payment-requests/{requestId}/reject-deferralGET /v1/leases/{leaseId}/payment-requests/{requestId}/receiptsPOST /v1/leases/{leaseId}/payment-requests/{requestId}/receiptsPOST /v1/rent-payments/checkoutPOST /v1/connect-accountsGET /v1/connect-accounts/statusPOST /v1/connect-accounts/refresh-linkGET /v1/subscriptions/plansGET /v1/subscriptions/currentPOST /v1/subscriptions/checkoutPOST /v1/subscriptions/store/confirmPOST /v1/subscriptions/change-planDELETE /v1/subscriptions/currentGET /v1/subscriptions/portalGET /v1/bank-accountsGET /v1/bank-accounts/{id}POST /v1/bank-accountsPUT /v1/bank-accounts/{id}DELETE /v1/bank-accounts/{id}
What To Check¶
- Stripe Dashboard event delivery for checkout, payment intent, invoice, refund, or dispute issues.
- Backend unified Stripe webhook logs and metrics when app state does not match Stripe state.
- Connect account readiness before allowing tenant rent checkout.
- Receipt creation and payment request status updates when manual receipts are uploaded.
- Subscription status and platform source when native and Stripe web subscription states differ.