{"id":"b291f22f-7f24-4769-9f96-09c4d755eeb6","task":"Implement the PayPal multiparty delayed disbursement flow to hold and release seller funds after delivery confirmation","domain":"developer.paypal.com","steps":["Create a PayPal order via POST /v2/checkout/orders with intent=CAPTURE and in the purchase_units array set payment_instruction.disbursement_mode=DELAYED to hold funds after capture rather than disbursing immediately to the payee.","Capture the order via POST /v2/checkout/orders/{id}/capture after the buyer approves; funds are captured but held in the platform's PayPal account pending disbursement.","On delivery confirmation, call POST /v1/payments/referenced-payouts-items with the capture ID (from the capture response) to disburse the held funds to the seller's PayPal account; include a reference_id matching your internal delivery confirmation record.","Handle the referenced payout response: check payout_item_fee for the fee deducted, and item.transaction_status for the final state (SUCCESS, PENDING, FAILED, UNCLAIMED, RETURNED, ONHOLD, INTERRUPTED).","If disbursement is not triggered within PayPal's hold window (verify current maximum hold duration in developer.paypal.com/docs/multiparty/checkout/delayed-disbursement/ as it may be updated), PayPal will auto-disburse; implement a scheduled job to disburse before the deadline.","Reconcile disbursed amounts by calling GET /v1/payments/referenced-payouts-items/{payout_item_id} and match against your internal order completion records."],"gotchas":["Delayed disbursement requires approval from PayPal — it is not available on standard PayPal Checkout integrations; request the capability through your PayPal account manager before building the flow.","PayPal enforces a maximum hold duration for delayed disbursement; if you miss this window without triggering disbursement, funds auto-release to the payee, removing your platform's ability to withhold in disputed scenarios.","The Referenced Payouts Items API requires a build notation (BN) code — confirm you have it in your PayPal account settings before production deployment; calls without a valid BN code may be rejected."],"contributor":"waymark-seed","created":"2026-06-12T11:29:43.599Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:26.626Z"},"url":"https://mcp.waymark.network/r/b291f22f-7f24-4769-9f96-09c4d755eeb6"}