{"name":"4 Seasons dispute rules","url":"https://www.build4seasons.com/pay-on-proof/rules.json","pageUrl":"https://www.build4seasons.com/pay-on-proof/rules","schema":1,"version":"2e90440bb009","values":{"jobReviewHours":24,"jobBigPaymentCents":500000,"jobBigPaymentHours":72,"jobReminderHours":6,"planReviewDays":3,"planReminderDays":1,"planRespondDays":3,"planDecideBusinessDays":5,"siteCheckDollars":149,"issueNoteMinChars":10},"holdReasons":[{"key":"not_done","en":"The work isn't finished","es":"El trabajo no está terminado"},{"key":"quality","en":"Something doesn't look right","es":"Algo no se ve bien"},{"key":"damage","en":"Something got damaged","es":"Algo se dañó"},{"key":"other","en":"Something else","es":"Otra cosa"}],"issueReasons":[{"key":"not_done","en":"The work isn't finished","es":"El trabajo no está terminado"},{"key":"not_to_plan","en":"It doesn't match the plan","es":"No coincide con el plan"},{"key":"damage","en":"Something was damaged","es":"Algo se dañó"},{"key":"materials","en":"The materials are wrong or missing","es":"Los materiales están mal o faltan"},{"key":"other","en":"Something else","es":"Otra cosa"}],"proofFlags":[{"key":"no_location","en":"No location on the photo","es":"La foto no tiene ubicación"},{"key":"far_from_site","en":"Taken away from the address","es":"Tomada lejos de la dirección"},{"key":"clock_skew","en":"The phone's clock didn't match ours","es":"La hora del teléfono no coincidió con la nuestra"},{"key":"not_live","en":"Picked from the library","es":"Elegida de la galería"},{"key":"reused","en":"The same photo is on another project","es":"La misma foto está en otro proyecto"}],"outcomes":[{"key":"release","title":"Release","text":"The whole payment goes to the contractor.","status":"released"},{"key":"partial","title":"Partial release","text":"Part goes to the contractor and the rest goes back to the homeowner. The part released is more than nothing and less than the whole payment. On a $1,000 milestone, $600 released means $400 refunded.","status":"partial"},{"key":"resubmit","title":"Rework, then release","text":"The contractor fixes the work and sends new proof. The money stays held, the milestone goes back to waiting for proof, and the homeowner's review days start again when the new proof arrives.","status":"funded"},{"key":"refund","title":"Refund","text":"The whole payment goes back to the homeowner.","status":"refunded"}],"recordKinds":[{"key":"plan","text":"The plan, each version of it, with the SHA-256 of the exact text both sides saw"},{"key":"signature","text":"Each side's signature, with the name typed and the time"},{"key":"payment","text":"Each payment in, with its amount and method"},{"key":"proof","text":"Each proof photo or receipt, with when and where it was taken, its capture flags and its SHA-256"},{"key":"message","text":"Every reply either side wrote, and every split that was offered"},{"key":"issue","text":"Each issue raised, with its reason and note, and when it went to review"},{"key":"decision","text":"Every release, agreed split and decision, with who made it and the reason given"},{"key":"transfer","text":"Each transfer to the contractor"},{"key":"refund","text":"Each refund to the homeowner"},{"key":"change","text":"Each change to the plan and who signed it"},{"key":"waiver","text":"Each lien waiver generated"},{"key":"flag","text":"Anything the system marked, such as a card dispute at the bank or a release that waits for a person"},{"key":"visit","text":"An on-site check, when one was booked"},{"key":"reminder","text":"Each reminder that was sent"}],"sections":[{"id":"scope","title":"What these rules cover","lede":"A hold stops one payment. It never stops the rest of the job, and it never moves money by itself.","rules":[{"id":"scope-job","scope":"job","kind":"system","who":"system","title":"A 4 Seasons job","text":"4 Seasons does the work. The homeowner pays one step at a time, after that step has passed its check, by a saved method or by hand. A payment that has not been charged yet can be held.","window":null,"basis":"billing.ts holdPayment"},{"id":"scope-plan","scope":"plan","kind":"system","who":"system","title":"A plan with your own contractor","text":"A homeowner and their own contractor agree a plan of milestones. The homeowner pays each milestone in before the work, Stripe holds it, and it goes to the contractor after proof. Money that is held can have an issue raised on it.","window":null,"basis":"protected.ts raiseIssue"},{"id":"scope-limits","scope":"both","kind":"system","who":"4seasons","title":"What a review by 4 Seasons is","text":"On a plan, a review by 4 Seasons decides one thing, which is where that held payment goes. It is not arbitration and it is not a court's ruling. It does not decide the construction contract between the homeowner and the contractor.","window":null,"basis":"protected.ts planText"}]},{"id":"reasons","title":"Why a payment can be held","lede":"The person holding picks one reason from a fixed list and says what is wrong in their own words.","rules":[{"id":"reasons-job","scope":"job","kind":"system","who":"homeowner","title":"On a 4 Seasons job","text":"The homeowner picks one of the reasons listed here. They can add a note and point at one photo from that payment's own steps. The payment at signing is not offered for a hold, because it orders the materials.","window":null,"basis":"trust.ts HOLD_REASONS, holdRelease","items":[{"key":"not_done","en":"The work isn't finished","es":"El trabajo no está terminado"},{"key":"quality","en":"Something doesn't look right","es":"Algo no se ve bien"},{"key":"damage","en":"Something got damaged","es":"Algo se dañó"},{"key":"other","en":"Something else","es":"Otra cosa"}]},{"id":"reasons-plan","scope":"plan","kind":"system","who":"homeowner","title":"On a plan with your own contractor","text":"The homeowner picks one of the reasons listed here and writes a note of at least 10 characters. Photos can be attached. Only the homeowner raises an issue, only on a milestone whose money is held, and a milestone has one open issue at a time.","window":null,"basis":"protected.ts ISSUE_REASONS, raiseIssue","items":[{"key":"not_done","en":"The work isn't finished","es":"El trabajo no está terminado"},{"key":"not_to_plan","en":"It doesn't match the plan","es":"No coincide con el plan"},{"key":"damage","en":"Something was damaged","es":"Algo se dañó"},{"key":"materials","en":"The materials are wrong or missing","es":"Los materiales están mal o faltan"},{"key":"other","en":"Something else","es":"Otra cosa"}]},{"id":"reasons-only","scope":"plan","kind":"system","who":"system","title":"One milestone at a time","text":"An issue holds that milestone only. Its release clock is cleared. The plan's other milestones keep moving.","window":null,"basis":"protected.ts raiseIssue"}]},{"id":"windows","title":"The windows","lede":"Each window below is the value configured in the system today.","rules":[{"id":"window-job-review","scope":"job","kind":"system","who":"homeowner","title":"Time to look before a step is charged","text":"A passed step's payment waits 24 hours before the saved method is charged. A payment of $5,000 or more waits 3 days. The homeowner can release it sooner, or hold it at any point before it is charged.","window":"24 hours","basis":"money.release_review_hours, money.release_big_step_over, money.release_big_step_hours"},{"id":"window-job-reminder","scope":"job","kind":"system","who":"system","title":"A reminder before it goes","text":"One reminder goes 6 hours before the charge, by push and email. The charge never comes sooner than 6 hours after the reminder could reach the homeowner.","window":"6 hours","basis":"money.release_reminder_hours, billing.ts releaseReminderSweep"},{"id":"window-plan-review","scope":"plan","kind":"system","who":"homeowner","title":"Time to review proof","text":"After the contractor sends proof, the homeowner has 3 days to release the milestone or raise an issue. If they do neither, it releases to the contractor on its own. A signed plan keeps the review days it was signed with.","window":"3 days","basis":"protected.release.autoReleaseDays, protected.ts protectedSweep"},{"id":"window-plan-reminder","scope":"plan","kind":"system","who":"system","title":"A reminder the day before","text":"The homeowner gets a reminder when one day is left before a milestone releases on its own.","window":"1 day","basis":"protected.ts releaseClock"},{"id":"window-plan-respond","scope":"plan","kind":"system","who":"contractor","title":"Time to answer an issue","text":"The contractor answers an issue within 3 days. An issue nobody has answered after 3 days goes to 4 Seasons for review on its own.","window":"3 days","basis":"DISPUTE_POLICY.respondDays, protected.ts protectedSweep"},{"id":"window-plan-decide","scope":"plan","kind":"signed_plan","who":"4seasons","title":"Time for 4 Seasons to decide","text":"The plan both sides sign says 4 Seasons decides within 5 business days of being asked. This is a commitment in the signed plan. No timer in the system forces it.","window":"5 business days","basis":"DISPUTE_POLICY.decideBusinessDays, protected.ts planText"}]},{"id":"provide","title":"What each side provides","lede":"Everything either side sends is added to the record with the time it arrived.","rules":[{"id":"provide-homeowner","scope":"plan","kind":"system","who":"homeowner","title":"The homeowner","text":"The reason, the note, and any photos of what is wrong. Photos are stored with the record the same way the contractor's proof is.","window":null,"basis":"protected.ts raiseIssue"},{"id":"provide-contractor","scope":"plan","kind":"system","who":"contractor","title":"The contractor","text":"A written reply, with photos if they help, within 3 days. The contractor can also choose to fix the work and send new proof, or offer a split.","window":"3 days","basis":"protected.ts respondToIssue, fixAndResubmit, proposeSplit"},{"id":"provide-job","scope":"job","kind":"system","who":"homeowner","title":"On a 4 Seasons job","text":"The homeowner gives the reason and, if they want, a note and the photo it is about. The 4 Seasons team is told at once and the held payment shows what the homeowner said.","window":null,"basis":"trust.ts holdRelease, billing.ts holdPayment"}]},{"id":"record","title":"What the record holds","lede":"The plan both sides sign says 4 Seasons decides from the record. This is what the record keeps, in the order it happened.","rules":[{"id":"record-plan","scope":"plan","kind":"system","who":"system","title":"On a plan","text":"The plan, each version of it, with the SHA-256 of the exact text both sides saw. Each side's signature, with the name typed and the time. Each payment in, with its amount and method. Each proof photo or receipt, with when and where it was taken, its capture flags and its SHA-256. Every reply either side wrote, and every split that was offered. Each issue raised, with its reason and note, and when it went to review. Every release, agreed split and decision, with who made it and the reason given. Each transfer to the contractor. Each refund to the homeowner. Each change to the plan and who signed it. Each lien waiver generated. Anything the system marked, such as a card dispute at the bank or a release that waits for a person. An on-site check, when one was booked. Each reminder that was sent.","window":null,"basis":"protected.ts logProtected, evidenceTimeline"},{"id":"record-flags","scope":"plan","kind":"system","who":"system","title":"What a photo's flags say","text":"Each proof photo is shown full size with its time, its place and its SHA-256. A photo can carry any of the flags listed here, and both sides see them.","window":null,"basis":"protected.ts proofFlags","items":[{"key":"no_location","en":"No location on the photo","es":"La foto no tiene ubicación"},{"key":"far_from_site","en":"Taken away from the address","es":"Tomada lejos de la dirección"},{"key":"clock_skew","en":"The phone's clock didn't match ours","es":"La hora del teléfono no coincidió con la nuestra"},{"key":"not_live","en":"Picked from the library","es":"Elegida de la galería"},{"key":"reused","en":"The same photo is on another project","es":"La misma foto está en otro proyecto"}]},{"id":"record-job","scope":"job","kind":"system","who":"system","title":"On a 4 Seasons job","text":"Each step's proof photos, with whether each was taken live in the app, taken at the house and sealed with a SHA-256 on arrival, and who passed the step and when.","window":null,"basis":"trust.ts trustView"}]},{"id":"outcomes","title":"Possible outcomes","lede":"A held milestone on a plan ends one of four ways. A held payment on a 4 Seasons job ends when the hold is lifted.","rules":[{"id":"outcome-release","scope":"plan","kind":"system","who":"system","title":"Release","text":"The whole payment goes to the contractor.","window":null,"basis":"protected.ts disputeResult"},{"id":"outcome-partial","scope":"plan","kind":"system","who":"system","title":"Partial release","text":"Part goes to the contractor and the rest goes back to the homeowner. The part released is more than nothing and less than the whole payment. On a $1,000 milestone, $600 released means $400 refunded.","window":null,"basis":"protected.ts disputeResult"},{"id":"outcome-resubmit","scope":"plan","kind":"system","who":"system","title":"Rework, then release","text":"The contractor fixes the work and sends new proof. The money stays held, the milestone goes back to waiting for proof, and the homeowner's review days start again when the new proof arrives.","window":null,"basis":"protected.ts disputeResult"},{"id":"outcome-refund","scope":"plan","kind":"system","who":"system","title":"Refund","text":"The whole payment goes back to the homeowner.","window":null,"basis":"protected.ts disputeResult"},{"id":"outcome-job","scope":"job","kind":"system","who":"either","title":"On a 4 Seasons job","text":"The homeowner lifts their own hold once it has been made right, and the payment goes. The 4 Seasons team can also lift it after talking it through with the homeowner. Until one of them does, the payment is not charged.","window":null,"basis":"trust.ts liftHold, billing.ts releaseHold"}]},{"id":"stages","title":"Who decides, stage by stage","lede":"Most issues end between the two sides. 4 Seasons decides only when one side asks or nobody answers.","rules":[{"id":"stage-sides","scope":"plan","kind":"system","who":"either","title":"First, the two sides","text":"The contractor can choose to fix the work and send new proof, which closes the issue. Either side can offer a split and the other side can accept it. An accepted split settles at once.","window":null,"basis":"protected.ts fixAndResubmit, proposeSplit, acceptSplit"},{"id":"stage-escalate","scope":"plan","kind":"system","who":"either","title":"Then, either side can ask 4 Seasons","text":"Either side can send the issue to 4 Seasons at any time. It also goes on its own when nobody has answered after 3 days. Both sides are told, and both can keep adding to the record.","window":"3 days","basis":"protected.ts escalateIssue, protectedSweep"},{"id":"stage-decide","scope":"plan","kind":"system","who":"4seasons","title":"Then, 4 Seasons decides","text":"A person at 4 Seasons reads the record and picks one of the four outcomes. They must write the reason, and both sides receive it. The decision, the reason and who made it are kept on the record.","window":null,"basis":"protected.ts decideDispute"},{"id":"stage-site-check","scope":"plan","kind":"system","who":"4seasons","title":"An on-site check","text":"Before deciding, 4 Seasons can book an on-site check by one of its own pros where it works in the area. The visit is priced at $149 and the photos taken go on the record.","window":null,"basis":"DISPUTE_POLICY.siteCheckPrice, protected.ts requestSiteCheck"},{"id":"stage-end","scope":"plan","kind":"system","who":"system","title":"After the decision","text":"The system has no further review step, and a settled issue cannot be reopened in it. When the outcome was rework, the homeowner can raise a new issue on the new proof.","window":null,"basis":"protected.ts requireDispute"},{"id":"stage-job","scope":"job","kind":"system","who":"either","title":"On a 4 Seasons job","text":"4 Seasons did the work, so there is no outside reviewer in this process. The homeowner and the 4 Seasons team settle it between them, and the payment stays uncharged until the hold is lifted.","window":null,"basis":"trust.ts holdRelease, liftHold"}]},{"id":"meanwhile","title":"The contractor's pay and the lien waiver meanwhile","lede":"What happens to the money and the paperwork while a payment is held.","rules":[{"id":"pay-plan","scope":"plan","kind":"system","who":"system","title":"The contractor's pay on a plan","text":"The held milestone's money stays with Stripe. Nothing is transferred to the contractor and nothing is refunded to the homeowner until the issue ends.","window":null,"basis":"protected.ts raiseIssue, settleMilestone"},{"id":"waiver-plan","scope":"plan","kind":"system","who":"system","title":"The lien waiver on a plan","text":"A lien waiver for a milestone is generated only when money for it is released to the contractor, and it is for the amount released. A milestone that is held has no waiver yet. A milestone refunded in full gets none.","window":null,"basis":"protected.ts issueWaiver"},{"id":"pay-job","scope":"job","kind":"system","who":"system","title":"The crew's pay on a 4 Seasons job","text":"The crew's pay for a step is recorded when the step passes its check. A homeowner's hold stops the homeowner's charge. It does not stop the crew's pay, which 4 Seasons sends from its own balance while it settles the hold.","window":null,"basis":"stripe-books.ts payoutFunding, trust.release_engine"},{"id":"waiver-job","scope":"job","kind":"system","who":"system","title":"The lien waiver on a 4 Seasons job","text":"The waiver for a step is filed when that step's pay is recorded, and the pro signs it in the Pro app. A hold on the homeowner's payment does not change it. The homeowner's payment reads \"Lien waiver received\" once every waiver for the steps it pays for is signed.","window":null,"basis":"lien-waivers.ts recordEarning, projectMoney"}]},{"id":"bank","title":"A card dispute at the bank","lede":"A dispute opened with the card's bank is a separate process. The bank decides it, on the bank's own timeline.","rules":[{"id":"bank-separate","scope":"both","kind":"system","who":"bank","title":"It is separate from a hold","text":"A hold or an issue is raised with 4 Seasons and settled here. A card dispute is raised with the bank, and the bank can take a card payment back even after it was released.","window":null,"basis":"protected.ts applyProtectedStripeEvent, stripe-books.ts applyPaymentDisputeEvent"},{"id":"bank-plan","scope":"plan","kind":"system","who":"system","title":"On a plan","text":"When the bank opens a dispute on a milestone's payment, that milestone stops releasing on its own and goes to a person at 4 Seasons, who answers the bank from the plan's record.","window":null,"basis":"protected.ts applyProtectedStripeEvent (charge.dispute.created)"},{"id":"bank-job","scope":"job","kind":"system","who":"system","title":"On a 4 Seasons job","text":"The crew pay that payment funds is frozen where it has not been sent yet. The answer to the bank is drafted from the job's record, which is the signed contract, each step's proof photos with their fingerprints, the walkthrough sign-off and the messages with the homeowner. A person at 4 Seasons sends it.","window":null,"basis":"stripe-books.ts applyPaymentDisputeEvent, disputes.auto_evidence"},{"id":"bank-proof","scope":"both","kind":"system","who":"system","title":"Proof decides who carries the loss","text":"A payment with valid proof sides with whoever holds the proof, and its signed receipt is the answer to the bank. A payment without valid proof, such as one the payee took as pay now with no proof, carries the loss, and the payee who took it bears it.","window":null,"basis":"dispute-rules.ts proofDisputeSide"},{"id":"bank-after","scope":"job","kind":"system","who":"system","title":"After the bank decides","text":"If the bank finds for 4 Seasons, the frozen pay goes out on the next pay run. If it finds for the cardholder, the pay stays held until a person at 4 Seasons releases it.","window":null,"basis":"stripe-books.ts applyPaymentDisputeEvent"}]}]}