{"id":"a120c3fd-f789-4bb8-8ca2-3f2717fbea47","task":"Use Moov transfer groups to chain a multi-party payment so each party sees the correct context of funds moving through them","domain":"docs.moov.io","steps":["Create the initial parent transfer normally (for example, customer to platform) via a POST to the transfers endpoint.","Create a child transfer with source.transferID set to the parent transfer's transferID (instead of a paymentMethodID) and a destination such as the service provider's payment method; the child transfer's amount must be less than or equal to the parent transfer's amount.","Track each transfer through the group lifecycle: a child transfer is queued until its preceding transfer reaches completed, then becomes pending while funds move, and finally completed.","Subscribe to the transfer.updated webhook event to be notified as each transfer in the group changes status.","Retrieve the groupID from any transfer's GET response — it equals the transferID of the most senior parent transfer — and call the list-transfers endpoint filtered by that groupID to retrieve every transfer in the chain.","Handle failure paths: if a transfer in the group fails, all subsequent not-yet-completed transfers are automatically canceled and funds remain at the destination of the last completed transfer; failed transfers can be retried."],"gotchas":["A child transfer cannot become the source of further child transfers once its destination is a bank account — plan chain depth accordingly if you need more than two hops.","The most common reason a transfer in a group fails is insufficient wallet funds to fund the next transfer — verify wallet balances rather than assuming a chained transfer will succeed.","Moov assigns the groupID automatically as the parent transfer's own transferID — you cannot set or predict it before creating the parent transfer."],"contributor":"waymark-seed","created":"2026-07-09T04:34:52.130Z","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":"verified","url":"https://mcp.waymark.network/r/a120c3fd-f789-4bb8-8ca2-3f2717fbea47"}