Fermo!Point API

Recommendations

Info

1. Inserimento di F!P come metodo alternativo di spedizione2. Sviluppo dell’interfaccia di comunicazione in standard HTTP per le chiamate /Init, GetBookingUrl, ApprovalUrl eRejectionUrl3. Salvataggio dell’ordine in stato temporaneo prima di redirigere l’utente su Fermo!Point (come avviene per i POS online)4. Salvataggio della sessione autenticata (un campo testo da aggiungere all’ordine)5. Pagine di ritorno ReturnUrl e CancelUrl per ricaricare l’ordine, cambiarne lo stato e riprendere il checkoutIndirizzi di riferimento per l’utilizzo delle APIRedirectApi, al momento, non supporta endpoint multiversione.Endpoint produzione:http://www.fermopoint.it/RedirectApiEndpoint sandbox:http://www.sandbox.fermopoint.it/RedirectApiVersione attuale: 0.9ChangelogVersione 0.9:- Prima versione pubblicaFermo!Point API – Guida all’integrazione pag. 18/22
RedirectAPI ReferenceRedirectAPI è un set di chiamate HTTP POST server-server e http GET o 302 (REDIRECT) lato client.Le chiamate server-server contengono informazioni sensibili, quindi è necessario renderle NON visibili all’utente finale.Esempio chiamata POST server-serverHTTP POST /Init=POST http://www.fermopoint.it/RedirectApi/Init HTTP/1.1Esempio chiamata REDIRECT lato clientHTTP 302 ApprovalUrl=HTTP/1.1 302 FoundLocation: http://www.fermopoint.it/RedirectApi/Approve...Ogni chiamata REDIRECT può essere sostituita da una chiamata GET:Esempio chiamata GET in sostituzione alla REDIRECTHTTP 302 ApprovalUrl = HTTP GET ApprovalUrl=GET http://www.fermopoint.it/RedirectApi/Approve... HTTP/1.1Come da specifica del flusso, tutto inizia con una chiamata server-server /Init che permette di autenticarsi, creare una nuovasessione e ottenere gli url necessari ai passi successivi.La risposta a questa chiamata è l’unica informazione aggiuntiva da salvare nel vostro database.Parametri fittizi utilizzati negli esempiCLIENT_IDpeHFRa141xCu4WFnyF8eCLIENT_SECRETQ32V3b00nb9c55*JEcbSO0r54IW23*&LwV70_9IfG56#BK3*URL DELL’E-COMMERCE http://ecommerce.comURL CONSEGNA AUTORIZZATA http://ecommerce.com/authorized/{merchantId}URL CONSEGNA ANNULLATA http://ecommerce.com/canceled/{merchantId}Attenzione la struttura degli url di ritorno all’e-commerce può essere differente, quello riportato è da intenderesolamente come un suggerimento.CODICI DI RISPOSTA ALLE CHIAMATE (ResultCode)200 = Ok201 = Authorized202 = Approved401 = Canceled402 = Rejected500 = Error501 = NoTicketsSe il codice è tra 200 e 299 tutto è andato bene, diversamente gli altri codice identificano vari errori possibili.Richiedere una sessione autenticata: /InitUna volta che l’utente, durante il processo di checkout, seleziona Fermo!Point come metodo di spedizione, dovrà essere redirettoverso la pagina di Fermo!Point che permetta di procedere alla prenotazione della consegna.Per ottenere il link di F!P a cui fare il redirect è necessario autenticarsi e aprire una sessione autenticata tramite la chiamata /Init.La /Init è una semplice chiamate HTTP POST con payload JSON composta da:ClientId e ClientSecret per l’autenticazione dell’e-commerceLinks che contiene i link alle pagine di ritorno da F!P per le due casisticheo ReturnUrl: prenotazione autorizzata, si dovrà ricaricare l’ordine salvato e far procedere l’utente dallo stepsuccessivo alla scelta della spedizioneo CancelUrl: prenotazione annullata, il cliente ha deciso di non spedire a un Fermo!Point, quindi si torna allapagina della scelta della spedizioneFermo!Point API – Guida all’integrazione pag. 19/22
Page 1 and 2: Fermo!Point APIGuida all’integraz
Page 3 and 4: Il servizio Fermo!PointFermo!Point
Page 5 and 6: Codice di esempioIl nostro team ha
Page 7 and 8: Indirizzi di riferimento per l’ut
Page 9 and 10: Api pubbliche: Negozi (Point)Lista
Page 14: Definizione degli oggetto utilizzat
Page 17: Guida all’integrazione: RedirectA
Page 21 and 22: In particolare se l’utente autori

Fermo!Point API

Create successful ePaper yourself

Delete template?

Save as template?