Ultimo aggiornamento 2/05/2014

4. Collegamento del sito Web alla pagina del pagamento

4.1 Dove effettuare la configurazione?

Il collegamento tra il vostro sito Web e la nostra pagina di pagamento di e-Commerce deve essere instaurato nell'ultima pagina del carrello acquisti del vostro sito Web, quindi nell'ultima pagina del sito presentata all'acquirente.

In quest'ultima pagina è necessario integrare un modulo con campi html nascosti contenenti i dati dell'ordine. Di seguito viene raffigurato il blocco di codice da incollare nell'ultima pagina del carrello acquisti:

<form method="post" action="https://e-payment.postfinance.ch/ncol/test/orderstandard_utf8.asp" id=form1 name=form1>

<!-- parametri general: vedere Parametri del modulo -->

<input type="hidden" name="PSPID" value="">
<input type="hidden" name="ORDERID" value="">
<input type="hidden" name="AMOUNT" value="">
<input type="hidden" name="CURRENCY" value="">
<input type="hidden" name="LANGUAGE" value="">
<input type="hidden" name="CN" value="">
<input type="hidden" name="EMAIL" value="">
<input type="hidden" name="OWNERZIP" value="">
<input type="hidden" name="OWNERADDRESS" value="">
<input type="hidden" name="OWNERCTY" value="">
<input type="hidden" name="OWNERTOWN" value="">
<input type="hidden" name="OWNERTELNO" value="">


<!-- controllo prima del pagamento: vedere Sicurezza: controllo prima del pagamento -->

<input type="hidden" name="SHASIGN" value="">


<!-- informazioni sul layout: vedere Aspetto della pagina di pagamento -->

<input type="hidden" name="TITLE" value="">
<input type="hidden" name="BGCOLOR" value="">
<input type="hidden" name="TXTCOLOR" value="">
<input type="hidden" name="TBLBGCOLOR" value="">
<input type="hidden" name="TBLTXTCOLOR" value="">
<input type="hidden" name="BUTTONBGCOLOR" value="">
<input type="hidden" name="BUTTONTXTCOLOR" value="">
<input type="hidden" name="LOGO" value="">
<input type="hidden" name="FONTTYPE" value="">

<!-- reindirizzamento dopo il pagamento: vedere Feedback sulla transazione al cliente -->

<input type="hidden" name="ACCEPTURL" value="">
<input type="hidden" name="DECLINEURL" value="">
<input type="hidden" name="EXCEPTIONURL" value="">
<input type="hidden" name="CANCELURL" value="">

<input type="submit" value="" id=submit2 name=submit2>

</form> 

4.2 Parametri del modulo

Sebbene i campi PSPID, ORDERID, AMOUNT, CURRENCY e LANGUAGE siano sufficienti, consigliamo di inviare anche il nome del cliente (CN), l’indirizzo e-mail del cliente (EMAIL), indirizzo (OWNERADDRESS), città (OWNERTOWN), CAP (OWNERZIP), paese (OWNERCTY) e numero di telefono (OWNERTELNO), che possono essere strumenti utili per evitare frodi.

Nella seguente tabella viene fornita una panoramica dei campi nascosti usati per trasmettere i “parametri generali” al nostro sistema (i campi aggiuntivi vengono descritti in questo documento e nella documentazione correlata):

Campo

Descrizione

PSPID Nome di affiliazione al nostro sistema
ORDERID

Numero di ordine (riferimento per il venditore) Il sistema verifica che non sia stato richiesto due volte il pagamento dello stesso ordine.

L'ORDERID deve essere assegnato dinamicamente.

AMOUNT

Importo da pagare MOLTIPLICATO PER 100 in quanto il formato dell'importo non deve contenere decimali o altri separatori.

Il valore di AMOUNT deve essere assegnato dinamicamente.

CURRENCY

Valuta dell'ordine

Codice alfanumerico ISO, ad es. EUR, USD, GBP, ecc.

CN

Nome cliente

Preinizializzato (ma comunque modificabile) nel campo Nome cliente dei dati della carta di credito.

EMAIL Indirizzo email del cliente
OWNERADDRESS Via e numero civico del cliente
OWNERZIP CAP del cliente
OWNERTOWN Città/Località del cliente
OWNERCTY Paese del cliente
OWNERTELNO Numero di telefono del cliente

4.3 Azione del modulo

<form method="post" action="https://e-payment.postfinance.ch/ncol/test/orderstandard_utf8.asp" id=form1 name=form1>

L'azione del modulo è la nostra pagina di elaborazione del pagamento del sistema di e-Commerce.

  • Nell'ambiente di PROVA, l'URL dell'operazione è https://e-payment.postfinance.ch/ncol/test/orderstandard_utf8.asp
  • Nell'ambiente di PRODUZIONE, l'URL dell'operazione è https://e-payment.postfinance.ch/ncol/prod/orderstandard_utf8.asp

Modifica da "test" a "prod"

Quando si passa dall'account di prova all'account di produzione (dal vivo), è necessario sostituire “test” con “prod” nell'URL della pagina di pagamento.

Se si dimentica di modificare l'azione del modulo dopo essere passati alla produzione con ordini reali, le transazioni verranno inviate all'ambiente di prova e non agli acquirenti/banche, pertanto non verranno pagate.