Scoprite Alipay, un portafoglio digitale molto apprezzato dai clienti cinesi. #

Alipay è un portafoglio digitale cinese che conta più di un miliardo di utenti attivi in tutto il mondo. Gli utenti di Alipay possono pagare sul web o su un dispositivo mobile utilizzando le credenziali di accesso o la loro app Alipay. Alipay ha un basso tasso di controversie e riduce le frodi autenticando i pagamenti con le credenziali di accesso del cliente.

Caratteristiche #

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 attività non può essere soggetta a restrizioni o apparire nell'elenco delle attività 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 support@wooshpay.com.

Sottoprodotti #

Flusso di pagamento #

Pagamento via web #

Pagamento APP #

Metodo di integrazione #

Valori dell'enumerazione del metodo di pagamento: alipay

Esistono due metodi di integrazione per Alipay

1. API diretta
2. Cassa

API diretta #

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.

Creare un Intento di pagamento #

Per l'integrazione diretta con l'API, è possibile creare PaymentIntent e ottenere l'url in un solo passaggio. Di seguito è riportata la demo della creazione degli intenti di pagamento:

• Pagamento via web
• Pagamento APP

È possibile controllare gli scenari di pagamento generati in Payment Intent modificando i valori dell'enumerazione del tipo di terminale：.opzioni_metodo_di_pagamento.alipay.tipo_terminale

Pagamento via web #

Richiesta

{
    "importo": 20,
    "valuta": "CNY",
    "conferma": vero,
    "payment_method_options": {
        "alipay": {
            "client_ip": "192.168.0.1",
            "tipo_terminale": "WEB",
            "os_type": "IOS"
        }
    },
    "dati_metodo_di_pagamento": {
        "tipo": "alipay"
    },
    "payment_method_types": [
        "alipay"
    ],
    "return_url": "https://wooshpay.com"
}

Risposta

{
    "id": "pi_1666729870215872512",
    "oggetto": "payment_intent",
    "creato": 1686214342000,
    "valuta": "CNY",
    "importo": 20,
    "stato": "requires_action",
    "livemode": true,
    "client_secret": "pi_1666729870215872512_secret_jmGL6NBNInPx5zdjIJ2utli4",
    "next_action": {
        "tipo": "redirect_to_url",
        "alipay_handle_redirect": {
            "url": "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=28166604009zSv0130nTr0bKfhzSwT08YvSW"
        }
    },
    "tipi_di_pagamento": [
        "alipay"
    ],
    "metodo_di_conferma": "automatic",
    "opzioni_metodo_di_pagamento": {
        "alipay": {
            "tipo_terminale": "WEB",
            "os_type": "IOS",
            "client_ip": "192.168.0.1"
        }
    },
    "return_url": "https://wooshpay.com",
    "metodo di pagamento": "pm_1666729870102626304",
    "metodo di acquisizione": "automatic"
}

Il url da next_action può essere aperto; dal link, il cliente sarà reindirizzato alla pagina di pagamento di Alipay. Il cliente può scansionare il codice QR o accedere al portafoglio per pagare.

Pagamento APP #

Richiesta

{
    "importo": 20,
    "valuta": "CNY",
    "conferma": vero,
    "payment_method_options": {
        "alipay": {
            "client_ip": "192.168.0.1",
            "tipo_terminale": "APP",
            "os_type": "IOS"
        }
    },
    "dati_metodo_di_pagamento": {
        "tipo": "alipay"
    },
    "payment_method_types": [
        "alipay"
    ],
    "return_url": "https://wooshpay.com"
}

Risposta

{
    "id": "pi_1666732544285999104",
    "object": "payment_intent",
    "created": 1686214980000,
    "currency": "CNY",
    "amount": 20,
    "status": "requires_action",
    "livemode": true,
    "client_secret": "pi_1666732544285999104_secret_NRUV59FL6qtFyz2bXVeDyLD4",
    "next_action": {
        "type": "redirect_to_url",
        "alipay_handle_redirect": {
            "url": "https://render.alipay.com/p/s/i/?scheme=alipays%3A%2F%2Fplatformapi%2FstartApp%3FappId%3D10000007%26actionType%3Droute%26qrcode%3D281666040092tD6e6GlEzzTlQl6HrEqv3kOI%26externalThrough%3D%257B%2522acTerminalType%2522%253A%2522WAP%2522%257D"
        }
    },
    "payment_method_types": [
        "alipay"
    ],
    "confirmation_method": "automatic",
    "payment_method_options": {
        "alipay": {
            "terminal_type": "APP",
            "os_type": "IOS",
            "client_ip": "192.168.0.1"
        }
    },
    "return_url": "https://wooshpay.com",
    "payment_method": "pm_1666732544155975680",
    "capture_method": "automatic"
}

Cassa #

Per supportare i pagamenti Alipay, una sessione di cassa deve soddisfare tutte le seguenti condizioni:

• I prezzi di tutte le voci devono essere nella stessa valuta. Se gli articoli sono in valute diverse, creare sessioni di pagamento separate per ciascuna valuta.
• È possibile utilizzare solo voci una tantum.

Abilitare Alipay 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.

Creare una sessione #

Non è necessario identificare il tipo_terminale quando si crea una sessione di checkout. Il checkout genererà automaticamente un codice QR o reindirizzerà all'app Alipay in base al dispositivo dell'utente.

Richiesta

{
    "cancel_url": "www.baidu.com",
    "modalità": "payment",
    "success_url": "https://wooshpay.com/",
    "tipi_di_metodo_di_pagamento": [
        "alipay"
    ],
    "voci_di_linea": [
        {
            "price_data": {
                "valuta": "CNY",
                "importo_unità": 100000,
                "active": true,
                "dati_prodotto": {
                    "nome": "taiwan fengli"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantità": 1
        }
    ]
}

Risposta

{
    "id": "cs_1666733999608823808",
    "oggetto": "checkout.session",
    "creato": 1686215327000,
    "valuta": "CNY",
    "cliente": "",
    "modalità": "payment",
    "livemode": true,
    "stato": "open",
    "url": "https://checkout.wooshpay.com/pay/cs_1666733999608823808?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
    "cancel_url": "www.baidu.com",
    "voci_di_linea": {
        "oggetto": "elenco",
        "dati": [
            {
                "id": "li_1666733999642378240",
                "oggetto": "item",
                "valuta": "CNY",
                "descrizione": "taiwan fengli",
                "prezzo": {
                    "id": "price_1666733999659155456",
                    "oggetto": "prezzo",
                    "creato": 1686215327000,
                    "attivo": true,
                    "valuta": "CNY",
                    "prodotto": {
                        "id": "prod_1666733999675932672",
                        "oggetto": "prodotto",
                        "creato": 1686215327000,
                        "attivo": true,
                        "nome": "taiwan fengli",
                        "livemode": true,
                        "aggiornato": 1686215327000
                    },
                    "tipo": "one_time",
                    "livemode": true,
                    "importo_unità": 100000,
                    "schema di fatturazione": "per_unità",
                    "lookup_key": "test_lookup_key"
                },
                "quantità": 1,
                "importo_subtotale": 100000,
                "importo_totale": 100000
            }
        ]
    },
    "Intento di pagamento": "pi_1666733999864676352",
    "tipi_di_pagamento": [
        "alipay"
    ],
    "payment_status": "non pagato",
    "success_url": "https://wooshpay.com/",
    "amount_subtotal": 100000,
    "importo_totale": 100000,
    "indirizzo_di_fatturazione_raccolta": "auto",
    "scadenza": 1686301726587,
    "link_di_pagamento": "",
    "client_secret": "pi_1666733999864676352_secret_5S1FMaseZU6gfIZjl2QlOdY7"
}

Il url da next_action può essere aperto; dal link, il cliente sarà reindirizzato alla pagina di pagamento di Alipay. Il cliente può scansionare il codice QR o accedere al portafoglio per pagare.

Passo successivo #

È possibile aggiungere altre funzionalità all'integrazione in base alle esigenze.

Creare un 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 enabled_events e url.

Creare un rimborso #

Creare un rimborso per restituire i fondi al cliente. È possibile eseguire anche rimborsi parziali, ma non tutti i metodi di pagamento li supportano. Un rimborso parziale consiste nel rimborsare solo una parte dell'importo della transazione originale.