Tovanix
Tovanix

Using Verification & Transaction Risk

Verification & Transaction Risk checks your customers and their transactions, charged per check from your account balance:

  • Six check types: individual verification, business verification, transaction monitoring, wallet screening, AML screening and sign-up risk checks
  • Click "Enable" on Dashboard to start using it; enabling is free, with no monthly fee or minimum spend
  • Requests that were not accepted, or that are verified and confirmed as failed, are refunded automatically; expired verifications and checks that already have a result are not refunded
  • Check History can be filtered, searched and exported, and the details show each step's result and the charge status
  • You can configure result callbacks, or start checks from your own system with a platform API key

What this service does

Verification & Transaction Risk is for checking your customers and their transactions: verifying the identity of individuals or businesses, assessing transaction risk before or after a transfer, screening wallet addresses and watchlists, and assessing the risk of an email, phone number or IP when a customer signs up.

  • Individual verification — The person being verified uses a phone to photograph their ID and complete a liveness check and a face match.
  • Business verification — Checks the company's registration, company documents and key people.
  • Transaction monitoring — Assesses the risk of a single transaction, with separate checks for fiat and crypto transactions; crypto transactions also screen the on-chain addresses.
  • Wallet screening — Screens a single wallet address on its own for risk and for matches against sanctions lists.
  • AML screening — Screens a person's or company's name against PEP, sanctions and regulatory warning lists, with the result on the spot.
  • Sign-up risk check — Assesses the risk of an email, phone number or IP, for example disposable emails, virtual numbers, VPNs and data-center IPs.

Results are for reference only, and the platform never automatically freezes or rejects any funds based on them. The platform stores only each step's result, scores and matches — not names, ID numbers or ID images. This service has no test environment: every check is a real check with a real charge.

Enabling the service

Just click "Enable" on Verification & Transaction Risk → Dashboard. Enabling is free and needs no account or key. The enable card lists the unit price of each check type; types marked "Not available yet" cannot be used for now.

  • Once it is enabled, you can set up the handoff page, result callbacks and the open API under Integration settings as needed; see below.
  • Every check is charged to your account balance, so make sure you have enough balance before starting one.

Charges and refunds

Charged per check from your account balance, with no monthly fee and no minimum spend. Unit prices are shown on the entry cards on Dashboard, on the page where you start a check and in the charge confirmation dialog, and what the page shows is what applies; transaction monitoring has two tiers, fiat and crypto, and sign-up risk checks are priced separately for email, phone number and IP.

  • The request was not accepted — Refunded automatically; the record shows "Failed".
  • The record shows "Verifying result" — The system verifies it automatically and refunds automatically if it is confirmed as failed.
  • The person being verified did not finish, or the verification expired — No refund.
  • A result has been given (including "Declined", "In review" and "Not assessed") — No refund.
  • Starting again while the same subject reference still has an unfinished verification — Not charged again; the earlier verification is opened instead.

Business verification is settled in two steps: when you start it, an amount is held based on the number of ultimate beneficial owners stated on the page; once the result is in, it is settled based on the actual number and the company's country of registration, with any difference refunded or charged. The record details include a billing breakdown.

Starting an individual or business verification

  • Enter the subject reference: Under Verification & Transaction Risk → Identity Verification → Person Verification or Business Verification, enter this subject's unique reference in your own system, or click "Pick from directory". The reference may contain only letters, digits and . _ : @ + -, must be 1 to 128 characters long, and must start with a letter or digit.
  • Confirm the charge: Click "Start verification", check the check type and unit price in the confirmation dialog, then click "Confirm and charge".
  • Hand the link to the person being verified: The page gives you a verification link and a QR code: use "Copy link" to send it to the person, or have them "Scan with a phone". The link is for this verification only and stops working once it is completed or expires.
  • Wait for the result: The person first reads and accepts the notice, then completes the capture on a phone. The page shows progress as "Created", "Consent given", "Verifying" and "Result", and refreshes automatically.

When the person opens the link, the first thing they see is the handoff page: who invited them to verify and which documents they need to read and accept. Under "Handoff page" in Integration settings, you can set the requester name shown on that page (up to 60 characters) and links to your own privacy policy and terms of service (the two links must be filled in together and must use https); the pages that follow, for photographing the ID and taking a selfie, use one platform-wide style.

Transaction screening

Verification & Transaction Risk → Transaction Screening has five tabs. Fill in the details and click "Run check", and the page gives a check report: the risk score, the result and the rules triggered.

  • Fiat transaction — The subject's reference and name, the direction (inbound or outbound), the amount and the currency. The subject's name is used only for screening, and the platform does not store it in plain text.
  • Crypto transaction — The subject, direction, network and asset, amount and counterparty address; for an inbound transfer already on chain, you can enter the transaction hash and your own receiving address. Supported networks are TRON, Ethereum, BNB Chain, Polygon, Solana and Bitcoin.
  • Wallet address — The network and wallet address, to screen this address on its own for risk and sanctions list matches.
  • AML screening — An individual or a company, plus the name or company name; date of birth and nationality are optional, and filling them in reduces false matches on shared names. The platform does not store this name.
  • Sign-up risk — One of email, phone number or IP address. You can enter the reference you gave this customer, and you are alerted if the same email or number appears on another of your customers; records keep only a masked value.

Wallet screening, AML screening and sign-up risk checks give their result on the spot, and checking again is charged again. "Needs review" in AML screening and sign-up risk checks means a possible list match or a risk signal; the result will not change, and you need to judge it in the context of your business.

Viewing results and check history

Check History lists every check. You can filter by type, status and result, search by reference, address or charge number, and "Export" a CSV of the current filter (up to 5000 rows). Open a record to see each step's result, the risk score, the charge number and the charge status. "Users" and "Businesses" under Directory group the verifications you have started by subject reference.

  • Accepted / Awaiting subject / Processing — The check is still in progress.
  • Verifying result — The result is unclear and the system is verifying it; if it is confirmed as failed, it is refunded automatically.
  • Failed — The check did not complete, and the fee has been refunded.
  • Approved / Declined / In review — The check result. "In review" means it is under manual review and the result may change; it updates automatically when the review is finished.
  • Not assessed — No usable data exists for this subject, so no risk judgement was given; this does not mean it is safe.
  • Expired — The person being verified did not complete the verification within its validity.
  • Refunds show up in three places: the "Fee" column of the check history says "Refunded", the details show "Charge status" as "Refunded", and the bills under Finance have a matching refund record.
  • This month's checks and spending on Dashboard are counted by UTC calendar month and exclude refunded checks.
  • Results of individual verification, business verification and transaction monitoring can be refreshed in the record details, and refreshing is free.

Result callbacks and the open API

  • Under "Result callback" in Integration settings, enter an https callback URL and enable it. When a check record's status or result changes, the platform POSTs a signed event to that URL; if it does not get a 2xx, it retries with backoff, up to 8 times.
  • The signing secret is shown only once, when it is generated. Use it to verify the X-Tovanix-Signature request header: the value is sha256= followed by the hex of HMAC-SHA256(signing secret, timestamp + "." + raw request body), with the timestamp in X-Tovanix-Timestamp. After you click "Generate a new secret", the old secret stops working immediately.
  • Click "Send test event" to check connectivity; "Recent deliveries" shows the result of each delivery.
  • Open API: when creating a key under My Account → API management, grant the "Verification & risk" permission, and you can start checks and query records from your own system. Unit prices are the same as in the console, and an idempotency key is required when starting a check.

Troubleshooting

  • Starting a check says the balance is insufficient — Your account balance does not cover this check's unit price — Nothing was charged this time; top up and try again.
  • Starting a check says the verification service refused the request — The request was not accepted — The fee is refunded automatically, and the "Fee" column of the check history shows "Refunded". Check what you entered and start again.
  • A record keeps showing "Verifying result" — The result is unclear and the system keeps verifying it — Wait for the automatic verification; if it does not change for a long time, contact support with the record ID.
  • The person opening the link sees "Verification link unavailable" — The link has expired, or this verification has already ended — Start a new verification and send the new link; starting again is charged again.
  • Callback signature verification fails — The signature was not computed over the raw request body, or the signing secret has been regenerated — Compute the signature over the raw request body you received, rather than parsing and re-serializing it first; after regenerating the secret, update it in your system as well.

Frequently Asked Questions

Is the fee refunded if a verification expires or the result is "Declined"?

No. Checks are charged when they are started, and nothing is refunded if the person does not finish, the verification expires or the result is "Declined"; refunds are automatic only when the request was not accepted, or when it is verified and confirmed as failed.

If the result is "Declined", will the platform freeze the funds?

No. Results are for reference only; the platform never automatically freezes or rejects any funds based on them, and whether to let something through is your decision.

Can I integrate through the API?

Yes. Create a key under My Account → API management and grant the "Verification & risk" permission; result callbacks are configured under Integration settings.

Related pages: Help Center · Guides & FAQ · Verification & Transaction Risk · Verification & Transaction Risk API

Loading…