Pagamenti con Mirakl Connector
Accetta pagamenti utilizzando l'elaborazione Stripe su Mirakl.
Classifichiamo i metodi di pagamento in sette famiglie. Ogni famiglia offre funzionalità simili, un’unica integrazione ed esperienze di pagamento comuni.
Puoi utilizzare uno dei nostri connettori esistenti o creare la tua integrazione per accettare i pagamenti.
Nota
Quando implementi i pagamenti, non usare i tipi di addebito di Connect. Il connettore suddivide i fondi in base ai tuoi ordini Mirakl.
Creazione del pagamento
Scegli la famiglia di modalità di pagamento in base al flussso di lavoro dell’ordine più adatto al tuo caso d’uso.
| Famiglia | Pagamento all’accettazione | Pagamento alla consegna | Pagamento alla data di scadenza |
|---|---|---|---|
| Carte | |||
| Addebiti bancari | |||
| Reindirizzamenti bancari | |||
| Bonifici | |||
| Pagamento a rate | |||
| Voucher | |||
| Wallet |
Di seguito sono riportate alcune linee guida per adattare l’integrazione dei pagamenti ai tuoi flussi di lavoro.
Pagamento all’accettazione
Per le carte, imposta il valore dell’opzione capture_method su manual quando completi il PaymentIntent solo ai fini dell’autorizzazione. Il connettore acquisisce i fondi automaticamente non appena tutti i venditori hanno accettato o rifiutato i rispettivi ordini. Gli ordini devono essere accettati o rifiutati entro 7 giorni, ovvero entro la scadenza della validità dell’autorizzazione.
Dato che la conferma di pagamento è immediata per i reindirizzamenti bancari, per i wallet e per la modalità di pagamento a rate, ti consigliamo di impostare l’accettazione automatica degli ordini e di utilizzare i rimborsi quando i venditori non possono evadere l’ordine.
Pagamento alla consegna
Per le carte, puoi eseguire l’autorizzazione solo al momento del pagamento se le tue regole prevedono l’acquisizione entro 7 giorni. In caso contrario, salva la carta al momento del pagamento ed esegui l’autorizzazione in un secondo momento.
Per gli addebiti bancari, puoi salvare il conto bancario al momento del pagamento e avviare il pagamento dopo che il venditore ha accettato l’ordine.
Pagamento alla data di scadenza
Puoi utilizzare Stripe Billing per inviare una fattura ai tuoi clienti che in seguito potranno pagare utilizzando la nostra pagina della fattura in hosting.
Convalida del pagamento
Per gestire la convalida del pagamento degli ordini Mirakl, puoi utilizzare l’operazione integrata o chiamare personalmente l’API PA01 se hai esigenze specifiche, quali l’offerta di coupon.
Per abilitare questa operazione integrata, devi prima associare l’ordine Mirakl all’addebito riuscito aggiornando i metadati:
curl https://api.stripe.com/v1/charges/ch_1Hmloy2eZvKYlo2C2Tx3W00V \ -u: \ -d "metadata[mirakl_commercial_order_id]"=123sk_test_BQokikJOvBiI2HlWgH4olfQ2
Il flusso di lavoro inizia quando un venditore accetta l’ordine logistico.
- L’operazione di convalida del pagamento recupera gli ordini Mirakl appena accettati.
- Il connettore convalida il pagamento in Mirakl.
- Per le carte, il pagamento viene acquisito quando tutti gli ordini logistici vengono accettati o rifiutati.
Suddivisione del pagamento
Il flusso di lavoro inizia quando il pagamento è stato convalidato su Mirakl e acquisito su Stripe.
- L’operazione di suddivisione del pagamento recupera gli ordini Mirakl appena convalidati.
- Il connettore trasferisce l’importo dell’ordine al venditore una volta dedotta la tua commissione.
Rimborso del pagamento
Il flusso di lavoro inizia quando richiedi un rimborso per un ordine Mirakl.
- L’operazione di rimborso del pagamento recupera gli ordini Mirakl appena rimborsati.
- Il connettore crea un rimborso su Stripe, convalida il rimborso su Mirakl e storna il trasferimento utilizzato per suddividere il pagamento.
