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.
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'] }];
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.
Old - still works for the time being.
var methodData = [{ supportedMethods: ['visa', 'mastercard', 'amex', 'jcb'] }]; var request = new PaymentRequest(methodData, details, options);
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.
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.
});
}