MyBank

In caso si usi MyBank come metodo di pagamento, c’è un passaggio in più per l’acquirente prima di essere indirizzato al processore di terze parti: deve scegliere la sua banca da un lista di banche che supportano il servizio.

Gli esercenti possono integrare questa fase nel loro sito per gestire la scelta del metodo di pagamento e offrire agli acquirenti la stessa esperienza della connessione diretta con il processore di terze parti.

Questo si può fare grazie a una funzione che si chiama “Payment Type Detail”.

Gli esercenti possono scegliere se usare questa opzione: se non lo fanno e impostano semplicemente <paymentType>MYBANK</paymentType> nella loro chiamata al metodo Encrypt del servizio web WsCryptDecrypt, allora l’acquirente troverà una pagina in Fabrick Payment Orchestra dove scegliere la sua banca tra quelle disponibili per quel tipo di pagamento.

Gli esercenti che vogliono utilizzare il “Payment Type Detail” per MyBank devono poter mostrare ai propri acquirenti la lista delle banche disponibili per questo tipo di pagamento.

Possono salvare la lista di queste banche nella loro memoria locale e aggiornarla periodicamente chiamando i metodi CallMyBankListS2S del servizio web WsS2S.

Questi metodi restituiranno una lista di banche come di seguito:

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>

Non è necessario aggiornare la lista di banche per ogni transazione, ma può essere necessario aggiornare la lista ogni giorno, perché le banche che supportano MyBank possono cambiare quotidianamente.

L’aggiornamento consiste in una completa sostituzione di ogni lista con i nuovi lavori restituiti dal servizio web WsS2S.

La pagina dell’esercente deve mostrare la lista dei nomi delle banche (BankNames) e usare il corrispondente codice della banca (BankCode).

Il BankCode deve essere usato per il tag paymentTypeDetail quando si chiama il metodo Encrypt del servizio web WsCryptDecrypt come valore per MyBankBankCode, in base al metodo di pagamento. Per esempio, per una transazione MyBank per cui l’acquirente ha scelto “Nome di Banca X”, l’esercente deve chiamare il metodo encrypt con, tra gli altri, questi valori:

1...
2<paymentTypes>
3  paymentType>MYBANK</paymentType>
4</paymentTypes>
5<paymentTypeDetail>
6  <MyBankBankCode>Code0000X</MyBankBankCode>
7</paymentTypeDetail>
8...

Lista banche MyBank

Per richiamare la lista delle banche di MyBank il metodo web service WSs2s corretto da usare per questo proposito è callMyBankListS2S.

Prima di usare questo metodo è necessario assegnare a WSs2s tutte le informazioni richieste:

• shopLogin (codice esercente)

• languageID ID della lingua della lista banche.

Il metodo callMyBankListS2S scarica la lista delle banche MyBank da Fabrick Payment Orchestra.

Dopo che il metodo callMyBankListS2S è stato eseguito è possibile conoscere il risultato dell’operazione usando i valori nei campi rilevanti:

• È possibile usare il metodo TransactionResult che restituisce la stringa OK se la verifica è stata eseguita, la stringa KO se non lo è stata.

• ErrorCode restituisce il codice d’errore

• ErrorDescription restituisce la descrizione dell’errore

• BankList restituisce una lista di banche divise in blocchi. Ogni blocco ha due elementi:

  • BankCode restituisce il codice della banca

  • BankName restituisce il nome della banca