In case of MyBank payment method, there is one more step for the buyers before being sent to the third-party processor: they must choose their bank from a list of participating banks.
Merchants can embed this phase in their websites, in order to manage the payment method choice and provide their buyers with the same experience of direct connections to the third party processors.
This can be done through a feature called “Payment Type Detail”.
Merchants are free to use this option or not: if they do not use it and they simply set <paymentType>MYBANK</paymentType> in their call to Encrypt method of WsCryptDecrypt web service, then the buyer will find in Axerve Ecommerce Solutions a page where it will choose its bank among those available for that kind of payment.
Merchants who want to use “Payment Type Detail” for MyBank must be able to show to their buyers the list of the banks available for that kind of Payment.
They can store the list of those banks in their local storage and keep it updated by periodically calling the methods CallMyBankListS2S of WsS2S web service.
These methods will return a list of banks made like this:
1<BankList> 2 <Bank> 3 <BankCode>Code0001</BankCode> 4 <BankName>Name of Bank 1</BankName> 5 </Bank> 6 ... 7 <Bank> 8 <BankCode>Code0000N</BankCode> 9 <BankName>Name of Bank N</BankName> 10 </Bank> 11</BankList>
There is no need to update the lists of the banks for each transaction.
Could be necessary to update the list every day, because the banks partecipating to MyBank can change dayly.
The update should consist of a complete replacement of each list with the new values returned by WsS2S web service.
The merchant page should show the list of the BankNames and use the corresponding BankCode.
The BankCode must be used for paymentTypeDetail tag, while calling the Encrypt method of WsCryptDecrypt web service, as a value for MyBankBankCode, depending on the payment method. For example, for a MyBank transaction for which the buyer has chosen “Name of Bank X”, the merchant should call encrypt method with, among the others, these values:
1... 2<paymentTypes> 3 <paymentType>MYBANK</paymentType> 4</paymentTypes> 5<paymentTypeDetail> 6 <MyBankBankCode>Code0000X</MyBankBankCode> 7</paymentTypeDetail> 8...
To retrieve the MyBank Bank List the correct WSs2s web service method to use for this purpose is callMyBankListS2S.
Before using this method, it is necessary to assign to WSs2s all of the information required:
shopLogin (merchant code)
languageID Id of the language of the Bank List.
The callMyBankListS2S method retrieves from Axerve Ecommerce Solutions the MyBank Bank List.
After the callMyBankListS2S method has been performed, it is possible to know the outcome of the operation by using the values in the relevant fields:
First it is possible to use the TransactionResult method which will return the string OK if the check has been performed or the string KO if not.
ErrorCode Returns error code
ErrorDescription Returns error description
BankList Returns a list of banks splits into Bank nodes. Each Bank node has two elements:
BankCode Returns the Bank Code
BankName Returns the Bank Name