Panoramica #

Le fasi di creazione di un checkout completo sono quattro:

1. Creare un prodotto
2. Creare un prezzo
3. Creare una cassa
4. Passare alla cassa per completare il pagamento

Creare un prodotto #

I prodotti e i prezzi sono risorse fondamentali per molte integrazioni WooshPay. I prodotti definiscono ciò che l'azienda offre, che si tratti di beni o servizi.

Richiesta

{
    "nome": "prodotto di esempio",
    "attivo":vero,
    "description": "qualche descrizione",
    "metadati":{
        "key1": "valore1",
        "chiave3": "valore3"
    },
    "url": "www.example.com"
}

Risposta

{
    "id": "prod_1554351292598452224",
    "oggetto": "prodotto",
    "creato": 1665642282000,
    "attivo": true,
    "descrizione": "qualche descrizione",
    "metadati": {
        "key1": "valore1",
        "chiave2": "valore2"
    },
    "nome": "prodotto di esempio",
    "livemode": false,
    "url": "www.example.com",
    "aggiornato": 1665642282000,
    "immagini": null
}

Creare un prezzo #

I prezzi definiscono quanto e con quale frequenza addebitare i prodotti. È possibile creare prezzi singoli o multipli per un prodotto.

Richiesta 1: legare direttamente il prodotto esistente

{
    "Valuta: "GBP",
    "product":"prod_1554351292598452224",
    "importo_unità":5,
    "active":true,
    "metadati":{
        "key1": "valore1",
        "key2": "value2"
    },
    "nickname": "qualche nickname",
    "dati_prodotto":null,
    "lookup_key": "test_lookup_key".
}

Richiesta 2：Creare un nuovo prodotto e creare un prezzo

{
    "valuta": "GBP",
    "prodotto":null,
    "importo_unità":5,
    "active":true,
    "metadati":{
        "key1": "valore1",
        "key2": "valore2"
    },
    "nickname": "fengli",
    "dati_prodotto":{
        "id":null,
        "nome": "prodotto di esempio",
        "active":true,
        "description": "molto delizioso",
        "metadati":{
            "key1": "valore1",
            "key2": "valore2"
        },
        "url": "www.example.com"
    },
    "billing_scheme": "testscheme",
    "lookup_key": "test_lookup_key".
}

Risposta

{
    "id":"price_1554384814788837376",
    "oggetto": "prezzo",
    "created":1659429194000,
    "attivo":true,
    "valuta": "GBP",
    "metadati":{
        "key1": "valore1",
        "chiave2": "valore2"
    },
    "nickname": "nickname",
    "prodotto":{
        "id":"prod_1554351292598452224",
        "oggetto": "prodotto",
        "created":1659421201000,
        "attivo":true,
        "descrizione": "molto delizioso",
        "metadati":{
            "key1": "valore1",
            "chiave3": "valore3"
        },
        "nome: "taiwan fengli",
        "livemode":false,
        "url": "www.example.com",
        "updated":1659422039000
    },
    "tipo": "one_time",
    "livemode":false,
    "importo_unità":5,
    "billing_scheme": "per_unit",
    "lookup_key": "test_lookup_key".
}

Creare la cassa #

Una sessione di checkout è la rappresentazione programmatica di ciò che il cliente vede quando viene reindirizzato al modulo di pagamento. È possibile configurarla con opzioni quali:

• voci_di_linea per caricare
• valute da utilizzare

È inoltre necessario specificare:

• A url_successoUna pagina del vostro sito web per reindirizzare il cliente dopo che ha completato il pagamento.
• A annullamento_urlUna pagina del vostro sito web per reindirizzare i clienti che fanno clic sul vostro logo nel Checkout.

Nota: le sessioni di checkout scadono 24 ore dopo la loro creazione.

Richiesta

{
    "cancel_url": "www.example.com",
    "modalità": "pagamento",
    "success_url": "www.wooshpay.com",
    "line_items":[
        {
            "price_data":{
                "currency": "GBP",
                "product":null,
                "unit_amount":5,
                "active":true,
                "metadati":{
                    "key1": "valore1",
                    "key2": "valore2"
                },
                "nickname": "fengli",
                "dati_prodotto":{
                    "id":null,
                    "nome": "prodotto di esempio",
                    "active":true,
                    "description": "molto delizioso",
                    "metadati":{
                        "key1": "valore1",
                        "key2": "valore2"
                    },
                    "url": "www.example.com"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantità":1
        }
    ]
}

Risposta

{
    "id":"cs_1580071142008291328",
    "oggetto": "checkout.session",
    "created":1665553291000,
    "valuta": "GBP",
    "cliente":"",
    "modalità": "pagamento",
    "livemode":false,
    "spedizione":null,
    "stato": "aperto",
  "url": "https://checkouttest.wooshpay.com/pay/cs_test_1580071142008291328?key=pk_test_dGVzdDpXWUg1eUF4OXZpUUF4UHNoYmdRRjVTTTE=",
    "cancel_url": "www.baidu.com",
    "ID_cliente":null,
    "email_cliente":null,
    "voci_di_linea":{
        "oggetto": "elenco",
        "data":[
            {
                "id":"li_1580071142847152128",
                "oggetto": "voce",
                "valuta": "GBP",
                "descrizione": "esempio di prodotto",
                "prezzo":{
                    "id":"price_1580071142859735040",
                    "oggetto": "prezzo",
                    "created":1665553291000,
                    "attivo":true,
                    "valuta": "GBP",
                    "metadati":{
                        "key1": "valore1",
                        "chiave2": "valore2"
                    },
                    "nickname": "fengli",
                    "prodotto":{
                        "id":"prod_1580071142880706560",
                        "oggetto": "prodotto",
                        "created":1665553291000,
                        "attivo":true,
                        "descrizione": "qualche descrizione",
                        "metadati":{
                            "key1": "valore1",
                            "key2": "valore2"
                        },
                        "nome": "prodotto di esempio",
                        "livemode":false,
                        "url": "www.example.com",
                        "updated":1665553291000,
                        "immagini":null
                    },
                    "tipo": "one_time",
                    "livemode":false,
                    "importo_unità":5,
                    "billing_scheme": "per_unit",
                    "lookup_key": "test_lookup_key".
                },
                "quantity":1,
                "importo_subtotale":5,
                "importo_totale":5
            }
        ],
        "url":null,
        "has_more":null
    },
    "payment_intent":"pi_1580071150141046784",
    "payment_method_types":null,
    "stato_di_pagamento": "non pagato",
    "success_url": "www.wooshpay.com",
    "amount_subtotal":5,
    "importo_totale":5,
    "indirizzo_di_fatturazione": "auto",
    "expires_at":1665639691214,
    "link_di_pagamento":"",
    "opzioni_metodo_di_pagamento":null,
    "raccolta_numero_di_telefono":null,
    "raccolta_indirizzo_di_spedizione":null,
    "client_secret":"pi_1580071150141046784_secret_bsOGcAMewpe6orzCbZHMlomu"
}

Reindirizzare l'URL #

Dopo aver creato una sessione di checkout, reindirizzare il cliente all'URL restituito nella risposta.