Modifiche all'API di richiesta di pagamento

Chrome 62

PaymentDetailsModifier è ora disponibile

In una richiesta di pagamento, in alcuni casi potresti voler offrire uno sconto o un addebito aggiuntivo a seconda del metodo di pagamento scelto dal cliente. PaymentDetailsModifier è la funzionalità che puoi utilizzare per raggiungere questo obiettivo.

Aggiungi la proprietà modifiers al secondo argomento del costruttore PaymentRequest insieme a un array dell'oggetto PaymentDetailsModifier, che rappresenta le regole dichiarative di come devono essere modificati gli elementi visualizzati e il totale a seconda del metodo di pagamento scelto dal cliente.

L'esempio seguente mostra come dichiarare che a un utente verranno addebitate commissioni di elaborazione di 3 $per aver scelto un pagamento con carta di credito.

let methods = [{
 supportedMethods: 'basic-card',
 data: {
   supportedNetworks: ['visa', 'mastercard']
   supportedTypes: ['credit', 'debit']
 }
}];

let details = {
 displayItems: [{
   label: 'T-shirt',
   amount: { currency: 'USD', value: '68.00' }
 }],
 total: {
   label: 'Total price',
   amount: { currency: 'USD', value: '68.00' }
 },
 modifiers: [{
   supportedMethods: 'basic-card',
   data: {
     supportedTypes: ['credit']
   },
   additionalDisplayItems: [{
     label: 'Processing fee',
     amount: { currency: 'USD', value: '3.00' }
   }],
   total: {
     label: 'Credit card price',
     amount: {currency: ‘USD’, value: ‘71.00’}}
 }]
};

let options = {};

let request = new PaymentRequest(methods, details, options);

Nel foglio della richiesta di pagamento effettiva, non appena viene scelto un pagamento con carta di credito, l'utente vedrà una voce aggiuntiva denominata "Commissioni di elaborazione" con un addebito di 3 $, per un prezzo totale di 71,00 $.

PaymentDetailsModifier contiene i seguenti parametri:

Nome proprietà
supportedMethods Specifica a quale metodo di pagamento si applica questa regola.
additionalDisplayItems Elementi aggiuntivi da visualizzare a cui vuoi aggiungere sconti o costi aggiuntivi.
total Prezzo totale dopo l'aggiunta di additionalDisplayItems.
data Per il pagamento con basic-card, questo verrà utilizzato come modo per filtrare tipi di carte specifici con supportedTypes. In caso contrario, l'utilizzo di questo parametro dipende dal metodo di pagamento (app per pagamenti). Consulta la documentazione fornita per ciascun metodo di pagamento.

Quando sono disponibili opzioni di spedizione, le cose si complicano un po', perché il prezzo totale di modifiers non può essere statico e deve essere modificato in modo dinamico.

Per farlo, modificherai la proprietà additionalDisplayItems e total di modifiers in base all'evento shippingaddresschange e shippingoptionchange, proprio come fai per la proprietà displayItems dell'oggetto PaymentDetails.

La proprietà supportedMethods ora accetta una stringa

La proprietà supportedMethods nell'oggetto PaymentMethodData (il primo argomento del costruttore PaymentRequest) accetta un array di stringhe che indica un metodo di pagamento. Ora accetta una singola stringa come argomento.

Tieni presente che l'utilizzo di un array continuerà a funzionare per il momento.

Cosa non fare

Old - still works for the time being.

var methodData = [{
     supportedMethods: ['basic-card'],
     data: {
       supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
         'diners', 'discover', 'mir', 'unionpay']
     }
}, {
    supportedMethods: ['https://bobpay.xyz']
}];
Cosa fare

Nuovo: il nuovo modo.

var methodData = [{
     supportedMethods: 'basic-card',
     data: {
       supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
         'diners', 'discover', 'mir', 'unionpay']
     }
}, {
    supportedMethods: 'https://bobpay.xyz'
}];

Chrome 61

supportedTypes in basic card is available

Quando supportedMethods è "basic-card", ora puoi fornire supportedTypes per indicare quali tipi di carte sono supportati tra "credit", "debit" e "prepaid".

var methodData = [{
 supportedMethods: 'basic-card',
 data: {
   supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
     'diners', 'discover', 'mir', 'unionpay']
   supportedTypes: ['credit', 'debit', 'prepaid']
 }
}];

Assicurati di ricontrollare il tipo di carta con il tuo gateway di pagamento, poiché questo filtro potrebbe non funzionare perfettamente a seconda della provenienza.

Chrome 57

PaymentRequest è ora disponibile all'interno degli iframe

Ora è possibile chiamare l'API Payment Request dall'interno di un iframe aggiungendo l'attributo allowpaymentrequest all'elemento iframe.

<iframe src="/totally/fake/url" allowpaymentrequest></iframe>

PaymentMethodData supporta "basic-card"

Il primo argomento del costruttore PaymentRequest() è un array di dati del metodo di pagamento. Il formato PaymentMethodData è stato modificato in questa release.

Cosa non fare

Old - still works for the time being.

var methodData = [{
     supportedMethods: ['visa', 'mastercard', 'amex', 'jcb']
}];
var request = new PaymentRequest(methodData, details, options);
Cosa fare

Nuova: la nuova struttura.

var methodData = [{
     supportedMethods: ['basic-card'],
     data: {
       supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
         'diners', 'discover', 'mir', 'unionpay']
     }
}];
var request = new PaymentRequest(methodData, details, options);

Il formato della proprietà data dipende dal valore in supportedMethods e si basa sulla specifica Basic Card. Tieni presente che la specifica include supportedTypes, che accetta credit, debit o prepaid, ma Chrome 57 ignora questa proprietà e tratta tutti i valori in supoprtedNetworks come carte di credito.

var methodData = [{
     supportedMethods: ['basic-card'],
     data: {
       supportedNetworks: ['visa', 'mastercard', 'amex', 'jcb',
         'diners', 'discover', 'mir', 'unionpay'],
       supportedTypes: ['credit'] <= not available
     }
}];

Chrome 56

in attesa

Nell'ambito delle informazioni sull'articolo di pagamento, gli sviluppatori possono aggiungere pending per indicare che il prezzo non è ancora stato completamente determinato. Il campo pending accetta un valore booleano.

    {
      label: "State tax",
      amount: { currency: "USD", value : "5.00" },
      pending: true
    },

Questo approccio è di uso comune per mostrare voci come gli importi di spedizione o delle imposte che dipendono dalla selezione dell'indirizzo di spedizione o delle opzioni di spedizione. Chrome indica i campi in attesa nell'interfaccia utente per la richiesta di pagamento.

requestPayerName

Nell'ambito dell'opzione di spedizione (terzo argomento di PaymentRequest), gli sviluppatori possono ora aggiungere requestPayerName per richiedere il nome del pagatore separatamente dalle informazioni sull'indirizzo di spedizione. requestPayerName accetta un valore booleano.

shippingType

Nell'ambito dell'opzione di spedizione (terzo argomento di PaymentRequest), gli sviluppatori possono ora aggiungere shippingType per richiedere che la UI mostri "consegna" o "ritiro" anziché "spedizione". shippingType accetta le stringhe shipping (predefinita), delivery o pickup.

shippingType='delivery'
shippingType="delivery"
shippingType='pickup'
shippingType="pickup"

Funzioni di serializzazione disponibili per PaymentResponse e PaymentAddress

L'oggetto PaymentResponse e l'oggetto PaymentAddress sono ora serializzabili in JSON. Gli sviluppatori possono convertire un array in un oggetto JSON chiamando la funzione toJSON() ed evitare di creare funzioni toDict() ingombranti.

request.show().then(response => {
     let res = response.toJSON();
});

canMakePayment

Oltre alla disponibilità dell'API, puoi verificare se un utente ha un metodo di pagamento attivo prima di richiamare l'API Payment Request. Ricorda che si tratta di un'operazione facoltativa, in quanto gli utenti possono comunque aggiungere un nuovo metodo di pagamento nella UI di pagamento.

let request = new PaymentRequest(methods, details, options);
if (request.canMakePayment) {
     request.canMakePayment().then(result => {
       if (result) {
         // Payment methods are available.
       } else {
         // Payment methods are not available, but users can still add
        // a new payment method in Payment UI.
       }
     }).catch(error => {
       // Unable to determine.
     });
}