FalconServices

Falcon services

Overview

Falcon services provide a comprehensive suite of fraud detection capabilities focused on monitoring and protecting payment card transactions and account activities. The system handles both monetary and nonmonetary data streams, combining account, customer, and transaction-level information to maintain a robust fraud detection framework.

Real-Time Authorization Engine

Instant transaction validation and decision-making for both credit and debit card purchases at point of sale.

Multi-Level Data Intelligence

Unified processing of account, customer, and card information for comprehensive fraud detection.

Dynamic Profile Management

Real-time updates and monitoring of customer profiles, travel notifications, and account changes.

 

Secure Card Data Handling

Robust PAN management system with secure mapping between cards and accounts.

Transaction Monitoring System

End-to-end tracking of retail banking transactions, payments, and fund movements.

 

Flexible Update Framework

Seamless integration of monetary and non-monetary data updates across all service levels.

 

 

Download
Version
Account Information Summary(Post)

This data feed provides account-level nonmonetary information. There is one AIS record for each account.

Status :Production
Version :V2
Product : FalconServices
Try Out   
Customer Information Summary(Post)

This record provides customer-level nonmonetary information, such as mailing address, telephone number, and relationship with the financial institution. There is one CIS record for each account.

Status :Production
Version :V2
Product : FalconServices
Try Out   
Credit Authorization(Post)

A Credit Authorization data feed contains information about a credit authorization request. A credit authorization request occurs when the card is presented to the merchant and the merchant sends the information about the purchase to the card issuer to determine whether the purchase should proceed or not. A Credit Posting data feed contains information about a credit transaction that has already occurred and is used to tell the issuer about the transaction.

Status :Production
Version :V2
Product : FalconServices
Try Out   
Debit Authorization(Post)

A Debit Authorization data feed contains information about a Debit authorization request. A Debit authorization request occurs when the card is presented to the merchant and the merchant sends the information about the purchase to the card issuer to determine whether the purchase should proceed or not. A Debit Posting data feed contains information about a Debit transaction that has already occurred and is used to tell the issuer about the transaction.

Status :Production
Version :V2
Product : FalconServices
Try Out   
Nonmonetary(Post)

This data feed provides a method to update specific fields in the customer-level, account-level, or PAN-level nonmonetary information. A nonmonetary transaction is used to convey an update to a field in a CIS, AIS or PIS record or to convey other relevant nonmonetary information, such as when a customer is traveling.

Status :Production
Version :V2
Product : FalconServices
Try Out   
PAN Information Summary(Post)

This record provides contains Primary Account Number (PAN)-level nonmonetary information. For Falcon Fraud Manager debit or credit usage, there are one or more PIS records for each account indicated by an Account Information Summary (AIS) record.

Status :Production
Version :V2
Product : FalconServices
Try Out   
Retail Banking Transactions(Post)

This data feed can be used for adding, removing, or transferring information about retail banking transactions. It contains information about a payment or deposit. A transaction occurs when funds are moved out of, or into, a retail banking account.

Status :Production
Version :V2
Product : FalconServices
Try Out   

Retail Banking Transactions

Status:

Production

Version:

V2

Product:

FalconServices

Overview

This data feed can be used for adding, removing, or transferring information about retail banking transactions. It contains information about a payment or deposit. A transaction occurs when funds are moved out of, or into, a retail banking account.

https://api-sandbox.network.global

Retail Banking Transactions

Download

Status:

Production

Version:

V2

Product:

FalconServices
/falconservices/transaction/v2/rbtran
curl --location --request POST '#{PARAM_URL}' --header 'Authorization: Bearer {{ access_token }}' {custom_headers} --data-raw '#{JSON_PAYLOAD}'
curl --location --request GET 'https://api-sandbox.network.global/v1/tokenkc/generate' \--data-raw '#{JSON_PAYLOAD}'
curl --location --request POST 'https://api-sandbox.network.global/v1/tokenkc/generate' \--data-raw '#{JSON_PAYLOAD}'

Node Child Node Type Length Description
Authorization* requiredBearer xxxx* requiredstringAuthorization Header (Bearer Token)
Content-Type* requiredapplication/json* requiredstringContent Type

Node TypeTypeLengthDescription
NISrvRequestrequest_RBTRANheadermsg_id* requiredstring12Message ID, this field should be unique id for each Api call. This will be generated from client side. If the same message ID is used the system will decline the API call with Error Description “Duplicate Message ID”
msg_type* requiredstring12Message Type – This can have either “TRANSACTION” or “ENQUIRY” As for this API the value expected is “TRANSACTION”
msg_function* requiredstring50Message functions: Should be “REP_FALCON_RBTRAN”
src_application* requiredstring10Source Application: This is a free Text and the client can populate the source system from where the API is Initiated Example: TIBCO, IB, MB No Validations of these are kept at Network Systems
target_application* requiredstring10The target_application can hold any value from FI side, this can be used by FI to check the target system of the API call
timestamp* requiredstring30Timestamp of the request - Format YYYY-MM-DDtHH:MM:SS.SS +04:00
bank_id* requiredstring4Bank Id is Unique Id 4 digit code for each client and the same will be provided once the client setup is completed in our core system. For sandbox testing – Please use “NIC”
bodytranCodestring3The action code. Note tranCode values must be greater or equal to 100.
sourcestring10Name of source application.Note A header accompanies both a message from a sender to a recipient, and a response from the recipient to the sender. In the response, the source and dest values are reversed.
deststring10Name of destination application. Note A header accompanies both a message from a sender to a recipient, and a response from the recipient to the sender. In the response, the source and dest values are reversed.
extendedHeaderstring1024Extended header. Contains data used by, and returned unaltered to, the requesting system.
workflowstring16Contains the name of the workflow to be executed by Falcon Fraud Manager.
recordTypestring8RBTRAN20.
dataSpecificationVersionstring5the value 2 should be added
clientIdFromHeaderstring16Unique identifier for the client or subclient. The value of this field is determined jointly by the client and FICO.
recordCreationDatestring8format yyyymmdd Date that this record was created. Time zone must be GMT.
recordCreationTimestring6format hhmmss Time that this record was created. Time zone must be GMT.
recordCreationMillisecondsstring3format sss Milliseconds portion of the time that this record was created.
gmtOffsetstring6Filled with blanks.
customerIdFromHeaderstring20Primary Customer Identifier. Financial institution's unique identifier for the primary customer for the account.
customerAcctNumberstring40Unique identifier for the account associated with the transaction/record.
externalTransactionIdstring32Client-generated unique transaction ID that is unique across all data feeds for a specific installation of Falcon Fraud Manager.
depositWithdrawalFlagstring1Specifies whether the transaction is a deposit or withdrawal of funds with respect to the account specified in the customerAcctNumber field. D = Funds are credited to the account (deposit), Q = Funds are debited from the account (withdrawal), C = Funds are credited to the referenced credit card on the account, P = Funds are credited to the referenced prepaid card on the account.
paymentOrderFlagstring1Indicates if this is the set-up or the processing of the payment. P = Payment/Transfer, O = Payment Order (payment set-up for delayed or recurring payments).
debitCustomerIdstring20String identifying the customer associated with the account having funds debited.
debitAcctNumberstring40The account number for the account having funds debited.
debitAcctBankIdstring20The bank ID associated with the account having funds debited.
debitAcctBranchIdstring20The branch ID associated with the account having funds debited.
debitAcctSortCodestring6The sort code associated with the account having funds debited.
debitAcctCountrystring3The country code for the country in which the account being debited is held.
debitSegmentIdstring6The segmentation ID for the account having funds debited.
debitSegmentLevelstring1Specifies the level of the segment ID in the debitSegmentId field. C = Customer level, A = Account level, T = Transaction level.
debitAmountnumber19The monetary amount debited from the debit account.
debitCurrencyCodestring3The currency code for the debitAmount field.
debitDatestring8Date on which the amount is expected to be debited from the debit account.
debitNamestring60Payer name as it appears on the payment.
debitMessagestring100Message to appear on payer's statement.
creditCustomerIdstring20String identifying the customer associated with the account having funds credited.
creditAcctNumberstring40The account number for the account having funds credited.
creditAcctBankIdstring20The bank ID associated with the account having funds credited.
creditAcctBranchIdstring20The branch ID associated with the account having funds credited.
creditAcctSortCodestring6The sort code associated with the account having funds credited.
creditAcctCountrystring3The country code for the country in which the account being credited is held.
creditSegmentIdstring6The segmentation ID for the account having funds credited.
creditSegmentLevelstring1Specifies the level of the segment ID in the creditSegmentId field. C = Customer level, A = Account level, T = Transaction level.
creditAmountnumber19The monetary amount credited to the credit account.
creditCurrencyCodestring3The currency code for the creditAmount field.
creditDatestring8Date on which the amount is expected to be credited to the credit account.
creditNamestring60Beneficiary name as it appears on the payment.
creditMessagestring100Message to the beneficiary as it appears on the payment.
exchangeRatenumber13The exchange rate used for this transaction to convert the debited currency into the credited currency.
transactionReferenceNumberstring32The Transaction Reference Number. This number uniquely identifies a given transaction.
transactionDatestring8Date of transaction in yyyyMMdd format. Time zone is specified by gmtOffset.
transactionTimestring6Time of transaction in hhmmss format. Time zone is specified by gmtOffset.
transactionTimeMillisecondsnumber3Milliseconds of the transaction. Time zone is specified by gmtOffset.
transactionAmountnumber19The debited amount (debitAmount) expressed in a constant currency.
transactionCurrencyCodestring3The currency code for the transactionAmount field.
transactionCurrencyConversionRatenumber13The multiplicative currency conversion rate used to convert the currency specified in transactionCurrencyCode to US dollars.
transactionStreetstring40Identifies the first line of the street address where the transaction occurred.
transactionPostalCodestring10Identifies the postal code of the location where the transaction occurred.
transactionCitystring40Identifies the city where the transaction occurred.
transactionStateProvincestring3The state or province where the transaction occurred.
transactionCountryCodestring3The country where the transaction occurred.
transactionTypestring1The type of the transaction: A = Amended Payment Order, D = Delayed/forward-dated single payment, I = Single Immediate payment, L = List/Bulk payment, M = Delayed/forward-dated list/bulk payment, S = Standing order/recurring single payment, T = Standing order/recurring list/bulk payment, U = Urgent single immediate transfer/payment.
accessChannelstring1Identifies the type of device through which the transaction was placed: A = ATM, B = Phone (Interactive Voice Response system), C = Computer/Internet, D = Drop box, F = Fax, G = Payment initiated using tokenization channel, M = Mobile banking through web browser, N = Mobile application, O = Other, P = Postal (Mail), R = Automatic transfer, S = Point of Sale (POS) Terminal, T = Teller window/cashier, U = In-branch kiosk/device (non-ATM), V = Phone (remote teller), Z = Direct link to back office.
processingChannelstring1Processing channel: A = ACH, B = Other deferred net settlement system, C = Check, D = Open Banking/PSD2, E = Electronic Funds Transfer (not specified elsewhere), F = FedWire, G = Other real-time gross settlement system, I = Internal Transfer, O = Other, P = Faster Payments, Q = BACS, R = CHAPS, S = SWIFT, W = Cash.
processingTypestring1Processing type through the channel: C = Credit (funds push), D = Direct Debit (funds pull).
internationalIndicatorstring1Indicates if this is an international or domestic payment/transfer: D = Domestic, I = International.
deviceIdstring40The specific identification number of the device where the transaction was initiated: ATM ID = ATM based transaction, Branch ID = Teller based transaction, Web ID = online transaction, Telephone Number = telephone transaction, Terminal ID = POS transaction, IMEI = Mobile transaction.
authenticationstring1The method that was used to authenticate the payment: M = Separate user authentication (business), N = None, O = Other, S = Single-factor authentication, T = Two-factor authentication with second factor static, U = Three-factor authentication, V = Two-factor authentication with second factor dynamic, Blank = Unknown.
serviceRepresentativeIdstring20The identification of the service representative that worked with the customer for this transaction. For branch transactions, this is the teller's ID, and for phone transactions, this is the operator's ID.
onUsFlagstring1Specifies if the transaction is on or off us. E = The transaction is external (off-us), O = The transaction is intra-brand (on-us), W = The transaction is inter-brand (on-we).
decisionstring1Decision for the transaction before reaching Falcon: A = Approve/Accepted, D = Decline/Reject, R = Refer, O = Other, Blank = Unknown.
reversalIndicatorstring1Transaction reversal indicator: D = Derogatory reversal N = Nonderogatory reversal (or derogatory status unknown) Q = Not a reversal blank = Unknown
reversedTransactionDatestring8Transaction date for the reversed transaction, in the format: yyyymmdd.
reversedTransactionTimestring6Transaction time for the reversed transaction, in the format: hhmmss.
reversalReasonstring1Reason for reversal/return: C = Account Closed, D = Check Digit Error, F = Account Frozen, I = Insufficient Funds, N = Non-Transaction Account, O = Other, S = Stopped Payment, U = Funds Uncollected, X = No Account/Unable to Locate Account.
recurringFrequencystring3An integer indicating the number of days between recurring payments. For monthly payments use 28 days. For transactionType = S. Unknown or does not apply = blank.
recurringExpireDatestring8The date after which no further recurring payments should be performed. For transactionType = S.
modelControl1string1This field is used to control Falcon model-specific features. See the model report for information on supported functionality.
modelControl2string1This field is used to control Falcon model-specific features. See the model report for information on supported functionality.
modelControl3string1This field is used to control Falcon model-specific features. See the model report for information on supported functionality.
modelControl4string1This field is used to control Falcon model-specific features. See the model report for information on supported functionality.
userIndicator01string1User-defined information. Editable in Falcon Expert rules
userIndicator02string1User-defined information. Editable in Falcon Expert rules
userIndicator03string1User-defined information. Editable in Falcon Expert rules
userIndicator04string1User-defined information. Editable in Falcon Expert rules
userIndicator05string1User-defined information. Editable in Falcon Expert rules
userCode1string6User-defined information.
userCode2string6User-defined information.
userCode3string6User-defined information.
userCode4string8User-defined information.
userCode5string8User-defined information.
userData01string6User-defined information.Editable in Falcon Expert rules.
userData02string6User-defined information.Editable in Falcon Expert rules.
userData03string6User-defined information.Editable in Falcon Expert rules.
userData04string8User-defined information. Editable in Falcon Expert rules.
userData05string8User-defined information.Editable in Falcon Expert rules.
userData06string8User-defined information.Editable in Falcon Expert rules.
userData07string10User-defined information.Editable in Falcon Expert rules.
userData08string10User-defined information.Editable in Falcon Expert rules.
userData09string15User-defined information.Editable in Falcon Expert rules.
userData10string15User-defined information.Editable in Falcon Expert rules.
userData11string20User-defined information.Editable in Falcon Expert rules.
userData12string20User-defined information.Editable in Falcon Expert rules.
userData13string40User-defined information.Editable in Falcon Expert rules.
userData14string40User-defined information.Editable in Falcon Expert rules.
userData15string60User-defined information.Editable in Falcon Expert rules.
RESERVED_01string30Reference account number associated with the transfer of funds. Populated when depositWithdrawalFlag has values of C and P. The reference account may be a credit card number (for C) or a prepaid card number (for P).
userIndicator06string1User-defined information. Editable in Falcon Expert rules.
userIndicator07string1User-defined information. Editable in Falcon Expert rules.
userCode06string3User-defined information.
userCode07string3User-defined information.
userData16string6User-defined information.
userData17string6User-defined information.
userData18string8User-defined information.
userData19string8User-defined information.
userData20string10User-defined information.
userData21string10User-defined information.
userData22string10User-defined information.
userData23string15User-defined information.
userData24string15User-defined information.
userData25string15User-defined information.
userData26string20User-defined information.
userData27string40User-defined information.
userData28string60User-defined information.
sessionIdstring40Unique identifier number of the customer's online session associated with the transaction.

{
    "NISrvRequest": {
        "request_RBTRAN": {
            "header": {
                "msg_id": "236001",
                "msg_type": "TRANSACTION",
                "msg_function": "REP_FALCON_RBTRAN",
                "src_application": "TIBCO",
                "target_application": "FALCON",
                "timestamp": "2020-07-20T10:49:02.366+04:00",
                "bank_id": "default"
            },
            "body": {
                "tranCode": "102",
                "source": "TIBCO",
                "dest": "FALCON",
                "extendedHeader": "EXTENDEDHEADER120001",
                "workflow": "modelSTUB",
                "recordType": "RBTRAN20",
                "dataSpecificationVersion": "2.0",
                "clientIdFromHeader": "D360",
                "recordCreationDate": "20230912",
                "recordCreationTime": "160912",
                "recordCreationMilliseconds": "234",
                "gmtOffset": "+03.00",
                "customerIdFromHeader": "12345000000001",
                "customerAcctNumber": "0009991110000000001",
                "externalTransactionId": "D360RBTRAN000000000001",
                "depositWithdrawalFlag": "D",
                "paymentOrderFlag": "P",
                "debitCustomerId": "12345678901234567890",
                "debitAcctNumber": "98765432109876543210",
                "debitAcctBankId": "BANKID1234",
                "debitAcctBranchId": "BRANCH01",
                "debitAcctSortCode": "123456",
                "debitAcctCountry": "840",
                "debitSegmentId": "SEG001",
                "debitSegmentLevel": "C",
                "debitAmount": 1500,
                "debitCurrencyCode": "USD",
                "debitDate": "20250120",
                "debitName": "John Doe",
                "debitMessage": "Payment for services",
                "creditCustomerId": "98765432109876543210",
                "creditAcctNumber": "01234567890123456789",
                "creditAcctBankId": "BANKID5678",
                "creditAcctBranchId": "BRANCH02",
                "creditAcctSortCode": "654321",
                "creditAcctCountry": "840",
                "creditSegmentId": "SEG002",
                "creditSegmentLevel": "C",
                "creditAmount": 1500,
                "creditCurrencyCode": "USD",
                "creditDate": "20250120",
                "creditName": "Jane Smith",
                "creditMessage": "Payment for goods",
                "exchangeRate": 1.15,
                "transactionReferenceNumber": "TXN1234567890",
                "transactionDate": "20250120",
                "transactionTime": "153500",
                "transactionTimeMilliseconds": 150,
                "transactionAmount": 1500,
                "transactionCurrencyCode": "USD",
                "transactionCurrencyConversionRate": 1.15,
                "transactionStreet": "1234 Elm St",
                "transactionPostalCode": "90001",
                "transactionCity": "Los Angeles",
                "transactionStateProvince": "CA",
                "transactionCountryCode": "US",
                "transactionType": "I",
                "accessChannel": "M",
                "processingChannel": "A",
                "processingType": "C",
                "internationalIndicator": "D",
                "deviceId": "ATM12345",
                "authentication": "T",
                "serviceRepresentativeId": "12345",
                "onUsFlag": "E",
                "decision": "A",
                "reversalIndicator": "D",
                "reversedTransactionDate": "20250120",
                "reversedTransactionTime": "123456",
                "reversalReason": "C",
                "recurringFrequency": "28",
                "recurringExpireDate": "20260101",
                "modelControl1": "A",
                "modelControl2": "B",
                "modelControl3": "C",
                "modelControl4": "D",
                "userIndicator01": "A",
                "userIndicator02": "B",
                "userIndicator03": "C",
                "userIndicator04": "D",
                "userIndicator05": "E",
                "userCode1": "UC1",
                "userCode2": "UC2",
                "userCode3": "UC3",
                "userCode4": "UC4",
                "userCode5": "UC5",
                "userData01": "U DAT1",
                "userData02": "U DAT2",
                "userData03": "U DAT3",
                "userData04": "USR DAT4",
                "userData05": "USR DAT5",
                "userData06": "USR DAT6",
                "userData07": "USER DAT07",
                "userData08": "USER DAT08",
                "userData09": "USER DATA 09000",
                "userData10": "USER DATA 10000",
                "userData11": "USER DATA 110000000",
                "userData12": "USER DATA 120000000",
                "userData13": "USER DATA 13000000000000000000000000000X",
                "userData14": "USER DATA 14000000000000000000000000000X",
                "userData15": "USER DATA 1500000000000000000000000000000000000000000000000X",
                "RESERVED_01": "123456789012345678901234567890",
                "userIndicator06": "X",
                "userIndicator07": "Y",
                "userCode06": "001",
                "userCode07": "002",
                "userData16": "abcdef",
                "userData17": "ghijkl",
                "userData18": "mnopqrst",
                "userData19": "uvwxyz01",
                "userData20": "1234567890",
                "userData21": "0987654321",
                "userData22": "abcdefghij",
                "userData23": "klmnopqrstuvw",
                "userData24": "xyz123456789abc",
                "userData25": "lmnopqrs123456",
                "userData26": "abcdefghijklmnopqrst",
                "userData27": "thisisaverylonguserdatafield",
                "userData28": "thisisaveryverylonguserdatafield123456",
                "sessionId": "abcd1234xyz5678"
            }
        }
    }
}

Node Child Node Type Length Description
Content-Typeapplication/jsonstringContent Type

Node TypeTypeLengthDescription
NISrvResponseresponse_RBTRANheadermsg_id* requiredstring12Message ID, this field should be unique id for each Api call. This will be generated from client side. If the same message ID is used the system will decline the API call with Error Description “Duplicate Message ID”
msg_type* requiredstring12Message Type – This can have either “TRANSACTION” or “ENQUIRY” As for this API the value expected is “TRANSACTION”
msg_function* requiredstring50Message functions: Should be “REP_RBTRAN”
src_application* requiredstring10Source Application: This is a free Text and the client can populate the source system from where the API is Initiated Example: TIBCO, IB, MB No Validations of these are kept at Network Systems
target_application* requiredstring10The target_application can hold any value from FI side, this can be used by FI to check the target system of the API call
timestamp* requiredstring15Timestamp of the response - Format YYYY-MM-DDtHH:MM:SS.SSS+04:00
bank_id* requiredstring4Bank Id is Unique Id 4 digit code for each client and the same will be provided once the client setup is completed in our core system. For sandbox testing – Please use “NIC”
exception_detailsapplication_name* requiredstring20Application Name
date_time* requiredstring30Timestamp of the response Format “YYYY-MM-DD HH:MM:SS”
status* requiredstring1Status of the request (S/F)
error_code* requiredstring4EAI Internal Error Code (Check error codes section for the complete list of error codes and error code descriptions)
error_description* requiredstring100Error Description (Check error codes section for the complete list of error codes and error code descriptions)
transaction_ref_idstring20The tracking_id sent in the request will be sent back in response in this field.
bodytran_code* requirednumber3The transaction code. 101 for auth, 102 for advice, 108 for profile maturation.
source* requiredstring10Name of source application. Note: A header accompanies both a message from a sender to a recipient, and a response from the recipient to the sender. In the response, the source and destination values are reversed.
destination* requiredstring10Name of destination application.
extended_header* requiredstring1024Extended header. Contains data used by, and returned/unaltered to, the requesting system. For example: Tracking identifier used by requesting system.
responseRecordVersion* requiredstring1The response_record_version specifies the version of the scoring response layout. This field is included to support building libraries that support reading multiple versions of scoring response messages.
scoreCount* requiredstring2This field specifies the number of scores in the response message and has values from 0 to 8.
decisionCount* requiredstring2This field specifies the number of decisions in the response message and has values from 0 to 10. 

{
    "NISrvResponse": {
        "response_RBTRAN": {
            "header": {
                "msg_id": "236001",
                "msg_type": "TRANSACTION",
                "msg_function": "REP_FALCON_RBTRAN",
                "src_application": "TIBCO",
                "target_application": "FALCON",
                "timestamp": "2020-07-20T06:49:02.366Z",
                "bank_id": "default"
            },
            "exception_details": {
                "application_name": "TCC-ADP",
                "date_time": "2023-02-01T16:39:47.314+04:00",
                "status": "S",
                "error_code": "000",
                "error_description": "Success",
                "transaction_ref_id": "236001"
            },
            "body": {
                "tran_code": 101,
                "source": "PMAX",
                "destination": "TIBCO",
                "extended_header": "EXTENDEDHEADER120001",
                "responseRecordVersion": "4",
                "scoreCount": "00",
                "decisionCount": "0"
            }
        }
    }
}

Code Description
200Sample Description
400Bad Request
401Unauthorized
403Forbidden
500Internal Server Error
502Bad gateway
503Scheduled Maintenance
504Gateway Timeout
596Service Not Found