INI order type
EBICS Client user shares the public keys for Electronic Signature with the bank through the INI (Initialization) order type.
Access
Mailbox
Description
INI is an upload key management order type. INI is used in subscriber initialization. Use INI to send the bank-technical public certificate of a customer to the bank. The order data is compressed and base64-encoded.
Self-signed certificates cannot be used for electronic signatures and consequently for user initialization (INI order type). An EBICS Client user using self-signed certificates for identification and authentication and encryption, has to use CA certificates for electronic signatures.
Parameters
Parameter | Description and value |
---|---|
HostID | The bank ID or the host ID of the bank to which the EBICS Client user submitted the order. It is a unique ID for the bank in the bank's system. |
HostUrlAlias | When configuring a bank profile, you can specify multiple host URLs and set one host URL as the default. If you want to send a request to a host URL that is not the default URL, then, specify a value for this parameter. |
PartnerID | The partner ID associated with the user ID. |
UserID | Unique ID of the user in the bank's system, which corresponds to the user created in the EBICS Client dashboard. |
SystemID | User ID of the technical user. The INI order type can be submitted by a technical user who is a delegate of the non-techncial or human user. Hence, the value of the UserID is the same as the value of the systemID. |
orderIdPrefix | EBICS Client allocates a unique order ID to each order based on the bank, user
ID, and the order type. The client generates the order ID as per EBICS specifications. The order ID
is a 4-digit alphanumeric ID. You can specify the first character of the order ID. The second,
third, and fourth characters of the order ID are alphanumeric in an ascending order (A-Z or
0-9). This parameter is used with EBICS protocol version H003 only. |
SecurityMedium | A 4-digit security number in the 0100 to 0499 range. The value cannot be changed for INI, HIA, and HPB order types. |
OrderType | The order type of the order you are submitting. In this case, INI is the order type. |
XML schema
<?xml version="1.0" encoding="UTF-8"?>
<orderMetaData xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="new_omd.xsd">
<HostID>SUBNKPK12</HostID>
<HostUrlAlias>SUBNKPK12_URL_ALIAS</HostUrlAlias>
<PartnerID>SUPKID</PartnerID>
<UserID>TECHUSER</UserID>
<SystemID>TECHUSER</SystemID>
<orderIdPrefix>S</orderIdPrefix>
<SecurityMedium>0200</SecurityMedium>
<OrderType>INI</OrderType>
</orderMetaData>