mercury.ach_authorize
Screen an ACH payment through the DPX compliance oracle before execution. Runs FATF R16, GENIUS Act, MiCA, and AML checks against the recipient. Returns APPROVED / FLAGGED / BLOCKED with full compliance reasoning.
Use this tool BEFORE every ACH payment via mercury.send. ACH is hard to reverse — compliance pre-screening prevents blocked transactions and BSA/AML exposure.
Workflow:
mercury.ach_authorize (screen only, autoExecute:false) → review decision
If APPROVED → set autoExecute:true to send, or call mercury.send directly
If FLAGGED → manual review required before proceeding
If BLOCKED → do not proceed
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Payment memo / note (optional). | |
| amount | Yes | Payment amount in USD. | |
| purpose | No | Payment purpose category (optional — required by Mercury for domesticWire, recommended for ACH). E.g. "Vendor", "Contractor", "Expenses". | |
| accountId | Yes | Source Mercury account ID (from mercury.accounts). | |
| autoExecute | No | If true and compliance returns APPROVED, immediately sends the ACH payment. Default false — screen first, execute separately. | |
| recipientId | Yes | Mercury saved recipient ID (from mercury.send / POST /mercury/recipients). | |
| externalMemo | No | External memo / reference visible to recipient (optional). | |
| recipientName | Yes | Legal name of the recipient entity or individual — used for compliance screening. | |
| idempotencyKey | No | Idempotency key for safe retries. Auto-generated if omitted. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | Compliance tier — FAST_PATH, STANDARD, ENHANCED, or HOLD. | |
| _next | No | Guidance on next action. | |
| reason | No | Human-readable decision summary. | |
| decision | No | Compliance decision. | |
| executed | No | True if autoExecute:true and ACH was sent. | |
| mercuryId | No | Mercury transaction ID (present when executed). | |
| authorized | No | True if compliance approved the payment. | |
| compliance | No | Full compliance oracle response including framework attestations. | |
| requiresReview | No | True when decision is FLAGGED — manual review required. |