Caratteristiche #

Metodo di integrazione #

Valori dell'enumerazione del metodo di pagamento: trasferimento_bancario_uk

Esistono due metodi di integrazione per il bonifico bancario

1. API diretta
2. Cassa

Diretto API #

Flusso di pagamento #

1. Per l'integrazione API diretta, dopo aver creato l'intento di pagamento tramite OpenAPI, i clienti saranno reindirizzati alla pagina del bonifico bancario.

2. Dopo aver completato i bonifici bancari locali e aver cliccato su "Ho completato il pagamento", i clienti vedranno "il pagamento è in fase di elaborazione" e saranno quindi reindirizzati a return_url

Come integrare #

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

Creare un Intento di pagamento

Creare un PaymentIntent sul server e specificare l'importo da riscuotere e una valuta supportata.

Per il bonifico bancario, in particolare, è necessario raccogliere anche i dati del cliente. nome, Paese e e-mail in dati_di_metodo_di_pagamento.dettagli_di_fatturazione.

Se si dispone di un'integrazione Payment Intents già esistente, aggiungere trasferimento_bancario_uk all'elenco dei tipi di metodo di pagamento.

Richiesta

{
    "importo":1000,
    "valuta": "GBP",
    "conferma":vero,
    "dati_metodo_di_pagamento" : {
        "type": "bank_transfer_eu",
        "dati_di_fatturazione":{
            "address": {
                "linea1": "XX villa",
                "riga2": "XX città",
                "città": "città",
                "stato": "California",
                "paese": "GB",
                "codice postale": "55555"

            },
            "nome": "Tom Elis",
            "email": "E298483@Gmail.com"
        }
    },
    "quantità": 2,
    "merchant_user_id": "123456",
    "merchant_order_id": "Order112344343",
    "return_url": "https://your.website"
}

risposta

{
    "id": "pi_1661558941487726592",
    "oggetto": "payment_intent",
    "creato": 1684981497000,
    "valuta": "GBP",
    "importo": 1000,
    "stato": "requires_action",
    "descrizione": "descrizione del prodotto",
    "livemode": false,
    "quantity": 2,
    "merchant_user_id": "123456",
    "merchant_order_id": "Order112344343",
    "client_secret": "pi_1661558941487726592_secret_g4Xl2kP98fwFD5x4HSVyK0Rm",
    "next_action": {
        "tipo": "bank_transfer_uk_handle_redirect",
        "bank_transfer_uk_handle_redirect": {
            "url": "https://pay-sandbox.tazapay.com/marketplace/paymentdetails/8t0-UMIIGKyeiECODNFV6ldbGjpumbMOsbqpmuw7sg8NXjQ_B_YxmEXSnr_nHAeZ"
        }
    },
    "tipi_di_pagamento": [
        "bank_transfer_uk",
        "bank_transfer_eu",

    ],
    "metodo di conferma": "automatico",
    "return_url": "https://your.website",
    "metodo di pagamento": "pm_1661558941370286080",
    "metodo di acquisizione": "automatic"
}

Cassa #

Flusso di pagamento #

1. Il cliente seleziona il bonifico bancario dall'elenco dei metodi di pagamento disponibili e inserisce le informazioni di pagamento.

2. I clienti inviano denaro al conto bancario locale

3. Dopo aver effettuato il bonifico locale e aver fatto clic su "Ho completato il pagamento", la pagina mostrerà ai clienti che il pagamento è in fase di elaborazione e poi sarà reindirizzata a return_url

Creare una sessione #

Richiesta

{
    "cancel_url": "www.wooshpay.com",
    "modalità": "payment",
    "success_url": "https://wooshpay.com/",
    "tipi_di_metodo_di_pagamento": [
        "bank_transfer_eu",
        "bank_transfer_uk"
    ],
    "line_items": [
        {
            "price_data": {
                "valuta": "EUR",
                "prodotto": nullo,
                "importo_unità": 100000,
                "attivo": true,
                "metadati": {
                    "key1": "valore1",
                    "chiave2": "valore2"
                },
                "nickname": "mela",
                "dati_prodotto": {
                    "id": null,
                    "nome": "apple",
                    "attivo": vero,
                    "descrizione": "gnam gnam",
                    "url": "www.wooshpay.com"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantità": 1
        }
    ]
}

Risposta

{
    "id": "cs_1661288382405279744",
    "oggetto": "checkout.session",
    "creato": 1684916990000,
    "valuta": "EUR",
    "cliente": "",
    "modalità": "payment",
    "livemode": false,
    "stato": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1661288382405279744?key=pk_test_NTE2NTc5NDIzMjU1MzM0Nzg5MTMxOjMzb1M2aUVkNkNvalZPRE1nTW5ITDhYcDE2ODQxMTkyMjgzMTQ",
    "cancel_url": "www.wooshpay.com",
    "voci_di_linea": {
        "oggetto": "elenco",
        "dati": [
            {
                "id": "li_1661288382443028480",
                "oggetto": "item",
                "valuta": "EUR",
                "descrizione": "mela",
                "prezzo": {
                    "id": "price_1661288382476582912",
                    "oggetto": "prezzo",
                    "creato": 1684916990000,
                    "attivo": true,
                    "valuta": "EUR",
                    "metadati": {
                        "chiave1": "valore1",
                        "chiave2": "valore2"
                    },
                    "nickname": "mela",
                    "prodotto": {
                        "id": "prod_1661288382493360128",
                        "oggetto": "prodotto",
                        "creato": 1684916990000,
                        "attivo": true,
                        "descrizione": "gnam gnam",
                        "nome": "mela",
                        "livemode": false,
                        "url": "www.wooshpay.com",
                        "aggiornato": 1684916990000
                    },
                    "tipo": "one_time",
                    "livemode": false,
                    "unit_amount": 100000,
                    "schema di fatturazione": "per_unità",
                    "lookup_key": "test_lookup_key"
                },
                "quantità": 1,
                "importo_subtotale": 100000,
                "importo_totale": 100000
            }
        ]
    },
    "payment_intent": "pi_1661288382682103808",
    "tipi_di_pagamento": [
        "bank_transfer_eu",
        "bank_transfer_uk"
    ],
    "stato_di_pagamento": "non pagato",
    "success_url": "https://wooshpay.com/",
    "amount_subtotal": 100000,
    "importo_totale": 100000,
    "indirizzo_di_fatturazione_raccolta": "auto",
    "scadenza": 1685003390272,
    "link_di_pagamento": "",
    "client_secret": "pi_1661288382682103808_secret_VNK78femqxwsDZbKCRRKvQHR"
}

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.