BINETIX NETWORK

NEW! This interface is introduced and delivered with SPMM™ version 2021.

This is JSON-RPC direct invocation service provided by SPMM™ Web Service working under BINETIX® AGE™ node.

Evaluates the HTTP request body with ISO 15022 message encoded in SWIFT Information Service Character Set, and returns the evaluated result as structured JSON object with variety of fields.

The input parameters for this direct invocation can be defined as fields in:

•URI name-space, or

•HTTP Header

The HTTP header fields have highest priority over the URI name-space. For more details, see the definitions below.

The input parameters values are case insensitive.

About the data-sources:

SPMM Direct Invocations support additional connectivity to external data servers, such as data bases, data-warehouse, web-services and other specialized information services.

The connectivity to database servers is handled via proper ADBC (AGE DB Connector) Configuration.

Additionally you can specify one of the following special options:

•auto - this automatically selects one or more data-sources, if defined, that best fit to the selected messages type.

•bankway - this selects connectivity via BINETIX® MQ or IBM® MQ to Bankway® International by FIS Corporation.

Note: The IBM® MQ connectivity requires additional installation of the IMQC plug-in.

•evaluate_customer

•search_customers

ATTENTION! The URI fields have lower priority when overlapped to respective HTTP header fields.

This JSON object contains fields and sub-fields generated as a result of the Evaluation/Search process of ISO 15022 Message (MT).

The direct invocation evaluates and calculates the financial risk in accordance with the payment direction mode.

•In "input" mode the risk assessment is commenced usually for the Creditor;

•In "output" mode risk assessment is commenced usually for the Debtor;

Data Object Sample:

IMPORTANT NOTE:

The sample above just demonstrates a possible result of the Evaluation or Search processes. Check-out the reference section to get the complete description of all fields.

The risk assessment is commenced usually on client site only (for Debtor or Creditor respectively), however, the configuration allows you to enable the self-assessment mode where the risk_assessment section is applied for the Debtor and for the Client.

The result of the Evaluation Process is embedded into the Creditor's and Debtor's objects and it is the same as described for evaluate_customer method.

Respectively, the Search Process with Risk assessment is embedded for Creditor or Debtor and it is the same as described for search_customers method.

https://localhost:8061/binetix/spmm/message?type=mt

POST /binetix/spmm/message HTTP/1.1

Authorization: Bearer Y1B874IJkOHOr7L0VQTi

Cache-Control: no-cache

Content-Type: text/plain

Spmm-Message-Mode: input

{1:F01ABCDEFGHAXXX6727334827}{2:I31507201013XXXXXXXXXXXX12345678902010131607N}{3:{108:PCE1E20101371310}{119:ABC}{121:56565656-4848-4f4f-a1c1-665544331508}}{4:
:20:A00E373737201013
:23B:CRED
:32A:201013EUR17000,85
:33B:EUR17000,85
:50K:/UA049693557394457139250890337
1/COMPANY LTD
2/OSTROVSKOHO STR. 29-D
3/UA/IVANO-FRANKIVSK 770178/UA/3861
:52A:96935573
:57A:VFTB4149
:59:/BG23VFTB41498437911089
BINETIX LLC
1 DELCHEV SOFIA 1463
BULGARIA
:70:PAYMENT FOR CREAM PROFI CREAM
CONTRACT 01/01 01.12.2020
:71A:OUR
-}{5:{CHK:2FED1B193680}}

HTTP/1.1 200 OK
Date: Mon, 07 Dec 2020 13:34:17 GMT
X-Powered-By: BINETIX AGE/2021
Content-Length: 1860
Content-Type: application/json
Server: BINETIX AGE/2021
Age-Version: 2021
Age-Node: 113284791
Age-Performance-Index: 17807.4558038
Cache-Control: no-store
Pragma: no-cache

{
    "id": 0,
    "jsonrpc": "2.0",
    "result": {
        "data": {
            "creditor": {
                "clients_dataset": [
                    {
                        "client_account": {
                            "state": "invalid_data"
                        },
                        "client_account_value": null,
                        "client_address": null,
                        "client_id": null,
                        "fts_rate": 100,
                        "individual_id": {},
                        "individual_id_value": null,
                        "individual_name": "",
                        "more": null,
                        "organization_id_eik": false,
                        "organization_id_value": null,
                        "organization_name": ""
                    }
                ],
                "clients_datasource": "compare_customer",
                "clients_fts_rate": 100,
                "clients_records_found": 1,
                "company_data": {
                    "hash_bg": "Б4652",
                    "hash_en": "B532",
                    "hash_type": null,
                    "name_bg": "БИНЕТИКС",
                    "name_en": "BINETIX",
                    "type_bg": "ЕООД",
                    "type_en": "LLC"
                },
                "customer_account": {
                    "account_number": "37911089",
                    "account_type": 84,
                    "bae": 4149,
                    "bank_name": null,
                    "bban": "VFTB41498437911089",
                    "bic": "VFTB",
                    "country_code": "BG",
                    "country_name": "Bulgaria",
                    "hash": 69827136,
                    "sepa": true,
                    "source": "BG23VFTB41498437911089",
                    "state": "valid"
                },
                "customer_address": {
                    "address_bg": "1 ДЕЛЧЕВ СОФИА 1463",
                    "address_en": "1 DELCHEV SOFIA 1463",
                    "city_bg": "СОФИЯ",
                    "city_en": "SOFIA",
                    "postal_code": 1463
                },
                "risk_assessment": {
                    "no_client_address": "notice",
                    "risk_index": 1.1,
                    "risk_level": "very_high",
                    "unexpected_account": "critical",
                    "unexpected_company": "critical"
                }
            },
            "debtor": {
                "company_data": {
                    "hash_bg": "К2540",
                    "hash_en": "C515",
                    "hash_type": null,
                    "name_bg": "КОМПАНИ",
                    "name_en": "COMPANY",
                    "type_bg": "ООД",
                    "type_en": "LTD"
                },
                "customer_account": {
                    "account_number": "7394457139250890337",
                    "bank_code": 969355,
                    "bban": "9693557394457139250890337",
                    "country_code": "UA",
                    "country_name": "Ukraine",
                    "hash": 68707276,
                    "sepa": true,
                    "source": "UA049693557394457139250890337",
                    "state": "valid"
                },
                "customer_address": {
                    "address_bg": "ОСТРОВСКОХО СТР. 29-Д",
                    "address_en": "OSTROVSKOHO STR. 29-D"
                }
            },
            "mode": "input",
            "type": "iso15022_message"
        },
        "method": null,
        "module": "spmm_web_message",
        "performance": 17653.2202848,
        "timestamp": "2020-12-07T15:31:43"
    }
}