COMPLIANCE_HOLD error

​

What happened

{
  "type": "COMPLIANCE_HOLD",
  "title": "Transaction held for compliance review",
  "status": 422,
  "detail": "This transaction is held pending a regulatory compliance review.",
  "resolution": "Contact support. This cannot be retried without a compliance review.",
  "docs": "/errors#compliance-hold",
  "instance": "/v2/transactions/txn_abc123",
  "correlationId": "corr_xyz789",
  "timestamp": "2026-01-15T09:30:00.000Z"
}

​

Common causes

• Screening match on a deposit — the inbound transfer matched an elevated-risk or sanctions signal during compliance review, and the deposit policy routes all non-clear decisions to a frozen hold
• Manual hold placed by Conduit’s compliance team — the transaction was held pending further investigation

​

Recovery

curl -X GET https://api.conduit.financial/v2/transactions/txn_abc123 \
  -H "x-api-key: YOUR_API_KEY"

• The transaction ID (txn_abc123)
• The correlation ID from the error response
• The customer ID and any context about the transaction source

​

Prevention

• Handle transaction.failed with this code — branch on failureCode === 'compliance_hold' to surface a neutral “this transfer requires review” message to the customer without disclosing compliance details
• Do not retry — submitting a replacement transaction for the same source is unlikely to succeed and may flag additional transactions

​

Related webhooks

{
  "type": "transaction.failed",
  "data": {
    "transactionId": "txn_abc123",
    "failureCode": "compliance_hold"
  }
}

​

Related endpoints

• GET /v2/transactions/:id — read transaction state