TNB, SAP Execute Journal FT API

Date: 18/01/2023
Author: Osaid Arouri.

Purpose
SAP Fund transfer API to execute journal FT on T24.

Method
• HTTPS
• POST

Endpoint URL
• Testing environment
http://172.28.23.5/api/TTTP/ProcessRequest

• Production environment
https://services.tnbank.ps/api/TTTP/ProcessRequest

Request Body
<OpenAPIRequest>
<CompanyId>TNB</CompanyId>
<UserId>API_1</UserId>
<UserPassword>pi522clWYFyqmQEpL7TvpQ==</UserPassword>
<RequestType>ExecuteOFSSource</RequestType>
<TransactionReference>SR8l+wt9l6xos+V2Sdn5oQ==</TransactionReference>
<RequestParam1>SAPJournlEntryOFS</RequestParam1>
<RequestParams>
<OpenAPIParam>
<fieldName>DEBIT.ACCT.NO</fieldName>
<multiValueNumber>1</multiValueNumber>
<subValueNumber>1</subValueNumber>
<value>PL510001</value>
</OpenAPIParam>
<OpenAPIParam>
<fieldName>DEBIT.CURRENCY</fieldName>
<multiValueNumber>1</multiValueNumber>
<subValueNumber>1</subValueNumber>
<value>USD</value>
</OpenAPIParam>
<OpenAPIParam>
<fieldName>DEBIT.AMOUNT</fieldName>
<multiValueNumber>1</multiValueNumber>
<subValueNumber>1</subValueNumber>
<value>100</value>

1
 </OpenAPIParam>
<OpenAPIParam>
<fieldName>CREDIT.ACCT.NO</fieldName>
<multiValueNumber>1</multiValueNumber>
<subValueNumber>1</subValueNumber>
<value>ILS1470000010001</value>
</OpenAPIParam>
<OpenAPIParam>
<fieldName>CREDIT.CURRENCY</fieldName>
<multiValueNumber>1</multiValueNumber>
<subValueNumber>1</subValueNumber>
<value>ILS</value>
</OpenAPIParam>
<OpenAPIParam>
<fieldName>CREDIT.AMOUNT</fieldName>
<multiValueNumber>1</multiValueNumber>
<subValueNumber>1</subValueNumber>
<value>100</value>
</OpenAPIParam>
<OpenAPIParam>
<fieldName>L.NARRATIVE</fieldName>
<multiValueNumber>1</multiValueNumber>
<subValueNumber>1</subValueNumber>
<value>TEST API</value>
</OpenAPIParam>
<OpenAPIParam>
<fieldName>TRANSACTION.TYPE</fieldName>
<multiValueNumber>1</multiValueNumber>
<subValueNumber>1</subValueNumber>
<value>ACFP</value>
</OpenAPIParam>
</RequestParams>
</OpenAPIRequest>

• Input description:
- CompanyId: should be filled as TNB all times
- UserId: username of the API, it will be API_1 for test environment and API for Live
- UserPassword: it should be (pi522clWYFyqmQEpL7TvpQ==) for test, for live will later provide it to you.
- RequestType: it should be (ExecuteOFSSource) all times.
- TransactionReference: unique reference, more details in important notes section.
- RequestParam1: it should be (SAPJournlEntryOFS) all times.
- DEBIT.ACCT.NO: debit account number
- DEBIT.CURRENCY: debit currency
- DEBIT.AMOUNT: debit amount
- CREDIT.ACCT.NO: credit account number
- CREDIT.CURRENCY: credit currency.
- CREDIT.AMOUNT: not needed if you send the debit amount value but you need to send it empty, else
you fill the credit amount.
- L.NARRATIVE: description of the transfer should not be more than 75 chars.
- TRANSACTION.TYPE: type of the transaction, for more details see important notes section.

2
 • Important Notes:
- To create reference number, you need to:
1. Generate unique GUID max length 50.
2. You need to use AES 128-bit Method to encrypt the GUID
3. You need to use the following encryption key when encrypt the data in AES 128 bit, the encryption
key is for Test environment is ( NTQxMDY5OEI5NERCOUZCQQ== )
- The TRANSACTION.TYPE value are based on transfer type as following
a. ACFP → transfer from PL to mid account.
b. ACFI → transfer from mid account to payable account.

Response
<OpenAPIResponse
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<RequestType>ExecuteOFSSource</RequestType>
<ResponseData>xxxxxxxxxxxxx</ResponseData>
<TransactionReference>SR8l+wt9l6xos+V2Sdn5oQ==</TransactionReference>
<IsSuccess>true</IsSuccess>
<ErrorDescription />
</OpenAPIResponse>

Response Matrix
- Messages code & Messages text
Tag Name Value Note
IsSuccess true Success response
false Failed Response

Authentication
Based on username and password described above and transaction reference.

Notes
No notes found