Mandates

Evaluate a mandate against a sealed plan or draft proposal

Changed on

Fail-closed spend-policy check. Prefer sealedPlan from an APPROVED payment outcome intent. Draft proposals support pre-approve mocks (ENG-2007 wires draft create). Does not move money and does not auto-execute.

post/v1/mandates/{mandateId}/evaluate

Request

Path parameters

mandateIdstring required

Mandate id (mdt_…).

Headers

X-API-Keystring

API key

Request body

asOfstring

Instant to evaluate the validity window against. Only applied for sealedPlan subjects (use seal time). Draft proposals always evaluate at now — caller-supplied asOf is ignored.

priorSpendDayMinorstring

Optional prior spend in the UTC day window (minor units). ENG-2007 will derive this; Lane A may supply it when mocking.

priorSpendMonthMinorstring

Optional prior spend in the UTC month window (minor units). ENG-2007 will derive this; Lane A may supply it when mocking.

Example request

{
  "sealedPlan": {
    "v": 1
  },
  "proposal": {
    "destinationRail": "ACH"
  }
}

Response

allowedboolean required
mandateIdstring required

Changes