Skip to content
Request a demoGet in touch
Get in touch
← Back to documentation

AML Transaction Screening

AML screening checks the origin of the cryptocurrency clients send: addresses and transactions are scored against sanctions, darknet, stolen funds, and mixer databases. It is a mandatory element for an exchanger working with merchants, exchanges, and monitoring services — “dirty” incoming funds become your problem the moment they are credited.

Providers

The platform integrates with external AML providers (of the AMLBot, BitOK kind, and similar). The provider performs the analysis; the platform applies the result to the order.

Connecting:

  1. Register with a provider and top up the check balance.
  2. In the admin panel, open the AML section and add the provider’s API key:

aml_provider = amlbot              # or bitok, etc.
api_key      = …
check_mode   = pre_credit          # check before crediting the payment

  1. Set reaction rules (see below).
  2. Run a test address check from the interface to confirm the integration responds.

What is checked

  • Sender address — if known in advance (orders from the cabinet, allowlists).
  • Incoming transaction — the primary mode: after the transaction appears on the network, before crediting and payout.
  • Risk scoring — the provider returns a risk score (usually 0–100%) with a category breakdown: sanctions, stolen funds, darknet, mixer, scam, etc.

Configuring the reaction

Typical rule matrix:

risk_score <  25  -> auto_accept        # clean payment: crediting and payout per regulations
risk_score 25–60  -> manual_review      # order goes to the operator queue
risk_score >  60  -> auto_hold          # funds held, client gets a KYC/explanation request
sanctions_hit     -> auto_hold + alert  # sanctions match: hold and notify the administrator
Configuration principles:

  • Check before payout. The pre_credit mode guarantees the auto-payout doesn’t leave before the screening result.
  • Thresholds matching your risk appetite. Strict thresholds are safer but grow the manual review queue; start with the matrix above and calibrate from statistics.
  • Action on hold — regulated: request documents/source of funds, refund minus network fees to the sender address, or hand the case to a compliance officer. Don’t improvise under client pressure.

Limits and cost

  • Every check is billed by the provider — factor the screening cost into the direction’s unit economics.
  • For small amounts you can set a lighter check depth or selective screening (by rules); for large amounts — full screening.
  • Watch the provider balance: when it runs out, checks stop and orders stall (set up a notification, see Notifications).

Notifications

Set up instant administrator notifications for hits: order in manual review, sanctions match, provider failure. Reviewing the AML queue is a daily procedure, not a one-off event.

See also