This API allows you to analyze transactions to ensure compliance with AML (Anti-Money Laundering) regulations.Overview#
The Operations API enables you to:1.
Submit Transactions: Register transactions for analysis, including both fiat and cryptocurrency transactions.
2.
Check Transaction Status: Retrieve the status and analysis results of previously submitted transactions.
3.
Monitor Entities: Track and analyze entities involved in financial transactions.
API Endpoints#
Submit Transaction for Analysis#
Register a transaction and initiate the analysis process.Endpoint: /api/v1/verification/sendCheck Transaction Status#
Retrieve the status and analysis results of a transaction.Endpoint: /api/v1/verification/get?client_id={client_id}&client_secret={client_secret}Transaction Types#
The Operations API supports two main types of transactions:Fiat Transactions#
Transactions involving traditional currencies (USD, EUR, etc.).transaction_type: Set to "fiat"
sending_amount: Amount to be sent
sending_currency: Currency code of the sending amount
receiving_amount: Amount to be received
receiving_currency: Currency code of the receiving amount
Cryptocurrency Transactions#
Transactions involving cryptocurrencies (BTC, ETH, etc.).transaction_type: Set to "crypto"
crypto_network: Type of cryptocurrency network (e.g., "Bitcoin", "Ethereum")
crypto_asset: Type of asset (e.g., "BTC", "ETH")
sending_wallet: Sender's wallet address
receiving_wallet: Recipient's wallet address
sending_amount: Amount to be sent
sending_dollar_amount: Equivalent amount in USD
Transaction Analysis Process#
When a transaction is submitted for analysis, Rillis performs the following steps:1.
Initial Validation: Checks if all required fields are provided and valid.
2.
Risk Assessment: Analyzes the transaction for potential risks based on various factors.
3.
Entity Verification: Verifies the entities involved in the transaction.
4.
Wallet Analysis: For cryptocurrency transactions, analyzes the wallets for suspicious activities.
5.
Compliance Check: Ensures the transaction complies with relevant regulations.
6.
Result Determination: Determines the final result of the analysis.
Transaction Statuses#
Transactions can have the following statuses:| Status | Description |
|---|
PROGRESS | The transaction is currently under analysis. |
COMPLETED | The transaction has been analyzed and approved. |
REJECTED | The transaction has been rejected during analysis. |
COMPLIANCE | The client exceeded the threshold previously set by the company. |
EVALUATION | Operator verification of the analysis is required. |
CANCELLED | Transaction cancelled by the operator. |
Webhook Notifications#
Rillis can send webhook notifications to your application when the transaction status changes. To receive these notifications, you need to configure a webhook URL in your Rillis account.Best Practices#
1.
Unique Transaction IDs: Always use unique client_transaction_id values for each transaction.
2.
Error Handling: Implement proper error handling to manage API responses.
3.
Webhook Integration: Configure webhook notifications to receive real-time updates about transaction status changes.
4.
Retry Logic: Implement retry logic for API calls to handle temporary network issues.
5.
Logging: Log all API requests and responses for debugging and auditing purposes.
Flow Diagram#
For a visual representation of the transaction analysis process, see the Flow Diagram.Available Cryptocurrencies#
Modified at 2025-05-29 15:06:03
