You can submit transactions in any of the following ways:

• Use our API
• Create transactions manually
• Upload transactions in bulk

Once the transaction is submitted and processed, you can find it on the Transactions page.

Each transaction comprises monitoring results that may vary, depending on the transaction and applicant type. In the transaction body, you will also see the list of matched rules.

To manage transactions, use Case management.

Submit transactions via API

To submit transactions via the Sumsub API, use the following methods:

• Submit transactions individually
• Submit transactions for non-existing applicants
• Bulk transaction import

Default TM integration flow

Create transactions in the Dashboard

To create transactions in the Dashboard:

1. Open the Transactions page and click Create sample transaction.

   

2. From the Use case drop-down list, select a transaction type:

   • Fiat — foreign currency transactions.
   • Crypto transaction — cryptocurrency transfers.
   

3. From the Applicant drop-down list, select the applicant on behalf of whom you want to produce the transaction.

4. Select whether the transaction is inbound or outbound (for Fiat and Crypto transactions only).

5. Enter the transaction information based on the transaction type:

   • Fiat — amount, currency, payment details (the purpose of payment), beneficiary full name and external user ID, and the transaction date (custom or current).
   • Crypto transaction — amount, asset (cryptocurrency), payment details (the purpose of payment), blockchain TXID, sender full name, external user ID, applicant wallet address, memo/destination tag (optional — required by networks such as XRP and Stellar when sending to a shared wallet), and the transaction date (custom or current). The Memo field lets you set a memo or destination tag next to the wallet address. Some blockchains (such as XRP and Stellar) require it to identify the beneficiary when funds are sent to a shared (omnibus) wallet. Leave it empty when the network or recipient does not require one.

6. Set the custom transaction date by selecting the associated checkbox if necessary.

7. Click Create transaction.

In addition to the UI wizard, you can submit transactions in JSON on the JSON payload tab.

Device emulation

When creating a sample transaction in the Dashboard, you can emulate a device and apply different risk labels to test device-related outcomes. Device emulation is available for the following use cases: Fiat, Crypto, Login, and Sign up.

To emulate a device for a sample transaction:

1. In the Dashboard, go to Transactions and Travel Rule → Transactions.
2. Click Create sample transaction.
3. From the Use case drop-down list, select one of the supported use cases: Fiat, Crypto, Login, or Sign up.
4. Fill in the required transaction details.
5. Scroll down to the Device emulation section and select the Generate new device checkbox.
6. Select the required risk label to emulate the corresponding device-related risk outcome.
7. Click Create transaction.

Upload transactions in bulk

You can upload up to 1000 transactions in bulk using the Newline Delimited JSON format (ndjson).

Bulk uploading is available upon request. To increase your default upload limit, contact your Customer Success Manager or our Support team.

To upload transactions:

1. Go to the Transactions page.
2. From the menu, select Upload transactions.
3. Select the Score saved transactions checkbox if you want your transactions to be scored.
4. Upload a valid ndjson file.
5. Click Upload.

You can use the following templates as a reference:

• ​Template for existing applicants

• Template for non-existing applicants

Explore transaction statuses

During transaction processing, the system assigns various statuses depending on the verification stage and outcome. The following table describes each transaction status.

View transaction events

Events log activity related to transaction status changes. Every time a transaction status changes, an event is recorded for future reference.

To view events, open the Events page in the Dashboard. Transaction events are also automatically recorded in the applicant profile under Transactions → Events.