This is the financial confirmation operation which may follow a positive authorization.
The WSs2s method to be used for this purpose is CallSettleS2S, click to see the API.
However, before using this method, it is necessary to assign to CallSettleS2S arguments all the information required to securely identify the transaction to be settled.
A transaction may be uniquely identified by the pair shopLogin + bankTransId, where shopLogin is the merchant code and bankTransId is the code assigned to the transaction by Axerve Ecommerce Solutions.
It is however also possible to use the code assigned to the transaction by the merchant (shopTransID), making sure that this code uniquely identifies a transaction; otherwise CallSettleS2S will return an error code referring to a Non-uniquely identified transaction.
As a transaction may also be settled for an amount which is less that the one authorised, it is necessary to also assign to CallSettleS2S the amount to be settled and the currency code in which this amount is expressed (the currency may be the same as the authorized currency).
In order to do this, it is sufficient to fill the following specific fields:
shopLogin (merchant code)
bankTransID (Axerve Ecommerce Solutions Transaction Identification Code) or shopTransID (Merchant Transaction Identification Code)
uicCode (Currency Code, as example: 242 = EUR. See the complete currency code list).
In order to know the result of this operation it is sufficient to consult the technical result by reading the response in the following fields:
ErrorCode (if 0, everything is OK)
ErrorDescription (contains a textual explanation of the ErrorCode, in the configured language).
If the settlement request receives a negative result due to technical problems the transaction state will change to PRE and the settlement will be carried out automatically by Axerve Ecommerce Solutions the first night after the request.