Tara - Payment Sanction Screening (PSS) (1.2.15)
Download OpenAPI specification:Download
Transaction Screening or Payment Sanction Screening (PSS) Alert Disposition is the skill of the Digital Worker Tara. Tara is designed to identify real-time transactions or payments to or from sanctioned individuals, entities, or jurisdictions during on-boarding and throughout the customer relationship lifecycle that may pose a risk to financial institutions.
Submit payment message with screening alerts for Tara review
Submit a record for processing asynchronously. Acknowledge that the message was added to processing queue will be returned immediately. Asynchronous execution is the most efficient way for processing batches of records or high volume of records.
Authorizations:
path Parameters
| signalId required | string signal ID for the BP where the record is to be sent |
Request Body schema: application/json
Alerts to be screened. All fields besides type and hits are optional.
| sourceSystemId | string Source system number. |
| id required | string Message identification number. |
| type | string Default: "PAYMENT_TRANSFER" Payment message type. |
| subtype | string Payment message subtype. |
| content | string Optional if content already parsed and {@link Hit} tagContent and tagType provided for each hit. Otherwise, required for parsing. |
| contentFormat | string Enum: "FUF" "NATIVE" "SWIFT_MT" "SWIFT_MX" "SWIFT_NPP" "SWIFT_ADK" Required when {@link #content} field is provided. Specifies format of the {@link #content}. Otherwise Optional |
required | Array of objects (Hit) Message hits. Message without hits will not be adjudicated. |
object (PaymentInfo) Payment details. | |
object Any additional information, fields/values not specified elsewhere. |
Responses
Request samples
- Payload
{- "sourceSystemId": "string",
- "id": "string",
- "type": "SWF",
- "subtype": "103",
- "content": "string",
- "contentFormat": "FUF",
- "hits": [
- {
- "id": "string",
- "tagContent": "string",
- "tagName": "string",
- "tagType": "NAME",
- "hitStartIndex": 5,
- "hitEndIndex": 10,
- "hitText": "string",
- "hitType": "name",
- "screenedData": {
- "type": "INDIVIDUAL",
- "name": "string",
- "dob": "string",
- "address": "string",
- "country": "string",
- "city": "string",
- "state": "string",
- "postal": "string",
- "locations": [
- {
- "country": "string",
- "state": "string",
- "city": "string",
- "address": "string",
- "type": "string"
}
], - "id": "string",
- "codeMap": {
- "property1": "string",
- "property2": "string"
}
}, - "sanctionData": {
- "name": "string",
- "primaryName": "string",
- "type": "INDIVIDUAL",
- "dob": "string",
- "city": "string",
- "country": "string",
- "state": "string",
- "address": "string",
- "locations": [
- {
- "country": "string",
- "state": "string",
- "city": "string",
- "address": "string",
- "type": "string"
}
], - "sourceEntryId": "string",
- "source": "string",
- "sourceKeywords": "string",
- "listType": "string",
- "additionalInfo": "string",
- "alsoKnownAs": [
- {
- "name": "string",
- "type": "STRONG"
}
], - "codeMap": {
- "property1": "string",
- "property2": "string"
}, - "customAttributes": {
- "property1": "string",
- "property2": "string"
}
}
}
], - "payment": {
- "direction": "INCOMING",
- "receiver": {
- "name": "string",
- "type": "INDIVIDUAL",
- "bic": "string",
- "accountNumber": "string",
- "otherIdentifications": {
- "property1": "string",
- "property2": "string"
}, - "address": "string",
- "country": "string"
}, - "sender": {
- "name": "string",
- "type": "INDIVIDUAL",
- "bic": "string",
- "accountNumber": "string",
- "otherIdentifications": {
- "property1": "string",
- "property2": "string"
}, - "address": "string",
- "country": "string"
}, - "amount": 0,
- "currency": "string"
}, - "customAttributes": {
- "property1": "string",
- "property2": "string"
}
}Response samples
- 200
{- "requestId": "string",
- "status": "COMPLETED",
- "statusDetails": "Malformed request : Missing required fields",
- "format": "RAW",
- "error": "string"
}Check record processing status
Checks a record status based on the specified requestId. Returns the record processing status.
Authorizations:
path Parameters
| requestId required | string Request UUID to track a request. Returned in start-record-raw response. |
Responses
Response samples
- 200
{- "requestId": "string",
- "status": "COMPLETED",
- "statusDetails": "Malformed request : Missing required fields",
- "format": "RAW",
- "error": "string"
}Get screening decision
Gets a screening decision based on the specified requestId. Returns the record results.
Authorizations:
path Parameters
| requestId required | string Request UUID to track a request. Returned in start-record-raw response. |
Responses
Response samples
- 200
{- "requestId": "string",
- "status": "COMPLETED",
- "statusDetails": "Malformed request : Missing required fields",
- "decision": {
- "messageId": "string",
- "suggestedAction": "RESOLVE",
- "hitDecisions": [
- {
- "hitId": "string",
- "suggestedAction": "RESOLVE",
- "comment": "string",
- "reasons": [
- {
- "code": "string",
- "description": "string",
- "score": 0
}
], - "tags": [
- "string"
], - "additionalInfo": "string",
- "status": "string"
}
], - "comment": "string",
- "status": "string"
}, - "html_report_link": "string"
}Process payment message with screening alerts
Process a record synchronously. This method returns completed processing result. Response time of this method may deteriorate under high load, please use asynchronous version for higher volumes.
Authorizations:
path Parameters
| signalId required | string signal ID for the BP where the record is to be sent |
Request Body schema: application/json
Alerts to be screened. All fields besides type are optional.
| sourceSystemId | string Source system number. |
| id required | string Message identification number. |
| type | string Default: "PAYMENT_TRANSFER" Payment message type. |
| subtype | string Payment message subtype. |
| content | string Optional if content already parsed and {@link Hit} tagContent and tagType provided for each hit. Otherwise, required for parsing. |
| contentFormat | string Enum: "FUF" "NATIVE" "SWIFT_MT" "SWIFT_MX" "SWIFT_NPP" "SWIFT_ADK" Required when {@link #content} field is provided. Specifies format of the {@link #content}. Otherwise Optional |
required | Array of objects (Hit) Message hits. Message without hits will not be adjudicated. |
object (PaymentInfo) Payment details. | |
object Any additional information, fields/values not specified elsewhere. |
Responses
Request samples
- Payload
{- "sourceSystemId": "string",
- "id": "string",
- "type": "SWF",
- "subtype": "103",
- "content": "string",
- "contentFormat": "FUF",
- "hits": [
- {
- "id": "string",
- "tagContent": "string",
- "tagName": "string",
- "tagType": "NAME",
- "hitStartIndex": 5,
- "hitEndIndex": 10,
- "hitText": "string",
- "hitType": "name",
- "screenedData": {
- "type": "INDIVIDUAL",
- "name": "string",
- "dob": "string",
- "address": "string",
- "country": "string",
- "city": "string",
- "state": "string",
- "postal": "string",
- "locations": [
- {
- "country": "string",
- "state": "string",
- "city": "string",
- "address": "string",
- "type": "string"
}
], - "id": "string",
- "codeMap": {
- "property1": "string",
- "property2": "string"
}
}, - "sanctionData": {
- "name": "string",
- "primaryName": "string",
- "type": "INDIVIDUAL",
- "dob": "string",
- "city": "string",
- "country": "string",
- "state": "string",
- "address": "string",
- "locations": [
- {
- "country": "string",
- "state": "string",
- "city": "string",
- "address": "string",
- "type": "string"
}
], - "sourceEntryId": "string",
- "source": "string",
- "sourceKeywords": "string",
- "listType": "string",
- "additionalInfo": "string",
- "alsoKnownAs": [
- {
- "name": "string",
- "type": "STRONG"
}
], - "codeMap": {
- "property1": "string",
- "property2": "string"
}, - "customAttributes": {
- "property1": "string",
- "property2": "string"
}
}
}
], - "payment": {
- "direction": "INCOMING",
- "receiver": {
- "name": "string",
- "type": "INDIVIDUAL",
- "bic": "string",
- "accountNumber": "string",
- "otherIdentifications": {
- "property1": "string",
- "property2": "string"
}, - "address": "string",
- "country": "string"
}, - "sender": {
- "name": "string",
- "type": "INDIVIDUAL",
- "bic": "string",
- "accountNumber": "string",
- "otherIdentifications": {
- "property1": "string",
- "property2": "string"
}, - "address": "string",
- "country": "string"
}, - "amount": 0,
- "currency": "string"
}, - "customAttributes": {
- "property1": "string",
- "property2": "string"
}
}Response samples
- 200
{- "requestId": "string",
- "status": "COMPLETED",
- "statusDetails": "Malformed request : Missing required fields",
- "decision": {
- "messageId": "string",
- "suggestedAction": "RESOLVE",
- "hitDecisions": [
- {
- "hitId": "string",
- "suggestedAction": "RESOLVE",
- "comment": "string",
- "reasons": [
- {
- "code": "string",
- "description": "string",
- "score": 0
}
], - "tags": [
- "string"
], - "additionalInfo": "string",
- "status": "string"
}
], - "comment": "string",
- "status": "string"
}, - "html_report_link": "string"
}