Settle an authorized payment
This is the financial confirmation operation which may follow a positive authorisation.
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 Gestpay.
It is however also possible to use the code assigned to the transaction by the merchant (
shopTransID), taking care to ascertain 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 assign to
CallSettleS2S also the amount to be settled and the currency code in which this amount is expressed (obviously the currency may be the same as the authorised currency).
In order to do all this, it is sufficient to fill the following specific fields:
bankTransID(GestPay 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 in the following fields in the response:
0, everything is OK)
ErrorDescription(contains a textual explanation of the
ErrorCode, in the configured language).
If the settlement request will receive a negative result due to technical problems the transaction state will change to
PREand the settlement will be done automatically by GestPay the first night after the request.