Amazon Pay

Perché scegliere Amazon Pay

Amazon Pay è un metodo di pagamento alternativo che consente agli acquirenti di completare i propri acquisti utilizzando le informazioni di pagamento e spedizione già salvate nel proprio account Amazon. Il vantaggio è immediato: l'acquirente non deve inserire manualmente alcun dato, con un'esperienza di checkout rapida e familiare.

Approfondimento

Per ulteriori informazioni consulta la documentazione ufficiale Amazon Pay

Servizi e funzionalità disponibili tramite integrazione Fabrick

L'integrazione di Amazon Pay con Fabrick Payment Orchestra mette a disposizione le seguenti funzionalità:

Checkout senza inserimento dati: l'acquirente utilizza i dati di pagamento e spedizione già presenti sul proprio account Amazon.
Supporto a prodotti fisici e digitali: due tipologie di configurazione PayAndShip e PayOnly.
Due modelli di integrazione: ExpressCheckout, dove Amazon gestisce l'indirizzo di spedizione durante il processo di acquisto, e ProcessOrder, dove è l'esercente a trasmettere l'indirizzo di spedizione nella richiesta di pagamento.
Separazione/contestualità tra autorizzazione e conferma finanziaria: la cattura può essere contestuale all'autorizzazione oppure disposta in un momento successivo (vedi Separazione tra autorizzazione e cattura).
Gestione avanzata delle transazioni: supporto a catture e rimborsi totali, parziali e multipli.
Recupero dell'indirizzo di spedizione: l'indirizzo raccolto da Amazon è consultabile tramite le API (vedi Recuperare l'indirizzo di spedizione).
Copertura internazionale: operatività configurabile su una o più regioni tra EU, UK, US e JP.
Notifiche asincrone (IPN): gli aggiornamenti di stato su autorizzazioni, catture e rimborsi vengono notificati da Amazon a Payment Orchestra tramite Instant Payment Notification.

Account Amazon necessario

L'acquirente deve disporre di un account Amazon attivo per completare il pagamento con Amazon Pay.

Modalità di integrazione e configurazioni supportate

Payment Orchestra supporta due modelli di integrazione con Amazon Pay, ExpressCheckout e ProcessOrder, che possono essere utilizzati in base alla tipologia di prodotto venduto.

PayAndShip per i prodotti fisici, dove è necessario fornire ad Amazon un indirizzo di spedizione valido per la gestione dell'ordine
PayOnly per i prodotti digitali, dove non è previsto l'invio di un indirizzo di spedizione

Le configurazioni disponibili sono le seguenti:

Configurazione	Tipo di prodotto	Indirizzo di spedizione
ExpressCheckout & PayAndShip	Prodotti fisici	Recuperato automaticamente dall'account Amazon dell'acquirente, non deve essere fornito dall'esercente nella richiesta di pagamento
ExpressCheckout & PayOnly	Prodotti digitali	Non richiesto
ProcessOrder & PayAndShip	Prodotti fisici	Obbligatorio: deve essere fornito dall'esercente nella richiesta di pagamento. Viene mostrato in sola lettura sul checkout Amazon e non può essere modificato dall'acquirente
ProcessOrder & PayOnly	Prodotti digitali	Non richiesto

Configurazione a livello di negozio

Il modello di integrazione e la tipologia di prodotti vengono definiti in fase di attivazione del metodo, a livello di negozio (shopLogin), e non possono essere modificati sulla singola richiesta di pagamento. Tutte le richieste di un negozio vengono elaborate secondo la configurazione assegnata.

Configurazione PayOnly

In configurazione PayOnly il flusso di pagamento è identico tra ExpressCheckout e ProcessOrder: non essendo richiesto l'indirizzo di spedizione, il checkout ha la stessa struttura indipendentemente dal modello configurato.

Separazione tra autorizzazione e cattura

Per impostare o modificare la modalità di gestione delle transazioni del metodo di pagamento:

Accedi alla Dashboard e vai su Impostazioni → Accedi alle configurazioni
Una volta reindirizzato sul backoffice, vai su Configurazioni → Ambiente e clicca su MOTO: si apre un pannello laterale con l'elenco dei metodi di pagamento attivi
Individua il metodo di pagamento e seleziona la modalità desiderata tra Contestuale e Separata

MOTO

Per approfondire il funzionamento delle due modalità, consulta la sezione separazione tra autorizzazione e cattura.

Amazon Pay su Fabrick Payment Orchestra: attivazione e modalità di integrazione

Attività richieste prima dell'attivazione

Prima di richiedere l'attivazione del metodo di pagamento, l'esercente deve completare alcune attività preliminari sul portale Amazon Pay.

Registrazione dell'account Amazon Pay Merchant

L'esercente deve disporre di un account Amazon Pay Merchant attivo. Qualora non fosse già disponibile, è necessario registrarsi tramite Amazon Seller Central e completare la procedura di configurazione dell'account Merchant (procedura dettagliata).

Recupero delle credenziali

Per richiedere l'attivazione di Amazon Pay su Payment Orchestra, l'esercente deve fornire a Fabrick tre credenziali:

Credenziale	Come ottenerla
Merchant ID	Assegnato automaticamente da Amazon al termine della registrazione dell'account Amazon Pay Merchant
Client ID	Richiede la creazione di almeno uno Store Amazon Pay dalla sezione Manage client ID/store ID(s) di Amazon Seller Central (procedura dettagliata)
MWS Auth Token	Generato tramite la procedura Amazon Pay per Solution Provider (procedura dettagliata)

Durante la generazione dell'MWS Auth Token, Amazon richiede il Developer Name e il Developer ID del Solution Provider. Questi valori identificano Fabrick come Solution Provider autorizzato da Amazon Pay:

Campo	Valore
Developer Name	`GestPay`
Developer ID	`5535-2867-1582`

Al termine della procedura Amazon rende disponibile l'MWS Auth Token, che dovrà essere comunicato a Fabrick.

Configurazione dell'endpoint IPN

Amazon Pay utilizza le Instant Payment Notification (IPN) per notificare in modo asincrono gli aggiornamenti di stato su autorizzazioni, catture e rimborsi. Prima dell'attivazione del servizio, l'esercente deve configurare in Amazon Pay l'endpoint IPN di Payment Orchestra (procedura dettagliata).

Ambiente	IPN URL
Sandbox	`https://sandbox.fabrick.com/api/fabrick/third-parties/amazonpay/gateway/v4.1/webhook`
Produzione	`https://api.fabrick.com/api/fabrick/third-parties/amazonpay/gateway/v4.1/webhook`

IPN già configurato

L'endpoint attualmente configurato non deve essere modificato né rimosso. La sua rimozione comporterebbe l'interruzione delle notifiche verso i sistemi già integrati. La procedura prevede esclusivamente l'aggiunta di un nuovo endpoint, che opererà in parallelo a quello esistente.

Configurazione dei domini autorizzati

Amazon Pay richiede la configurazione degli Allowed JavaScript Origins, ovvero dei domini autorizzati dai quali viene esposto il checkout Amazon Pay. La configurazione è necessaria solo per l'ambiente di produzione: in sandbox non è richiesto alcun dominio autorizzato (procedura dettagliata).

Parametro	Valore
Allowed JavaScript Origins	`https://web.fabrick.com`, `https://web.axerve.com`

Domini autorizzati

Dopo aver aggiunto un dominio, Amazon Pay avvia una procedura di verifica che può richiedere fino a 48 ore. Qualora il dominio venga rifiutato, cliccare l’apposito pulsante “Appeal / Ricorso” disponibile accanto a ciascun URL nella stessa sezione di Seller Central, inserendo nel campo descrittivo il seguente testo: “Allowed Redirect URL as of Amazon’s Service Provider allowlist (Fabrick/GestPay)”. Al termine della verifica, verificare nuovamente che il dominio risulti approvato.

Richiesta di attivazione

Completate le attività descritte nei paragrafi precedenti, è possibile richiedere l'attivazione di Amazon Pay comunicando a Fabrick le seguenti informazioni:

Informazione	Descrizione
Modello di integrazione	`ExpressCheckout` oppure `ProcessOrder`
Tipologia di prodotti venduti	`PayAndShip` (prodotti fisici, indirizzo di spedizione richiesto) oppure `PayOnly` (prodotti digitali, indirizzo di spedizione non richiesto)
Regioni di operatività	Una o più tra `EU`, `UK`, `US` e `JP`
Merchant ID	Identificativo del Merchant Amazon Pay
Client ID	Client ID generato su Amazon Seller Central
MWS Auth Token	Token di autorizzazione generato tramite la procedura Amazon Pay per Solution Provider

Per iniziare ad accettare pagamenti con Amazon Pay, puoi richiedere l'attivazione:

Contattando il tuo referente commerciale
Contattando l'assistenza al seguente link

Una volta completate le procedure necessarie:

Fabrick abilita Amazon Pay sul negozio e informa l'esercente.
È possibile verificare l'attivazione del metodo di pagamento all'interno della Dashboard, al percorso Workspace → Negozi → [Seleziona negozio] → Configurazioni

Amazon Pay

Attivazione completata

Da questo momento, il tuo e-commerce è pronto per accettare pagamenti Amazon Pay tramite Fabrick Payment Orchestra.

Tipologie di integrazione

Fabrick offre due modalità di integrazione per utilizzare Amazon Pay:

Integrazione hosted

Integrazioni supportate
✓Checkout Page
✓Pay By Link
✓Web Component
✗Lightbox

Amazon Pay con le configurazioni Express Checkout e Process Order & PayOnly viene mostrato direttamente nella pagina di pagamento Fabrick, senza richiedere alcun intervento di sviluppo lato merchant. Fabrick gestisce autonomamente la visualizzazione del metodo e l'intera fase di processamento. Diversamente, utilizzando la configurazione Process Order & PayAndShip, per presentare il metodo è richiesto di includere l'indirizzo di spedizione nella richiesta di pagamento, che viene gestito direttamente dall'esercente.

Amazon Pay non disponibile in Lightbox
Amazon Pay non è compatibile con l'integrazione Lightbox: anche se abilitato per lo shopLogin, il metodo non viene mostrato nella pagina di selezione.
Integrazione tramite API

Integrazioni supportate
✓API Only

In questa modalità il redirect verso Amazon Pay viene gestito direttamente tramite API. È necessario inizializzare la transazione tramite payment/create e gestire il redirect del buyer.

Testare Amazon Pay in ambiente sandbox

Per eseguire i test in ambiente sandbox è necessario creare almeno un account acquirente Amazon Pay dedicato, utilizzato esclusivamente per simulare gli acquisti durante le attività di test (procedura dettagliata).

Integrazione hosted

Per presentare Amazon Pay sulla pagina di pagamento con la configurazione Process Order & PayAndShip è necessario aggiungere nella chiamata payment/create l'oggetto shippingAddress e valorizzare i campi obbligatori richiesti dal metodo di pagamento.

Per impostare la chiamata con l'integrazione hosted, vai alla sezione creazione della transazione e redirect verso Amazon Pay e rimuovi il campo paymentType dalla chiamata payment/create.

Amazon Pay

Quando l'utente seleziona Amazon Pay, viene reindirizzato al servizio per effettuare il login e completare il pagamento.

Amazon Pay

Integrazione tramite API

Per richiedere il pagamento con Amazon Pay utilizzando l'integrazione tramite API, è necessario inizializzare la transazione tramite payment/create utilizzando il tag AMAZONPAY nel campo paymentType e gestire il redirect del buyer verso il metodo di pagamento.

Creazione della transazione e redirect verso Amazon Pay

ExpressCheckout
ProcessOrder & PayAndShip
ProcessOrder & PayOnly

Con il modello ExpressCheckout l'indirizzo di spedizione — se richiesto dal tipo di prodotto — viene recuperato direttamente dall'account Amazon dell'acquirente durante il checkout. L'esercente non deve quindi includere alcun dato di spedizione nella richiesta.

La stessa struttura si applica alle configurazioni ExpressCheckout & PayAndShip ed ExpressCheckout & PayOnly.

Request

POST /api/v1/payment/create
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json

{
    "shopLogin": "GESPAY12345",
    "amount": "10",
    "currency": "EUR",
    "shopTransactionID": "FBK_OrderID",
    "paymentType": ["AMAZONPAY"], // Per integrazione hosted eliminare questa riga
    "paymentChannel": { "channelType": ["LINK"] }
}

Con la configurazione ProcessOrder & PayAndShip l'esercente vende prodotti fisici ed è obbligato a fornire l'indirizzo di spedizione nella richiesta di pagamento. L'indirizzo viene mostrato in sola lettura all'acquirente durante il checkout su Amazon e non può essere modificato.

Request

POST /api/v1/payment/create
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json

{
    "shopLogin": "GESPAY12345",
    "amount": "10",
    "currency": "EUR",
    "shopTransactionID": "FBK_OrderID",
    "paymentType": ["AMAZONPAY"], // Per integrazione hosted eliminare questa riga
    "paymentChannel": { "channelType": ["LINK"] },
    "orderDetails": {
        "shippingAddress": {
            "firstName": "John",
            "lastName": "Doe",
            "streetName": "Piazza Gaudenzio Sella 1",
            "city": "Biella",
            "zipCode": "13900",
            "countryCode": "IT",
            "state": "BI",
            "email": "buyer@email.com",
            "primaryPhone": "3331234567"
        }
    }
}

Con la configurazione ProcessOrder & PayOnly l'esercente vende prodotti digitali e l'indirizzo di spedizione non è richiesto. La struttura della richiesta è identica a quella del modello ExpressCheckout.

Request

POST /api/v1/payment/create
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json

{
    "shopLogin": "GESPAY12345",
    "amount": "10",
    "currency": "EUR",
    "shopTransactionID": "FBK_OrderID",
    "paymentType": ["AMAZONPAY"], // Per integrazione hosted eliminare questa riga
    "paymentChannel": { "channelType": ["LINK"] }
}

In risposta viene restituito nel campo payload.userRedirect.href il link per il redirect del buyer verso Amazon Pay.

Response

{
  "error": {
    "code": "0",
    "description": "request correctly processed"
  },
  "payload": {
    "paymentToken": "f0419188-8a78-4918-913c-a491e4e78084",
    "paymentID": "1881129911957",
    "userRedirect": {
      "href": "https://sandbox-web.axerve.com/orchestra/checkout/a/f991s1ba01d24eacaa3fac4b2145262a/b/36ab092425ff34515f7430e38babb28b84f16a31d63102b829072a1366c13580ae128e86-d779-4d98-88a2-0c035bcbd42eiAQ8ZaRT3IFyanLLjcIxtsuc3DTwycBdj5FD7FjuhlKm-mNnpirMdm9p3O8bhycmHVVPz6QOyo811UzHG3csjOSlH2KbF2EiUIxEwWFPAvk9TdUDrgWtyKLJYWayfzbZlP4iULt9eHTvhJEhK21sS8Smd0hX"
    },
    "qrCode": null
  }
}

Pulsante Amazon Pay

Il link restituito può essere utilizzato sotto un pulsante Paga con Amazon Pay, rispettando le linee guida grafiche Amazon Pay.

Campi da inviare nella chiamata verso Amazon Pay

I parametri da includere nella payment/create sono riportati nella tabella seguente. I campi obbligatori sono riportati in grassetto.

L'oggetto shippingAddress è obbligatorio esclusivamente nella configurazione ProcessOrder & PayAndShip.

Shipping Address

Campo	Tipo	Descrizione
`OrderDetails.ShippingAddress.FirstName`	string	Nome del destinatario
`OrderDetails.ShippingAddress.LastName`	string	Cognome del destinatario
`OrderDetails.ShippingAddress.StreetName`	string	Indirizzo e numero civico
`OrderDetails.ShippingAddress.City`	string	Città
`OrderDetails.ShippingAddress.ZipCode`	string	Codice postale
`OrderDetails.ShippingAddress.CountryCode`	string	Codice paese ISO 3166-1 alpha-2 (es. IT)
`OrderDetails.ShippingAddress.State`	string	Provincia o stato
`OrderDetails.ShippingAddress.Email`	string	Indirizzo email del destinatario
`OrderDetails.ShippingAddress.PrimaryPhone`	string	Numero di telefono del destinatario

Recuperare l'indirizzo di spedizione

Nella configurazione ExpressCheckout & PayAndShip l'indirizzo di spedizione viene raccolto direttamente da Amazon Pay durante il checkout e non transita nella richiesta di pagamento.

Se l'esercente ha necessità di utilizzare tali informazioni per i propri processi aziendali (ad esempio per la preparazione e la spedizione dell'ordine), Payment Orchestra rende disponibile l'indirizzo dell'acquirente tramite l'API GET payment/detail.

Le informazioni sono contenute nell'oggetto orderReferenceDetails, di seguito un esempio di risposta:

Request

GET /api/v1/payment/detail/{paymentID}
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json

Response

{
    "error": {
        "code": "0",
        "description": "request correctly processed"
    },
    "payload": {
        "transactionType": "detail",
        "transactionResult": "APPROVED",
        "transactionState": "AUT",
        "transactionErrorCode": "0",
        "transactionErrorDescription": "Transaction correctly processed",
        "bankTransactionID": "4550",
        "shopTransactionID": "FBK_OrderID",
        "shopTransactionID_2": "",
        "authorizationCode": "AZ0631",
        "paymentID": "21421310038753",
        "currency": "EUR",
        "country": "",
        "company": "AMAZONPAY",
        "tdLevel": "",
        "threeDS": {
            "authenticationResult": null,
            "transDetails": null
        },
        "events": [
            {
                "event": {
                    "eventtype": "AUT",
                    "eventamount": "10.00",
                    "eventdate": "01/09/26 09:44:03",
                    "eventARN": "",
                    "eventID": "",
                    "eventReferred": ""
                }
            }
        ],
        "buyer": {
            "name": "",
            "email": ""
        },
        "risk": {
            "riskResponseCode": "",
            "riskResponseDescription": ""
        },
        "customInfo": null,
        "alertCode": "",
        "alertDescription": "",
        "cvvPresent": "FALSE",
        "dcc": null,
        "maskedPAN": "",
        "paymentMethod": "AMAZONPAY",
        "productType": "",
        "token": "",
        "tokenExpiryMonth": "",
        "tokenExpiryYear": "",
        "tokenDetails": null,
        "fraudPrevention": {
            "check": "FALSE",
            "state": "",
            "description": "",
            "order": ""
        },
        "automaticOperation": {
            "type": "CAN",
            "date": "26/09/26 00:00:00",
            "amount": "10.00"
        },
        "orderReferenceDetails": {
            "paymentServiceProviderAttributes": {
                "paymentServiceProviderOrderId": "GESPAY12345_4550"
            },
            "orderReferenceStatus": {
                "lastUpdateTimestamp": "20260901T074402Z",
                "state": "Completed"
            },
            "orderLanguage": "en-GB",
            "expirationTimestamp": "20270228T074343Z",
            "idList": null,
            "sellerOrderAttributes": {
                "storeName": "FBK_OrderID",
                "sellerOrderId": "FBK_OrderID"
            },
            "orderTotal": {
                "amount": "10",
                "currencyCode": "EUR"
            },
            "buyer": {
                "name": "John Doe",
                "email": "buyer@email.com"
            },
            "releaseEnvironment": null,
            "amazonOrderReferenceId": "S02-3823915-3820630",
            "creationTimestamp": "2026-09-08 18:36:57.028",
            "requestPaymentAuthorization": "true",
            "billingAddress": {
                "addressType": "Physical",
                "physicalAddress": {
                    "city": "Biella",
                    "phone": "+393331234567",
                    "countryCode": "IT",
                    "postalCode": "13900",
                    "name": "John Doe",
                    "addressLine1": null,
                    "addressLine2": "Via Corradino Sella 10"
                }
            },
            "destination": {
                "destinationType": "Physical",
                "physicalDestination": {
                    "city": "Biella",
                    "phone": null,
                    "countryCode": "IT",
                    "postalCode": "13900",
                    "name": "John Doe",
                    "addressLine1": "Via Corradino Sella, 10 Biella",
                    "addressLine2": null,
                    "stateOrRegion": null
                }
            }
        }
    }
}

FAQ

È necessario avere un account Amazon per pagare con Amazon Pay?

Sì. L'acquirente deve disporre di un account Amazon attivo per poter completare il pagamento con Amazon Pay.

Come viene determinata la configurazione del mio negozio?

La configurazione viene definita in fase di attivazione del metodo, sulla base del modello operativo dell'esercente, ed è applicata a livello di negozio. Non è possibile variarla sulla singola richiesta di pagamento: per modificare la configurazione attiva è necessario contattare l'assistenza.

Posso avere configurazioni diverse per negozi diversi?

Sì. La configurazione è applicata a livello di negozio (shopLogin): se l'esercente gestisce più negozi su Payment Orchestra, ciascuno può essere configurato in modo indipendente. Anche l'attivazione viene gestita separatamente per ogni negozio.

Con la configurazione ExpressCheckout & PayAndShip, quale indirizzo di spedizione viene utilizzato?

Viene utilizzato l'indirizzo di spedizione predefinito presente sull'account Amazon dell'acquirente, che ha comunque la possibilità di selezionarne uno diverso durante il checkout su Amazon.

Con la configurazione ProcessOrder & PayAndShip, l'acquirente può modificare l'indirizzo di spedizione durante il checkout?

No. L'indirizzo fornito dall'esercente nella richiesta di pagamento viene mostrato in sola lettura sul checkout Amazon e non può essere modificato dall'acquirente.

È possibile eseguire più catture su una singola autorizzazione?

Sì. Payment Orchestra supporta catture multiple e parziali a fronte di una singola autorizzazione, fino a concorrenza dell'importo autorizzato.

È possibile eseguire più rimborsi su una singola transazione?

Sì. Payment Orchestra supporta rimborsi multipli a fronte di una singola cattura, fino a concorrenza dell'importo catturato.

Assistenza

Fabrick

Status page: https://status.fabrick.com/
Support: https://landing.fabrick.com/fabrick-dashboard-support

Amazon Pay

Docs: https://developer.amazon.com/docs/amazon-pay-checkout/introduction.html
Seller Central: https://sellercentral.amazon.com/

Amazon Pay

Perché scegliere Amazon Pay​

Servizi e funzionalità disponibili tramite integrazione Fabrick​

Modalità di integrazione e configurazioni supportate​

Separazione tra autorizzazione e cattura​

Amazon Pay su Fabrick Payment Orchestra: attivazione e modalità di integrazione​

Attività richieste prima dell'attivazione​

Registrazione dell'account Amazon Pay Merchant​

Recupero delle credenziali​

Configurazione dell'endpoint IPN​

Configurazione dei domini autorizzati​

Richiesta di attivazione​

Tipologie di integrazione​

Integrazioni supportate

Integrazioni supportate

Integrazione hosted​

Integrazione tramite API​

Creazione della transazione e redirect verso Amazon Pay​

Campi da inviare nella chiamata verso Amazon Pay​

Shipping Address​

Recuperare l'indirizzo di spedizione​

FAQ​

Assistenza​

Perché scegliere Amazon Pay

Servizi e funzionalità disponibili tramite integrazione Fabrick

Modalità di integrazione e configurazioni supportate

Separazione tra autorizzazione e cattura

Amazon Pay su Fabrick Payment Orchestra: attivazione e modalità di integrazione

Attività richieste prima dell'attivazione

Registrazione dell'account Amazon Pay Merchant

Recupero delle credenziali

Configurazione dell'endpoint IPN

Configurazione dei domini autorizzati

Richiesta di attivazione

Tipologie di integrazione

Integrazione hosted

Integrazione tramite API

Creazione della transazione e redirect verso Amazon Pay

Campi da inviare nella chiamata verso Amazon Pay

Shipping Address

Recuperare l'indirizzo di spedizione

FAQ

Assistenza