open menu
axerve docs
Pagamenti/Metodi di pagamento alternativi/iDEAL

iDEAL iDEAL

SOAP

In caso si usi iDEAL 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>S2PIDE</paymentType> nella loro chiamata al metodo Encrypt del servizio web WsCryptDecrypt, allora l’acquirente troverà una pagina in Axerve Ecommerce Solutions dove scegliere la sua banca tra quelle disponibili per quel tipo di pagamento.

Gli esercenti che vogliono utilizzare il “Payment Type Detail” per iDEAL 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 methodsCallIdealListS2S del servizio web WsS2S.

Questi metodi restituiranno una lista di banche come di seguito:

copy
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. Un aggiornamento a settimana è sufficiente, in quanto la lista delle banche che supportano iDEAL non cambia così velocemente.

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 IdealBankCode, in base al metodo di pagamento. Per esempio, per una transazione iDEAL per cui l’acquirente ha scelto “Nome di Banca X”, l’esercente deve chiamare il metodo encrypt con, tra gli altri, questi valori:

copy
1...
2<paymentTypes>
3  <paymentType>S2PIDE</paymentType>
4</paymentTypes>
5<paymentTypeDetail>
6  <IdealBankCode>Code0000Y</IdealBankCode>
7</paymentTypeDetail>
8...

Credenziali iDEAL per l’ambiente di test

iDEAL si può testare nell’ambiente di prova usando importi minimi, per esempio 10 EUR.

Quando si atterra sulla pagina di pagamento iDEAL, selezionare la banca preferita nella pagina dedicata e seguire le istruzioni per riuscire a completare il test di pagamento.

L’importo massimo pagabile da un cliente per iDEAL è:

Valuta
Importo

EUR

10.000

Lista banche iDEAL

Per richiamare la lista di banche di iDEAL il metodo web service corretto WSs2s da utilizzare è callIdealListS2Sapi link.

Prima di usare questo metodo è necessario assegnare a callIdealListS2S il seguente campo:

  • shopLogin (codice esercente)

Il metodo callIdealListS2S recupera da Axerve Ecommerce Solutions la lista di banche di iDEAL.

Una volta eseguito il metodo, è possibile conoscere l’esito dell’operazione leggendo i campi rilevanti:

  • È possibile usare il metodo TransactionResult, che restituisce la stringa OK se è stato eseguito il controllo, altrimenti restituisce la stringa KO.

  • ErrorCode restituisce il codice d’errore

  • ErrorDescription restituisce la descrizione dell’errore

  • BankList restituisce una lista di banche divise in nodi di Bank. Ogni nodo di Bank ha due elementi:

    • BankCode restituisce il codice della banca

    • BankName restituisce il nome della banca

Precedente
prevGoogle Pay™