Swissbilling
1. Introduzione
SwissBilling è un'azienda svizzera fondata nel 2011 appartenente al gruppo Cembra Money Bank. La sua principale attività è l'erogazione un metodo di pagamento online di semplice utilizzo che consente il pagamento con fattura online ai clienti svizzeri. Questa soluzione consente al cliente di pagare un acquisto entro x giorni dalla
ricezione. Il commerciante può modificare la fattura prima (cancellazione) o dopo (rimborso) la spedizione.
Prima di accettare un pagamento, Swissbilling esegue un controllo dell'affidabilità creditizia verificando i database svizzeri e la cronologia dei crediti del cliente di SwissBilling. Quando un ordine viene approvato, SwissBilling apre una nota di credito per i clienti e ne valuta l'idoneità e le richieste di pagamento. Il metodo di pagamento prediletto tra i clienti svizzeri è il pagamento con fattura.
2. Flusso
Le transazioni SwissBilling seguono questo flusso:1. Il consumatore riempie il suo carrello sul sito Web del commerciante ed effettua il pagamento scegliendo SwissBilling come metodo di pagamento. La pagina di selezione del metodo di pagamento può essere ospitata dal commerciante o da PostFinance.
2. Il consumatore viene reindirizzato a SwissBilling tramite un URL fornito da SwissBilling, che comprende un riferimento univoco alla transazione e l'ID del commerciante.
3. Il consumatore richiede di pagare con il metodo Pagamento con fattura (pagamento dopo la consegna). SwissBilling verifica quindi l'affidabilità creditizia del cliente.
4. Il consumatore viene reindirizzato al commerciante tramite PostFinance. A questo punto, il commerciante riceve lo stato della transazione tramite PostFinance.
3. Integrazione
3.1 Configurazione
Per attivare il metodo di pagamento, il commerciante deve aver sottoscritto un contratto di acquisizione con SwissBilling.
Dopo aver sottoscritto un contratto di vendita con un metodo di pagamento, il commerciante deve contattare il nostro servizio di assistenza per i commercianti per configurare e attivare il metodo di pagamento.
Dopo la configurazione e l'attivazione, il metodo di pagamento è disponibile nella sezione relativa al Web banking dei "Metodi di pagamento" nell'account di PostFinance.
Per configurare un account, eseguire le seguenti operazioni:
- Il commerciante sottoscrive un contratto con SwissBilling.
- Il commerciante o SwissBilling fornisce i dettagli al servizio di assistenza per i commercianti.
- PostFinance provvede all'attivazione di SwissBilling per il commerciante.
3.2 Scelta del metodo di pagamento
| Descrizione |
|---|
| PM / BRAND: SwissBilling |
3.3 Parametri di immissione
| Parametro | Descrizione |
|---|---|
| PSPID | Nome di affiliazione al nostro sistema Lunghezza: 50 Obbligatori |
| ORDERID | Rif. ordine per il commerciante Lunghezza: 50 Obbligatori |
| Indirizzo e-mail del cliente Lunghezza: 6 Obbligatori |
|
| AMOUNT | Importo della transazione Lunghezza: 6 Obbligatori |
| CURRENCY | Valuta dell'ordine (con SwissBilling è sempre CHF) Lunghezza: ISO Alpha code Obbligatori |
| LANGUAGE | Lingua del cliente Lunghezza: 5 Opzionali |
| REF_CUSTOMERID | Numero del cliente Lunghezza: 20 Opzionali |
| ECOM_BILLTO_COMPANY | Nome dell'azienda del cliente Lunghezza: 50 Opzionali |
| ECOM_BILLTO_POSTAL_NAME_PREFIX | Prefisso del cliente Lunghezza: 4 Opzionali |
| ECOM_BILLTO_POSTAL_NAME_LAST | Cognome del cliente Lunghezza: 35 Obbligatori |
| ECOM_BILLTO_POSTAL_NAME_FIRST | Nome del cliente Lunghezza: 35 Obbligatori |
| ECOM_BILLTO_POSTAL_STREET_NUMBER | Numero civico del cliente Lunghezza: 10 Obbligatori |
| ECOM_BILLTO_POSTAL_STREET_LINE1 | Via del cliente (riga 1) Lunghezza: 35 Obbligatori |
| ECOM_BILLTO_POSTAL_STREET_LINE2 | Via del cliente (riga 2) Lunghezza: 35 Opzionali |
| ECOM_BILLTO_POSTAL_POSTALCODE | CAP del cliente Lunghezza: 5 Obbligatori |
| ECOM_BILLTO_POSTAL_CITY | Città del cliente Lunghezza: 25 Obbligatori |
| ECOM_BILLTO_POSTAL_COUNTRYCODE | Codice paese del cliente Lunghezza: 2 Obbligatori |
| ECOM_BILLTO_TELECOM_MOBILE_NUMBER | Numero di cellulare del cliente Lunghezza: 20 Opzionali |
| ECOM_BILLTO_TELECOM_PHONE_NUMBER | Numero di telefono del cliente Lunghezza: 20 Opzionali |
| ECOM_SHIPTO_COMPANY | Nome dell'azienda del cliente per la spedizione Lunghezza: 50 Opzionali |
| ECOM_SHIPTO_POSTAL_NAME_PREFIX | Prefisso del cliente per la spedizione Lunghezza: 4 Opzionali |
| ECOM_SHIPTO_POSTAL_NAME_FIRST | Nome del cliente per la spedizione Lunghezza: 35 Obbligatori |
| ECOM_SHIPTO_POSTAL_NAME_LAST | Cognome del cliente per la spedizione Lunghezza: 35 Obbligatori |
| ECOM_SHIPTO_POSTAL_STREET_NUMBER | Numero civico del cliente per la spedizione Lunghezza: 10 Obbligatori |
| ECOM_SHIPTO_POSTAL_STREET_LINE1 | Via del cliente per la spedizione (riga 1) Lunghezza: 35 Obbligatori |
| ECOM_SHIPTO_POSTAL_STREET_LINE2 | Via del cliente per la spedizione (riga 2) Lunghezza: 35 Opzionali |
| ECOM_SHIPTO_POSTAL_POSTALCODE | CAP del cliente per la spedizione Lunghezza: 5 Obbligatori |
| ECOM_SHIPTO_POSTAL_CITY | Città del cliente per la spedizione Lunghezza: 25 Obbligatori |
| ECOM_SHIPTO_POSTAL_COUNTRYCODE | Codice paese del cliente per la spedizione Lunghezza: 2 Obbligatori |
| ECOM_SHIPTO_TELECOM_MOBILE_NUMBER | Numero di cellulare del cliente per la spedizione Lunghezza: 20 Opzionali |
| ECOM_SHIPTO_TELECOM_PHONE_NUMBER | Numero di telefono del cliente per la spedizione Lunghezza: 20 Opzionali |
| GENERIC_BL_DATA | Blacklist generica del commerciante Lunghezza: 50 Opzionali |
| ITEMIDX | Codice articolo Lunghezza: 15 Obbligatori |
| ITEMNAMEX | Nome articolo Lunghezza: 40 Obbligatori |
| ITEMPRICEX | Prezzo unitario dell'articolo. Solo ITEMPRICEX accetta l'importo immesso Lunghezza: 10 Obbligatori |
| ITEMVATCODEX | Codice IVA articolo Lunghezza: 6 Obbligatori |
| ITEMQUANTX | Quantità articolo Lunghezza: 4 Obbligatori |
| ITEMCATEGORYX | Categoria articolo Lunghezza: 50 Obbligatori ITEMCATEGORYX accetta soltanto i seguenti valori:
prima definire le categorie (ITEMCATEGORY1=SPORT, ITEMCATEGORY2=FOOD, etc.) poi usare il parametro nella transazione, ad esempio:“<input type="hidden" name="ITEMCATEGORY1" value="SPORT"/>” . Bisogna usare 1* ITEMCATEGORY per ogni articolo, ad esempio: <input type="hidden" name="ITEMCATEGORY1" value="SPORT"/> <input type="hidden" name="ITEMID1" value="2855"/> <input type="hidden" name="ITEMNAME1" value="Adibok Supershoe"/> <input type="hidden" name="ITEMPRICE1" value="3999"/> <input type="hidden" name="ITEMQUANT1" value="1"/> <input type="hidden" name="ITEMVATCODE1" value="20%"/> <input type="hidden" name="TAXINCLUDED1" value="1"/> |
| TAXINCLUDEDX | È necessario inviare sempre il valore TAXINCLUDEDX = 1 Lunghezza: 1 Obbligatori |
NOTE IMPORTANTI:
- SwissBilling può essere usato soltanto con la valuta CHF e clienti svizzeri. Un oggetto deve anche avere un prezzo più alto di 0.00CHF
- Il commerciante può scegliere una soluzione B2B o B2C al momento dell'iscrizione; se sceglie B2B, i parametri del nome dell'azienda sono obbligatori.
- Gli indirizzi di spedizione e di fatturazione per SwissBilling devono corrispondere perché l'ordine venga approvato!
4. Elaborazione delle transazioni e operazioni di manutenzione
4.1 Svolgimento delle operazioni di manutenzione
Le operazioni di manutenzione (come acquisizioni dei dati, annullamenti, rimborsi, ecc.) per SwissBilling possono essere eseguite tramite le funzionalità manuali standard disponibili nel Back Office o tramite DirectLink (manutenzione diretta).4.1.1 Svolgimento delle operazioni di manutenzione dal Back Office
Conferma delle transazioni autorizzate
Per elaborare e confermare le transazioni con la procedura di pagamento "Acquisizione dei dati da parte del commerciante (manuale o automatica)", eseguire le seguenti operazioni:
1. Selezionare quest'opzione da Configurazione > Informazione tecniche > Parametri globali transazione > Procedura di acquisizione predefinita dei dati (pagamento).
2. Confermare manualmente la transazione quando lo stato è "5 - Autorizzato". Un'autorizzazione è semplicemente una prenotazione dell'importo sulla carta/conto del cliente (o una corrispondenza nella blacklist). NON costituisce un pagamento.
a. Cercare la transazione da Operazioni > Visualizza le transazioni.
b. Fare clic sul pulsante Conferma pagamento (acquisizione dati): XXXXXXXX/X in fondo alla scheda con i dettagli dell'ordine.
- Lo stato diventa "91 - Elaborazione pagamento".
- Dopo aver ricevuto la conferma di acquisizione dei dati da parte dell'acquirente, lo stato diventa "9 - Pagamento richiesto". Questo stato significa che abbiamo chiesto all'acquirente di trasferire l'importo prenotato sul conto bancario. Dato che è l'acquirente a trasferire l'importo sul conto bancario, non possiamo indicare esattamente quando arriverà il pagamento.
Si preferiscono le operazioni automatizzate?
Batch: Inviare il codice operazione SAS nel campo 10
DirectLink: Inviare l'operazione=SAS
Eliminazione e rimborso dei pagamenti
Eliminazione e rimborso dei pagamenti
L'eliminazione di un pagamento è l'operazione con cui si annulla una richiesta di pagamento inviata all'acquirente. Quest'operazione è possibile esclusivamente per i pagamenti in carta di credito. L'eliminazione di un pagamento non implica normalmente alcun prelievo di denaro dal conto bancario del cliente (nessun addebito né accredito sul conto bancario del cliente).
Limitazione: è possibile eliminare un pagamento il giorno dell'acquisizione dati fino al cutover, in base alla configurazione dell'account). Il "cutover" è l'ora in cui inviamo tutte le richieste di pagamento all'acquirente. Può variare a seconda dell'acquirente, ma corrisponde generalmente alle ore 16.00 o 24.00 CET. Qualora il cliente cambiasse idea dopo tale scadenza, sarà necessario procedere a un rimborso per restituire il denaro.
Per eliminare un pagamento:
1. Cercare la transazione da Operazioni > Visualizza le transazioni.
2. Fare clic sul pulsante Elimina pagamento: XXXXXXXX/X in fondo alla scheda "Ordine".
Si preferiscono le operazioni automatizzate?
Batch: Inviare il codice operazione DES nel campo 10
DirectLink: Inviare OPERATION=DES
Rimborso di un pagamento
Il rimborso implica il successivo riaccredito sul conto bancario del titolare della carta dell'importo inizialmente addebitato. Entrambi i movimenti compaiono sull'estratto conto bancario del titolare della carta.
Limitazioni:
- Quest'opzione deve essere attivata per l'account.
- L'acquirente deve autorizzare i rimborsi.
- I rimborsi devono essere consentiti in base al metodo di pagamento specifico. La disponibilità dell'opzione di rimborso dipende dall'abbonamento sottoscritto.
Se l'acquirente non acconsente ai rimborsi automatici, questi ultimi dovranno essere effettuati direttamente dall'acquirente. Come si rimborsa un pagamento?
transazione.
2. Fare clic sul pulsante Rimborso, visualizzato in fondo alla scheda Ordini. È possibile anche indicare un
motivo per il rimborso. Si preferiscono le operazioni automatizzate?
Batch: Inviare il codice operazione RFS nel campo 10
DirectLink: Inviare OPERATION = RFS
Si desidera rimborsare un importo superiore all'importo pagato?
Per le carte di credito, è possibile effettuare un rimborso superiore all'importo pagato in origine. Tuttavia, occorre tenere conto delle limitazioni sopra indicate, insieme all'eventualità che l'acquirente con carta di credito supporti o meno questa possibilità di "rimborso eccedente". Inoltre, è necessario attivare l'opzione di Manutenzione parziale nell'account, in modo che sia possibile cambiare l'importo originale nel riepilogo della transazione. Per usare questa funzionalità è necessario rivolgersi al nostro team di assistenza ai commercianti.
Si desidera rimborsare un importo superiore all'importo pagato?
Per le carte di credito, è possibile effettuare un rimborso superiore all'importo pagato in origine. Tuttavia, occorre tenere conto delle limitazioni sopra indicate, insieme all'eventualità che l'acquirente con carta di credito supporti o meno questa possibilità di "rimborso eccedente". Inoltre, è necessario attivare l'opzione di Manutenzione parziale nell'account, in modo che sia possibile cambiare l'importo originale nel riepilogo della transazione. Per usare questa funzionalità è necessario rivolgersi al nostro team di assistenza ai commercianti.
Operazioni speciali sulle transazioni autorizzate
La richiesta di un'autorizzazione implica la verifica della validità della carta/del conto e la rispettiva disponibilità di fondi. Ogni acquirente può quindi prenotare l'importo di denaro specifico richiesto sulla carta/sul conto del cliente per un periodo di tempo predefinito e per uno specifico commerciante. Oltre a richiederle, il nostro sistema consente anche di eliminare e rinnovare le autorizzazioni e di eseguire autorizzazioni manuali. Le ultime due operazioni sono possibili solo per i pagamenti con carta di credito.
Eliminazione di un'autorizzazione
Ogni volta che una transazione viene autorizzata significa che l'acquirente prenota un importo di denaro specifico sulla carta/sul conto del cliente (o che la richiesta viene confrontata con una blacklist) da corrispondere quando verrà richiesto il pagamento. Benché la nostra piattaforma consenta di eliminare un'autorizzazione, non tutti gli acquirenti supportano questo tipo di operazione.
Per eliminare un'autorizzazione tramite la nostra piattaforma, cercare la transazione tramite la schermata di selezione Visualizza le transazioni e fare clic sul pulsante Annulla l'autorizzazione in fondo alla pagina dei dettagli dell'ordine. Simuleremo comunque l'eliminazione dell'autorizzazione, anche nel caso in cui l'acquirente non supportasse l'operazione.
Si preferiscono le operazioni automatizzate?
Batch: Inviare il codice operazione DES nel campo 10
DirectLink: Inviare OPERATION=DES
Rinnovo di un'autorizzazione
Il periodo di validità di un'autorizzazione dipende dall'acquirente. Nei dettagli di una transazione vengono visualizzati i giorni rimanenti prima della scadenza effettiva dell'autorizzazione di ogni transazione. Questo numero di giorni è indicativo. L'esatto periodo di autorizzazione è specificato nel contratto stipulato con l'acquirente.Se l'autorizzazione non è stata seguita da un'acquisizione dati (richiesta di pagamento) entro il periodo di tempo predefinito, l'autorizzazione verrà visualizzata in rosso a indicare che è scaduta. La garanzia per il commerciante circa la disponibilità del denaro sulla carta/sul conto del cliente non esiste più. È possibile richiedere comunque il pagamento (senza un'autorizzazione valida), ma il pagamento potrebbe essere rifiutato (per esempio, in caso di fondi insufficienti).
Per rinnovare un'autorizzazione, cercare la transazione tramite la schermata di selezione Visualizza le transazioni e fare clic sul pulsante Ripeti autorizzazione in fondo alla pagina dei dettagli dell'ordine (se il pulsante non risulta subito disponibile, fare prima clic sul pulsante Avanzate). Se l'autorizzazione originale è stata ottenuta con il protocollo 3-D Secure, le condizioni 3-D Secure originali potrebbero non essere più applicabili all'autorizzazione rinnovata.
In conformità con le norma VISA International e MasterCard International, il cliente deve identificarsi ad ogni autorizzazione per beneficiare della garanzia 3-D Secure. Le condizioni della garanzia condizionata dei pagamenti 3-D Secure sono concordate esclusivamente tra il commerciante e il suo acquirente. Contattare l'acquirente per ulteriori informazioni.
La disponibilità dell'opzione Ripeti autorizzazione dipende dall'abbonamento sottoscritto. L'opzione deve essere attivata dal servizio di assistenza per i commercianti.
Si preferiscono le operazioni automatizzate?
Batch: Inviare il codice operazione REN nel campo 10
DirectLink: Inviare operazione=REN
Esecuzione di un'autorizzazione manuale
Talvolta l'acquirente non emette l'autorizzazione automaticamente, per esempio quando è stato raggiunto il limite di transazioni consentito. L'acquirente rifiuta l'autorizzazione e invia un messaggio che richiede di contattare il call center del commerciante dell'acquirente. Se si contatta l'acquirente e questi decide di emettere l'autorizzazione, potrebbe comunicare il codice di autorizzazione per telefono. È possibile inserire il codice di autorizzazione comunicato dall'acquirente per telefono (o fax, ecc.) nel back office. Consultare la transazione tramite la schermata di selezione Visualizza le transazioni. Quando si richiamano i dettagli della transazione, in fondo alla pagina verrà visualizzato il pulsante Autorizzazione manuale (se il pulsante non risulta subito disponibile, fare prima clic sul pulsante Avanzate). Inserire il codice di autorizzazione comunicato dall'acquirente nel campo accanto a Autorizzazione manuale e fare clic sul pulsante Autorizzazione manuale.
Il commerciante è pienamente responsabile dell'inserimento manuale del codice di autorizzazione, anche se successivamente la transazione passa allo stato 9 e non viene effettivamente eseguito alcun pagamento. Se è stato stipulato un contratto 3-D Secure con l'acquirente, le condizioni 3-D Secure applicabili a una normale autorizzazione emessa tramite il protocollo 3-D Secure potrebbero differire da quelle per un'autorizzazione manuale.
In conformità con le norma VISA International e MasterCard International, il cliente deve identificarsi ad ogni autorizzazione per beneficiare della garanzia 3-D Secure. Le condizioni della garanzia condizionata dei pagamenti 3-D Secure sono concordate esclusivamente tra il commerciante e il suo acquirente. Contattare l'acquirente per ulteriori informazioni.
Operazioni Parziali e Multiple
Le operazioni parziali consentono di eseguire acquisizioni dati, annullamenti di autorizzazioni e rimborsi per un importo inferiore all'ordine originale. Le operazioni multiple consentono di eseguire varie acquisizioni di dati, annullamenti di autorizzazioni e rimborsi sulla stessa transazione (l'opzione per le operazioni multiple è un'opzione
distinta dall'opzione per le operazioni parziali). La disponibilità delle opzioni per le operazioni parziali e multiple dipende dal tipo di abbonamento sottoscritto e se l'acquirente consente o meno tali operazioni. L'opzione deve essere attivata dal servizio di assistenza per i commercianti. Se l'opzione per le operazioni parziali è abilitata nell'account, in fondo alla pagina dei dettagli dell'ordine e accanto ai pulsanti per le operazioni di manutenzione vengono visualizzati campi di testo in cui è possibile inserire un importo. Se l'opzione per le operazioni multiple è abilitata nell'account, accanto ai campi di testo in cui è possibile inserire un importo viene visualizzata la casella di controllo Ultimo.
Operazioni parziali
Per eseguire un'acquisizione dati/un rimborso/un'eliminazione di autorizzazioni parziale è necessario andare alla pagina dei dettagli delle transazioni in fondo alla pagina, dove si trova il pulsante Conferma il pagamento (acquisizione dati)/Rimborso/Elimina l'autorizzazione.
1. Inserire l'importo parziale nel campo accanto al rispettivo pulsante (l'importo totale è già immesso per impostazione predefinita).
2. Fare clic sul rispettivo pulsante e confermare. Si preferiscono le operazioni automatizzate?
Acquisizioni Dati
Batch: Inviare il codice operazione SAS nel campo 10
DirectLink: Inviare OPERATION=SAS
Rimborsi
Batch: Inviare il codice operazione RFS nel campo 10
DirectLink: Inviare OPERATION=RFS
Eliminazione di autorizzazioni
Batch: Inviare il codice operazione DES nel campo 10
DirectLink: Inviare OPERATION=DES
Operazioni multiple
Per eseguire un'acquisizione dati o un rimborso multiplo o un'eliminazione di autorizzazioni lasciando aperta la transazione per ulteriori operazioni di manutenzione, è necessario andare alla pagina dei dettagli della transazione in fondo alla pagina, dove si trova il pulsante Conferma il pagamento (acquisizione dati)/Rimborso/Elimina l'autorizzazione.
1. Inserire l'importo parziale nel campo accanto al rispettivo pulsante (l'importo totale è già immesso per impostazione predefinita).
2. Abilitare la casella di controllo Ultimo se questa è l'ultima operazione che si desidera eseguire sulla transazione OPPURE disabilitare la casella di controllo Ultimo se si desidera eseguire successivamente ancora un'altra operazione sulla transazione (per esempio, richiedere 50,00 EUR per le merci già spedite al cliente e richiedere l'importo residuo della transazione quando si spedirà il resto).
3. Fare clic sul rispettivo pulsante e confermare.
Si preferiscono le operazioni automatizzate?
Acquisizioni dati
Batch: Inviare il codice operazione SAL (non ultima) o SAS (ultima) al campo 10
DirectLink: Inviare OPERATION=SAL (non ultima) o OPERATION=SAS (ultima)
Rimborsi
Batch: Inviare il codice operazione RFD (non ultima) o RFS (ultima) nel campo 10
DirectLink: Inviare OPERATION=RFD (non ultima) o OPERATION=RFS (ultima)
Eliminazione di autorizzazioni
Batch: Inviare il codice operazione DEL (non ultima) o DES (ultima) nel campo 10
DirectLink: Inviare OPERATION=DEL (non ultima) o OPERATION=DES (ultima)
4.1.2 Svolgimento delle operazioni di manutenzione da DirectLink
Manutenzione direttaUna richiesta di manutenzione diretta dall'applicazione consente di:
- Eseguire automaticamente un'acquisizione dati (pagamento) di un ordine autorizzato (e non manualmente nel back office);
- Revocare l'autorizzazione di un ordine;
- Rinnovare l'autorizzazione di un ordine;
- Rimborsare un ordine pagato.
Acquisizioni di dati, annullamenti delle autorizzazioni e rinnovi delle autorizzazioni sono operazioni specifiche per i commercianti che hanno configurato il loro account/richieste per eseguire l'autorizzazione e l'acquisizione dei dati in due passaggi.
Richiesta di manutenzione1. URL della richiesta
- L'URL della richiesta nell'ambiente di prova è https://epayment.postfinance.ch/ncol/test/maintenancedirect.asp.
- L'URL della richiesta nell'ambiente di PRODUZIONE è https://e-payment.postfinance.ch/ncol/prod/maintenancedirect.asp.
Quando si passa all'account di produzione, sostituire "test" con "prod" nell'URL della richiesta. Se si dimentica di modificare l'URL della richiesta, quando si iniziano ad elaborare ordini reali, le transazioni di manutenzione verranno inviate all'ambiente di prova e non agli acquirenti/banche.
1.2 Parametri della richiesta
La seguente tabella contiene i parametri della richiesta obbligatori per eseguire un'operazione di manutenzione:
| Campo | Descrizione |
|---|---|
| AMOUNT | Importo dell'ordine moltiplicato per 100. È obbligatorio soltanto se l'importo della manutenzione non corrisponde all'importo dell'autorizzazione originale. Si consiglia comunque di usarlo in ogni caso. Il sistema verifica che l'importo della transazione di manutenzione non sia superiore all'importo della transazione/pagamento. |
| OPERATION |
Valori possibili:
|
| ORDERID | È possibile inviare il codice PAYID o orderID per individuare l'ordine originale. Si consiglia di usare PAYID. |
| PAYID | Il codice PSPID del conto |
| PSPID | L'identificazione della PSP |
| PSWD | La password dell'utente API |
| SHASIGN |
Firma (stringa con hash) per l'autenticazione dei dati (vedere firma SHA-IN-signature) |
| USERID |
Utente API |
1.2.1 Pagina di prova
È possibile testare qui le richieste di manutenzione diretta: https://e-payment.postfinance.ch/ncol/test/testdm.asp
2. Risposta di manutenzione
Il server restituisce una risposta XML alla richiesta di manutenzione:
Esempio di risposta XML a una richiesta di manutenzione diretta
<?xml version=”1.0”?>
< ncresponse orderID=”99999” PAYID=”1111111” PAYIDSUB=”3” NCSTATUS=”0” NCERROR=””
NCERRORPLUS=”” ACCEPTANCE=”12345” STATUS="91" amount="125" currency="EUR"/>
La seguente tabella contiene un elenco degli attributi del tag ncresponse:
| Campo | Descrizione |
|---|---|
| ACCEPTANCE | Il codice di accettazione restituito dall'acquirente |
| AMOUNT | Importo dell'ordine (non moltiplicato per 100) |
| CURRENCY | Valuta dell'ordine |
| NCERROR | Codice errore |
| NCERRORPLUS | Spiegazione del codice di errore |
| NCSTATUS | Prima cifra di NCERROR |
| ORDERID | Riferimento dell'ordine |
| PAYID | Riferimento del pagamento nel nostro sistema |
| PAYIDSUB |
ID del livello cronologico della transazione di manutenzione PAYID |
| STATUS | Stato della transazione (Possible statuses) |
Gli attributi standard del tag ncresponse sono gli stessi della risposta XML a un nuovo ordine, ad eccezione dell'attributo aggiuntivo PAYIDSUB.
1.3 Richiesta duplicata
Se la manutenzione viene richiesta due volte per lo stesso ordine, teoricamente la seconda richiesta verrà rifiutata con il codice errore "50001127" (Ordine non autorizzato), perché la transazione riuscita originale cambierà lo stato dell'ordine.
4.1.3 Autorizzazione e acquisizione
SwissBilling segue un flusso in due passaggi che significa che l'autorizzazione e l'acquisizione possono essere separate nel processo dell'ordine. Soltanto le acquisizioni complete tuttavia sono accettate da SwissBilling.
4.1.4 Rimborsi
Per maggiori informazioni sui rimborsi vedere il capitolo 3.1 Svolgimento delle operazioni di manutenzione.
4.1.5 Verifica delle credenziali
Le verifiche vengono eseguite su SwissBilling. Per configurare il testing end-to-end, rivolgersi al nostro servizio assistenza per i commercianti.Le verifiche devono essere eseguite con l'ID commerciante, password e ID del negozio fornito al momento della sottoscrizione del contratto con SwissBilling.