Pagamenti Alipay Plus #
Alipay Plus è un portafoglio digitale cinese che serve clienti del sud-est asiatico e della Cina. Gli utenti di Alipay Plus possono pagare sul web o su un dispositivo mobile utilizzando le credenziali di accesso o l'app specifica supportata da Alipay Plus.
Caratteristiche #
Sedi dei clienti
- Consumatori cinesi
- Cinesi d'oltremare
- Viaggiatori cinesi
- Consumatori del sud-est asiatico
Valuta di presentazione
CNY, HKD, GBP, IDR, MYR, PHP, THB
Elenco dei portafogli
- AlipayHK
- DANA
- TNG
- BPI
- Linea Rabbit Pay
- GCash
- Aumento
- Akulaku PayLater
Categorie commerciali vietate
Sia WooshPay che Alipay Plus mantengono un elenco di aziende vietate che non possono utilizzare i loro servizi. Per utilizzare Alipay Plus su WooshPay, la vostra azienda non può essere limitata all'uso di Stripe o apparire nell'elenco delle aziende vietate di Alipay. Se non siete sicuri che la vostra azienda sia un'azienda vietata o avete domande su come questi requisiti si applicano a voi, contattate [email protected].
Integrazione da server a server #
Utilizzando Alipay Plus, i clienti pagano reindirizzandosi dal vostro sito web o dalla vostra app, autorizzano il pagamento attraverso un altro portafoglio, quindi tornano al vostro sito web o alla vostra app dove ricevete una notifica immediata se il pagamento è riuscito o meno.
Panoramica #
Per l'integrazione diretta con l'API, è possibile creare l'intento di pagamento e ottenere l'url in un solo passaggio; di seguito è riportata la demo della creazione dell'intento di pagamento:
- Creazione di un intento di pagamento
- Rimborso
- Webhook
1. Creare un PaymentIntent #
Un PaymentIntent è un oggetto che rappresenta l'intenzione di riscuotere un pagamento dal cliente e tiene traccia del ciclo di vita del processo di pagamento. Creare un PaymentIntent sul server e specificare l'importo da riscuotere e una valuta supportata. Se si dispone di un'integrazione PaymentIntents esistente, aggiungere alipayplus all'elenco dei tipi di metodo di pagamento.
Richiesta Creare un Intento di pagamento
{
"importo":200,
"currency": "IDR", //diverse valute possono dare luogo a portafogli diversi
"confirm":true,
"opzioni_di_metodo_di_pagamento":{
"alipayplus":{
"tipo_terminale": "WEB"
}
},
"dati_metodo_di_pagamento":{
"tipo": "alipayplus"
},
"return_url": "https://wooshpay.com"
}Risposta
{
"id": "pi_1646355176136638464",
"oggetto": "payment_intent",
"creato": 1681356636000,
"valuta": "IDR",
"importo": 200,
"stato": "requires_action",
"livemode": true,
"client_secret": "pi_1646355176136638464_secret_gxkV1LYb76c2nFvtzDmHevyw",
"next_action": {
"alipayplus_handle_redirect": {
"normalUrl": "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040092tDht8YNMR2t2u648Mu5v476I"
}
},
"payment_method_types": [
"alipay",
"wechat_pay",
"carta",
"alipayplus"
],
"metodo di conferma": "automatico",
"opzioni_metodo_di_pagamento": {
"alipayplus": {
"tipo_terminale": "WEB"
}
},
"return_url": "https://wooshpay.com",
"metodo di pagamento": "pm_1646355176006615040",
"metodo di acquisizione": "automatic"
}Il normalUrl di azione_successiva Dal link, al cliente verrà mostrato un portafoglio diverso in base alla valuta, e il cliente potrà scegliere quello che desidera pagare, scansionando il codice QR o effettuando il login al portafoglio.
2. Rimborso #
È possibile rimborsare parzialmente o completamente qualsiasi pagamento andato a buon fine, sia tramite API che tramite Dashboard. Per visualizzare un elenco di tutti i rimborsi, visitate la pagina Pagamenti rimborsati nella Dashboard.
Per rimborsare un pagamento utilizzando l'API, creare un rimborso fornendo il PaymentIntent.
Richiesta Creare un rimborso
{
"motivo": "richiesto da_cliente",
"payment_intent":"pi_1575055712604651520"
}Risposta
{
"id":"re_1575092157281206272",
"oggetto": "rimborso",
"created":1664366209000,
"importo":20,
"valuta": "CNY",
"metadati":null,
"motivo": "richiesto_dal_cliente",
"status": "riuscito",
"descrizione":null,
"payment_intent":"pi_1575055712604651520",
"motivo del fallimento":null
}3. Webhook #
Ascoltate gli eventi sul vostro account WooshPay, in modo che la vostra integrazione possa attivare automaticamente le reazioni. Creare un webhook che si concentri principalmente su eventi_abilitati e url.
Passi per ricevere un webhook:
- Identificare gli eventi da monitorare e i payload degli eventi da analizzare.
- Creare un endpoint webhook come endpoint HTTP (URL) sul server locale.
- Verificare che l'endpoint del webhook funzioni correttamente e vedere se si è ricevuto un callback.
Richiesta
{
"url": "https://apitest.wooshpay.com/v1/receives",
"description": "I_am_description",
"eventi abilitati":[
"payment_intent.created",
"payment_intent.payment_failed",
"payment_intent.succeeded",
"addebito.rimborso.aggiornato"
],
"api_version":"1.0.1"
}Risposta
{
"id":"we_1575093135514533888",
"oggetto": "webhook_endpoint",
"created":1664366442000,
"description": "I_am_description",
"metadata":null,
"status": "abilitato",
"url": "https://apitest.wooshpay.com/v1/receives",
"livemode":false,
"api_version":"1.0.1",
"enabled_events":[
"payment_intent.created",
"payment_intent.payment_failed",
"payment_intent.succeeded",
"addebito.rimborso.aggiornato"
]
}Cassa #
Per supportare i pagamenti Alipayplus, una sessione di cassa deve soddisfare tutte le seguenti condizioni:
- I prezzi di tutte le voci devono essere espressi nella stessa valuta.
Se si hanno articoli in diverse valute, creare sessioni di pagamento separate per ciascuna valuta. - È possibile utilizzare solo voci una tantum.
Abilitare Alipayplus come metodo di pagamento #
Quando si crea una nuova sessione di cassa, è necessario:
Aggiungete Alipayplus all'elenco di tipi_di_metodo_di_pagamento.
Assicurarsi che tutti voci_di_linea utilizzare la stessa valuta.
Richiesta Creare una sessione
{
"cancel_url": "www.baide.com",
"modalità": "payment",
"success_url": "www.wooshpay.com",
"payment_method_options": { //aggiunge alipayplus come metodo di pagamento
"alipayplus": {
"tipo_terminale": "WEB"
}
},
"line_items": [
{
"price_data": {
"valuta": "GBP",
"prodotto": null,
"importo_unità": 5,
"attivo": true,
"metadati": {
"key1": "valore1",
"chiave2": "valore2"
},
"nickname": "fengli",
"dati_prodotto": {
"id": null,
"nome": "taiwan fengli",
"active": true,
"descrizione": "molto delizioso",
"metadati": {
"key1": "valore1",
"chiave2": "valore2"
},
"url": "www.baidu.com"
},
"billing_scheme": "testscheme",
"lookup_key": "test_lookup_key"
},
"quantità": 1
}
]
}Risposta
{
"id": "cs_1597163428114333696",
"oggetto": "checkout.session",
"creato": 1669628410000,
"valuta": "GBP",
"cliente": "",
"modalità": "payment",
"livemode": true,
"spedizione": null,
"stato": "open",
"url": "https://checkout.wooshpay.com/pay/cs_1597163428114333696?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
"cancel_url": "www.baidu.com",
"ID_cliente": nullo,
"email_cliente": null,
"voci_di_linea": {
"oggetto": "elenco",
"dati": [
{
"id": "li_1597163428139499520",
"oggetto": "item",
"valuta": "GBP",
"descrizione": "taiwan fengli",
"prezzo": {
"id": "price_1597163428152082432",
"oggetto": "prezzo",
"creato": 1669628410000,
"attivo": true,
"valuta": "GBP",
"metadati": {
"chiave1": "valore1",
"chiave2": "valore2"
},
"nickname": "fengli",
"prodotto": {
"id": "prod_1597163428164665344",
"oggetto": "prodotto",
"creato": 1669628410000,
"attivo": true,
"descrizione": "molto delizioso",
"metadati": {
"key1": "valore1",
"chiave2": "valore2"
},
"nome": "taiwan fengli",
"livemode": true,
"url": "www.baidu.com",
"aggiornato": 1669628410000,
"immagini": null
},
"tipo": "one_time",
"livemode": true,
"unit_amount": 5,
"schema di fatturazione": "per_unità",
"lookup_key": "test_lookup_key"
},
"quantità": 1,
"importo_subtotale": 5,
"importo_totale": 5
}
],
"url": null,
"has_more": null
},
"payment_intent": "pi_1597163428336631808",
"payment_method_types": null,
"payment_status": "non pagato",
"success_url": "www.wooshpay.com",
"amount_subtotal": 5, "amount_total": 5,
"importo_totale": 5,
"indirizzo_di_fatturazione_raccolta": "auto",
"scadenza": 1669714809783,
"link_di_pagamento": "",
"opzioni_metodo_di_pagamento": nullo,
"phone_number_collection": null,
"raccolta_indirizzo_di_spedizione": nullo,
"client_secret": "pi_1597163428336631808_secret_pxwFDDYAbSnC99NpAKVwE1Sr"
}L'url indirizzerà il cliente alla pagina di pagamento di WooshPay; al cliente verrà mostrato un portafoglio diverso in base alla valuta, e il cliente potrà scegliere quello che desidera pagare, scansionando il codice QR o accedendo al portafoglio.
