Teams & their payload API

teams and payload structure in the transaction monitoring system, each team within an organization is responsible for monitoring financial activities, such as transactions, and ensuring compliance the system supports two main types of teams transaction monitoring team this team focuses on evaluating general financial transactions for potential risks or unusual activities anti money laundering (aml) team this team specializes in detecting transactions that may be related to money laundering or other financial crimes each team is provided with a payload structure to submit transaction data for real time monitoring the payload is a standardized format used to evaluate incoming transactions against predefined rules below is an example of a typical transaction payload mandatory elements in the tm payload every transaction payload in the system must include the following mandatory fields, which cannot be null txn id a unique identifier for the transaction customer id a unique identifier for the customer associated with the transaction date time the date and time when the transaction occurred, in iso format these fields are essential for ensuring that each transaction is accurately tracked and can be processed through the system’s rules engine default values for other mandatory fields in addition to the above, all other keys defined in the team payload are also mandatory the default values for these fields are as follows float send a floating point number, e g , 12 0, 13 56 if no data is available, send 0 integer send an integer value, e g , 155, 899 if no data is available, send 0 datetime send the date and time in iso 8601 format, e g , "2024 09 25t10 45 30z" if no data is available, send an empty string "" string send text enclosed in double quotes, e g , "information" if no data is available, send an empty string "" boolean send true or false if no data is available, the default value should be false handling sensitive information for sensitive fields like cardnumber , customer id , and other customer specific data, you do not need to send the exact values you may send hashed or obfuscated values (e g , customer id as 123abc4534abc12de) to protect customer privacy ensure that the hashed value is unique and consistent , meaning if the same customer id is encountered again, the system should receive the same hashed value to correctly identify the customer following these instructions ensures that the system processes the transaction correctly and efficiently example if a transaction's amount , cardtype, riskscore is unknown, it should be sent as handling invalid transaction payloads if any required elements of the transaction payload are missing or if the instructions for sending the payload are not followed , the system will return a 422 unprocessable entity error status code 422 (unprocessable entity) response "failed to register transaction" this error will be triggered if all elements of the payload are not sent every field in the payload, as defined in the schema, must be included, even if a default value is being used incorrect data types are provided (e g , a string is sent where a float or integer is expected) default values are not respected (e g , 0 for integer or float fields, "" for string or datetime fields) make sure that all required fields are present in the payload, with correct data types and values, to avoid this error and successfully register the transaction dynamic payload structure while the mandatory elements remain constant, the other keys in the payload can vary depending on the specific requirements of the rules defined by the team for example, rules may require additional fields such as amount, currency, or txntype, based on the criteria used for evaluating transactions this flexibility allows teams to customize the transaction payload to match their specific monitoring needs while ensuring the essential details (txn id, customer id, and date time) are always included for tracking and rule evaluation generating team payload apis in the teams page under the settings section, you can generate an api key for the team that you are currently part of this api key allows you to integrate the system with external platforms follow the steps below to generate the api key go to the teams page navigate to the settings page and click on the teams tab the team that you are currently in will be displayed generate api key on this page, you will see a button labeled "generate api key" click on this button to generate a new api key for your team copy the api command after the api key is generated, the system will display the api command that includes the new key copy this api command to use in external systems for integration use the api key the api key allows external systems to send transaction data directly to our grc system by using this api key, external platforms can authenticate and securely send transactions for evaluation based on your team's configured rules store the api key securely, as it grants direct access to send transactions to your system if the key is compromised, you can regenerate a new one by following the steps provided above this functionality enables seamless integration and secure communication between your system and external applications using the team specific api key