Gestpay diventa Axerve Ecommerce Solutions

Amazon Pay


Amazon Pay è un servizio che permette ai clienti di pagare beni e servizi utilizzando i metodi di pagamento già associati al loro account Amazon. Per eseguire il pagamento l’utente può usare qualsiasi metodo di pagamento registrato nel suo account Amazon.

Sommario

Le operazioni necessarie per integrare Amazon Pay sono le seguenti:

Impostare l’account

1. Accedere a Amazon Pay Seller Central

Per utilizzare Amazon Pay bisogna registrarsi e seguire le istruzioni.

2. Configurare Amazon Pay

Per comunicare con il sandbox e l’ambiente di produzione di Axerve Ecommerce Solutions accedere alla pagina https://sellercentral-europe.amazon.com/external-payments/amazon-pay/integration-central/lwa e seguire le istruzioni seguenti:

  1. Selezionare "Integration - Integration Central" dalla barra di navigazione in alto a sinistra della Home Page di Seller Central


  1. Dalla pagina Integration Central, scorrere fino alla sezione "Manage client ID/store ID(s)" e cliccare "View client ID/store ID(s)".


  1. ISe si possiede già un Client o Store ID non ancora registrato, rivedere la configurazione sul negozio selezionato. Per modificare le informazioni cliccare sul link "Edit" sul lato destro.


  1. Cliccando sul bottone "Edit" si possono modificare tutti i dettagli del cliente.


  1. Dallo step 3, cliccando sul link "Create new configuration" in alto, si può creare una nuova configurazione cliente fornendo tutte le informazioni rilevanti.


Sandbox  
Allowed Javascript Origins https://sandbox.gestpay.net
Allowed Return URLs https://sandbox.gestpay.net/pagam/AmazonPay.aspx
Allowed Return URLs Mobile https://sandbox.gestpay.net/pagam/Mobile/AmazonPay.aspx
Produzione  
Allowed Javascript Origins https://ecomm.sella.it
Allowed Return URLs https://ecomm.sella.it/pagam/AmazonPay.aspx
Allowed Return URLs Mobile https://ecomm.sella.it/pagam/Mobile/AmazonPay.aspx

3. Generare Token MWS

È necessario il token MWS per delegare Axerve Ecommerce Solutions a operare per conto del cliente.

Per generare il Token MWS:



Proprietà Valore
Developer’s Name Gestpay
Developer ID 5535-2867-1582


4. Configurazione di Axerve Ecommerce Solutions

Nel Back Office di Axerve, inserire le credenziali di Amazon Pay ricevute quando si è effettuato l’accesso:


La casella Show Address Widget permette di selezionare l’indirizzo da Amazon Pay durante il pagamento, mostrando il widget. Questa impostazione può essere disattivata se l’esercente vende articoli che non possono essere spediti (per esempio, articoli che non sono fisici).

Il flusso di pagamento Amazon Pay con la pagina di pagamento

Per usare Amazon Pay:

1. Encrypt

Il primo passo è crittografare la richiesta di pagamento e inviarla a Axerve Ecommerce Solutions. Per farlo, chiamare Encryptnel web service WsCryptDecrypt.

È disponibile un esempio di Encrypt nella nostra sezione API.

Se si vuole usare il tag paymentType per questo metodo, il valore da usare è AMAZONPAY. Visitare la sezione Come rindirizzare il cliente a un metodo di pagamento dove spieghiamo come usare il tag paymentType.

If you want to use the paymentType tag for this method, the value to use is AMAZONPAY. See the section How to redirect the customer to a payment method to learn how to use the paymentType tag.

Con Amazon Pay il ShopTransactionId deve essere unico.

ShopTransactionId può contenere solo i caratteri seguenti:

Massimo: 32 caratteri

2. Rindirizzare l’utente

Axerve Ecommerce Solutions risponde alla richiesta con EncryptResponse, che contiene un campo CryptDecryptString.

Per l’ambiente di prova rindirizzare l’utente a:

http://sandbox.gestpay.net/pagam/pagam.aspx?a=<ShopLogin>&b=<CryptDecryptString>

Per l’ambiente di produzione l’URL è:

http://ecomm.sella.it/pagam/pagam.aspx?a=<ShopLogin>&b=<CryptDecryptString>

Si possono trovare più informazioni in Usare la pagina di pagamento di Axerve.

Una volta che l’acquirente viene rindirizzato se non è autenticato Amazon mostrerà un form di login:


Eseguito l’accesso l’acquirente vedrà una pagina dove può scegliere l’indirizzo di spedizione tra gli indirizzi salvati su Amazon:


Poi può scegliere una carta di credito tra quelle che ha salvato su Amazon.


Alla fine Axerve Ecommerce Solutions esegue una richiesta di autorizzazione sulla carta di credito selezionata e l’acquirente viene rindirizzato sul sito dell’esercente (positive or negative response URL).

3. Leggere la risposta da Axerve Ecommerce Solutions

Dopo che il pagamento è stato riconosciuto, Axerve Ecommerce Solutions:

Il processo è descritto nei documenti per la pagina di pagamento, step 3.

Il carico utile di questa chiamata sono due parametri di query, il primo è lo Shop Login e il secondo una stringa crittografata.

Per decodificare una striscia crittografata bisogna chiamare Decrypt nel web service WsCryptDecrypt; si vedrà il risultato della transazione nella risposta.

4. Ottenere l’indirizzo di spedizione e di fatturazione dell’acquirente

Per recuperare gli indirizzi di spedizione dell’acquirente, chiamare callReadTrxS2S nel web service WsS2S. Qui si trova anche una risposta di esempio.

Le informazioni rilevanti sono contenute nel tag OrderReferenceDetails. Riportiamo un esempio della risposta di informazioni rilevanti:

<callReadTrxS2SResponsexmlns="https://ecomms2s.sella.it/">
  <callReadTrxS2SResult>
    <GestPayS2Sxmlns="">
      ...
      <OrderReferenceDetails>
        <OrderReferenceStatus>
          <State>Draft</State>
        </OrderReferenceStatus>
        <OrderLanguage>it-IT</OrderLanguage>
        <Destination>
          <DestinationType>Physical</DestinationType>
          <PhysicalDestination>
            <StateOrRegion>BI</StateOrRegion>
            <Phone>33333333</Phone>
            <City>BIELLA</City>
            <CountryCode>IT</CountryCode>
            <PostalCode>13900</PostalCode>
            <Name>Marco Rossi</Name>
            <AddressLine1>via Gobe 15</AddressLine1>
          </PhysicalDestination>
        </Destination>
        <ExpirationTimestamp>2018-05-13T07:24:02.186Z</ExpirationTimestamp>
        <IdList/>
        <SellerOrderAttributes>
          <SellerOrderId>4354395804398dkfjlhsdfk</SellerOrderId>
        </SellerOrderAttributes>
        <OrderTotal>
        <CurrencyCode>EUR</CurrencyCode>
        <Amount>10.00</Amount>
        </OrderTotal>
        <Buyer>
          <Name>Ale</Name>
          <Email>marco.rossi@email.it</Email>
        </Buyer>
        <ReleaseEnvironment>Sandbox</ReleaseEnvironment>
        <AmazonOrderReferenceId>S02-0319513-4657042</AmazonOrderReferenceId>
        <CreationTimestamp>2017-11-14T07:24:02.186Z</CreationTimestamp>
        <BillingAddress>
          <PhysicalAddress>
            <City>Neunkirchen</City>
            <CountryCode>DE</CountryCode>
            <PostalCode>66538</PostalCode>
            <Name>Liam Barker</Name>
            <AddressLine1/>
            <AddressLine2>Meininger Strasse 58</AddressLine2>
          </PhysicalAddress>
          <AddressType>Physical</AddressType>
        </BillingAddress>
        <RequestPaymentAuthorization>false</RequestPaymentAuthorization>
      </OrderReferenceDetails>
      ...
    </GestPayS2S>
  </callReadTrxS2SResult>
</callReadTrxS2SResponse>

Amazon Pay via chiamata S2S

Se si desidera implementare la pagina di pagamento personalizzata caricando i widgets di Amazon Pay, si può chiamare direttamente Axerve Ecommerce Solutions callPagamS2S (il web service che permette di pagare via server-to-server) con questi dati:

Campo Valore
paymentType AMAZONPAY
transKey L’ Order Reference Id ricevuto da Amazon

Si può trovare una chiamata di esempio nelle API.

Pagamenti ricorrenti con Amazon Pay

Con Amazon Pay si possono impostare i pagamenti ricorrenti. Per farlo, si può usare l’opzione amazonPayBillingAgreementDescription nell’Encrypt method:

<Encrypt>
  <shopLogin>9000001</shopLogin>
  <uicCode>242</uicCode>
  <amount>100</amount>
  <shopTransactionId>34az85ord20</shopTransactionId>
  <paymentTypes>
    <paymentType>AMAZONPAY</paymentType>
  </paymentTypes>

  <!-- Il tag successivo serve per i pagamenti ricorsivi -->
  <amazonPayBillingAgreementDescription>
    paynowandrecurring
  </amazonPayBillingAgreementDescription>
  ...
</Encrypt>

Valori possibili per amazonPayBillingAgreementDescription:

Si può trovare un esempio nei docs API.

Per usare il token per i pagamenti ripetuti, vedere CallPagamS2S.