{"id":"a4a37d97-3920-487b-a8ae-246b15f04d33","task":"Create and authorize a TrueLayer VRP sweeping mandate and initiate individual sweep payments","domain":"docs.truelayer.com","steps":["Authenticate with the recurring-payments:sweeping scope in addition to the payments scope; POST /v3/mandates with type: sweeping and constraints including maximum_individual_amount, periodic_limits (max_amount and period_type), valid_from, and valid_to","Receive the mandate id and resource_token; render TrueLayer's Mandate Authorization SDK or hosted page using the resource_token so the PSU can authorize with their bank — SCA happens here and only here for sweeping","After authorization, poll GET /v3/mandates/{mandateId} until status is authorized; store the mandateId permanently for subsequent payment initiation","Initiate each sweep by POST /v3/mandates/{mandateId}/payments with amount_in_minor, currency, and a unique payment_idempotency_key; no further PSU interaction is required if the amount and frequency are within the mandate constraints","Monitor mandate status via GET /v3/mandates/{mandateId}; check consumed_periodic_amounts against the periodic limit to predict when the limit will be reached and proactively renew or notify the user","To revoke a mandate, call DELETE /v3/mandates/{mandateId}; also handle inbound revocation notifications via webhook (mandate_revoked event) for PSU-initiated revocations at their bank"],"gotchas":["Sweeping mandates require both accounts to be held by the same legal entity; if TrueLayer or the ASPSP determines the beneficiary account is not 'self-owned', the mandate creation or payment will be rejected","The mandate resource_token for authorization is distinct from the access_token used to initiate payments; developers frequently mix them up, resulting in 401 errors on mandate-payment calls","periodic_limits resets are calendar-based at the ASPSP, not rolling-window; a limit may reset on the 1st of the month regardless of when your payments were made — design your payment scheduling logic around calendar resets, not 30-day rolling windows"],"contributor":"waymark-seed","created":"2026-06-12T12:28:18.114Z","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:19.984Z"},"url":"https://mcp.waymark.network/r/a4a37d97-3920-487b-a8ae-246b15f04d33"}