FTOS_CB_AddContractTopUp

Adds a new record to the FTOS_CB_ContractEvent entity representing a contract top up event.

Syntax

The FTOS_CB_AddContractTopUp custom endpoint is called from within the Endpoint API endpoint. Visit the Endpoint API page for more details.

Copy 
POST <host_address>/ftosapi/automation-processors/actions/FTOS_CB_AddContractTopUp
Content-Type: application/json
            
{
    "contractNo": "<contract_number>",
    "contractID": "<contract_id>",
    "eventValue": <top_up_event_value>,
    "sourceAccount": "<source_account_number>",
    "externalIdentifier": "<external_identifier_of_the_transaction>",
    "transactionTypeGLIdentifier": "<GL_transaction_type_identifier>"
}

Here's a list of the available parameters:

Parameter Description
host_address URL of the FintechOS Platform server.
contractNo Mandatory if contractId is not filled. The number of the contract.
contractId Mandatory if contractNo is not filled. The identifier of the contract.
eventValue Mandatory. The value of the top up event.
sourceAccount Mandatory. The source account number for the top up amount. This can be the self account number from the banking product definition.
externalIdentifier Optional, string. The external identifier of the transaction.
transactionTypeGLIdentifier Optional, string. Used to differentiate between GL transactions returned for a specific contract event process type. If not set, its default value is Top Up Account.

Response

The response indicates the result of the code execution, specifically the result of creating a record in the FTOS_CB_ContractEvent entity . If the record is created successfully, its ContractTopUpIdentifier is returned.

Example

To create a new record, fill the eventValue and sourceAccount parameters and one of the contractNo or contractId parameters.

Request

Copy 
POST https://FintechOSStudio/ftosapi/automation-processors/actions/FTOS_CB_AddContractTopUp
Content-Type: application/json
            
{
    "contractNo": "8581",
    "contractID": "",
    "eventValue": 3000,
    "sourceAccount": "56767353563",
    "externalIdentifier": "",
    "transactionTypeGLIdentifier": ""
}

Response

Copy 
{
{
    "ContractTopUpIdentifier": "ECB6991",
    "IsSuccess": true
}