Crypto transactions

Use Sumsub API to send and receive gambling transaction monitoring data.

A crypto transaction is the process of transferring cryptocurrencies from one digital wallet to another. This involves the sender initiating the transaction, which is then verified and recorded on a public ledger known as the blockchain.

Crypto transaction monitoring is intended to ensure their legitimacy and security and prevent fraudulent activities, money laundering, and other illegal actions. It also helps in identifying suspicious activities, ensuring compliance with regulatory standards, and protecting the interests of the users involved in the transaction.

Create crypto transaction

Use the type of transaction below to document all the cryptocurrency movements belonging to your users. The required fields may vary depending on the currency but basically include the following:

{
    "applicant": {
      "externalUserId": "shol1mq8xipghssepfhdht",  //Unique ID number for the applicant in your system
      "fullName": "John Smith",  //If you don't have an applicant you can still put some human-readable info here
      "dob": "1983-02-02"  //Applicant’s date of birth
    },
    "counterparty": {
      "externalUserId": "shol1mq8xipghssepfhdht",  //Unique ID number for the applicant in your system
      "paymentMethod": {  //Information about the crypto wallet
        "type": "crypto",
        "accountId": "some_accountId"  //BTC or any other unique address linked to the sender’s wallet
      }
    },
    "info": {
      "direction": "out",  //'in' for a deposit, 'out' for withdrawal
      "amount": 2.3,
      "currencyCode": "USDT",
      "cryptoChain": "BTC",  //We will automatically convert BTC or other currency into your default currency such as USD (there will be amountInDefaultCurrency field)
      "paymentTxnId": "84bf83c10dfddc9d1f0ea6a1a131c638488fb161e819dae25fd8128c671d2d5a",  //Crypto transaction ID from the blockchain. Required for crypto check requests only
      "paymentDetails": "Won a lot of money, time to party",  //The text added by the user within the payment can be utilized to identify fraudulent/risky guidelines during funds transfer
      "currencyType": "crypto"
    },
    "props": {
      "category": "e1cf5ce0-5878-4dfd-80ff-24474016e200;WITHDRAW"  //Custom values that can be used in rules
    },
    "txnId": "kkw5mbtuozdwn13qrf9fj",  //Internal transaction ID used by you
    "txnDate": "2023-09-19 14:19:06+0300"  //Transaction date. If the date is not provided, the current date will be used
  }

Check out response

The response contains the info from the created transaction (all attributes) above with additional objects that contain the current review and scoring info of the requested transaction:

{
    "id": "65a91c7bc181c8380fc1d8e5",
    "applicantId": "65a906b659df1414adf1107b",
    "scope": "events",
    "externalUserId": "dash-2385a803-1cce-46f6-a9f8-675957c0da32",
    "clientId": "clientId",
    "data": {
      "txnId": "kkw5mbtuozdwn13qrf9fj",
      "txnDate": "2023-09-19 11:19:06+0000",
      "applicant": {
        "externalUserId": "dash-2385a803-1cce-46f6-a9f8-675957c0da32",
        "fullName": "John Smith",
        "dob": "1983-02-02",
        "type": "individual",
        "device": {}
      },
      "counterparty": {
        "externalUserId": "shol1mq8xipghssepfhdht",
        "paymentMethod": {
          "type": "crypto",
          "accountId": "some_account_id"
        }
      },
      "type": "finance",
      "info": {
        "paymentTxnId": "84bf83c10dfddc9d1f0ea6a1a131c638488fb161e819dae25fd8128c671d2d5a",
        "direction": "out",
        "amount": 2.3,
        "currencyCode": "USDT",
        "cryptoChain": "BTC",
        "currencyType": "crypto",
        "amountInDefaultCurrency": 90551.1811023622,
        "defaultCurrencyCode": "EUR",
        "paymentDetails": "Won a lot of money, time to party"
      },
      "sourceKey": "123",
      "props": {
        "category": "e1cf5ce0-5878-4dfd-80ff-24474016e200;WITHDRAW"
      }
    },
    "score": 0,  //Transaction risk score
    "review": {
      "reviewId": "ZzXXc",
      "attemptId": "wPJIm",
      "attemptCnt": 0,
      "elapsedSincePendingMs": 136,
      "elapsedSinceQueuedMs": 136,
      "createDate": "2024-01-18 12:41:31+0000",
      "reviewResult": {
        "reviewAnswer": "GREEN"  //Transaction status: GREEN (approved), RED (rejected)
      },
      "reviewStatus": "completed"
    },
    "createdAt": "2024-01-18 12:41:31+0000",
    "scoringResult": {
      "score": 0,
      "dryScore": 0,  //The risk score of the transaction with regard to the matched rules in the “dry run” mode 
      "matchedRules": [],  
      "unmatchedRules": [],
      "action": "score",
      "ruleCnt": 2,  //Matched rules total
      "dryRunRuleCnt": 0,  //Matched rules in the “dry run” mode total
      "tagScores": []
    },
    "typedTags": [],
    "txnInactive": false
  }