Resurssit · 47
Epävarmat maksut: kassatapahtuman palauttaminen ilman kaksoiskappaleita
Täsmäytä verkkoviiveet, selaimen palautukset, ilmoitukset ja liiketoiminnan tila sen sijaan, että mitä tahansa signaalia käsiteltäisiin riittävänä.
Päivitetty · 3 min
Mitä tämä opas auttaa saavuttamaan
- Erillinen yritys, maksu ja tilaus
- Viivästyneiden tai puuttuvien palautusten käsittely
- Ilmoitusten ja pyyntöjen kaksoiskappaleiden poistaminen
- Epävarmuuden selittäminen pyytämättä käyttäjiä maksamaan uudelleen
Pikatarkistus
- Mikä lähde vahvistaa maksun?
- Muuttaako selaimen sulkeminen yrityksen tilaa?
- Valmisteleeko toistuva tapahtuma kaksi tilausta?
- Tarkistetaanko tapahtumien allekirjoitukset?
- Miten tuki löytää epävarman toiminnon?
Vaiheittainen menetelmä
- 1
Määrittele tilat
Erota ostoskori, yritys, valtuutus, vahvistettu maksu, tilaus ja hyvitys. Kirjoita siirtymät, auktoriteettilähde ja sallitut toiminnot. Noudata todellista toimittajaa ja maksutapoja; kaikki menetelmät eivät vahvista välittömästi.
Tuotos: tilakaavio ja liiketoimintasopimus.
- 2
Tunnista toiminto.
Yhdistä yritys tilaukseen ja toimittajan tunnisteisiin. Käytä dokumentoitua idempotenssisääntöä saman toiminnon toistamiseen. Uusi tarkoitus tai muutetut parametrit vaativat nimenomaisen päätöksen sokkonavaimen uudelleenkäytön sijaan.
Tuotos: vakaa identiteetti ja palautussäännöt.
- 3
Käsittele selaimen paluuta.
Näytä palvelinpuolen tarkistuksen tila toimittajan kannalta sopivana. Pelkkä uudelleenohjaus onnistumissivulle ei ole maksutodiste. Peitä suljettu selain, puuttuva paluu, keskeytynyt todennus ja hidas verkko.
Tuotos: paluumatka ja viestit tilan mukaan.
- 4
Vahvista ilmoitukset.
Tarkista aitous toimittajan dokumentaation mukaisesti, tallenna tapahtuman identiteetti ja käsittele toistot ilman päällekkäisyyksiä. Tapahtumat voivat olla myöhässä tai epäjärjestyksessä. Tarvittaessa nouda viiteobjekti ennen peruuttamatonta siirtymää.
Toimitettava: testattu käsittelijä ja pankkidatattomat jäljet.
- 5
Täsmäytä ristiriitaisuudet.
Vertaile palveluntarjoajan toimintoja, tilauksia ja täyttämistä. Eristä maksut ilman tilausta, tilaukset ilman vahvistusta, kaksoiskäsittely ja etenemättömät hyvitykset. Anna jokaiselle ristiriidalle omistaja ja menettely; älä toista automaattisesti epävarmaa veloitusta.
Toimitettava: täsmäytysjono ja päätökset.
- 6
Testaa täydellinen palautus.
Palveluntarjoajan testitilassa toiston aikakatkaisu, kaksoiskappale, viivästynyt tapahtuma, käänteinen järjestys ja puuttuva palautus. Tarkista yksi liiketoimintasiirtymä, oikeat asiakastiedot ja tuen näkyvyys. Idempotenssitiedot vaihtelevat palveluntarjoajien välillä.
Toimitettava: kaksoiskappaleiden puuttumisen todisteet ja käyttöönottokriteerit.
Kuvitteellinen esimerkki
Havainnollistava tilanne
Havainnollistava tilanne: maksu onnistuu, mutta asiakas menettää yhteyden ennen vahvistusta ja kaksi ilmoitusta saapuu myöhemmin.
Päätös ja odotettu näyttö
Yksi tilaus on vahvistettu. Palautus näyttää vahvistetun tilan, ja tuki voi täsmäyttää viitteen pyytämättä pankkitietoja.
Mekanismien erottaminen
| Mekanismi | Tarkoitus | Vahvistus tai rajoitus |
|---|---|---|
| Selaimen paluu | Ilmoita käyttöliittymälle ja jatka sitä | Voi puuttua tai olla keskeytynyt |
| Vahvistettu webhook | Vastaanota tarjoajan tilan muutos | Voidaan toistaa, viivästyttää tai olla epäjärjestyksessä |
| Palvelimen täsmäytys | Vertaa maksun ja tilauksen tilaa | Tarvitsee ristiriitaisuuksien ratkaisusäännön |
Johdon indikaattorit
| Indikaattori | Mitä se mittaa | Ensimmäinen toimenpide |
|---|---|---|
| Epävarmat tilat | Toiminnot, joita ei ole ratkaistu suunnitellun viiveen sisällä | Tarkista viitetila |
| Kaksoisvaikutukset | Tilaukset tai käsittely suoritetaan kahdesti | Korjaa liiketoiminnan deduplikaatio |
| Suljetut aukot | Täsmäytetyt tapaukset päätöksellä ja todisteilla | Käsittele vanhimpia ja kriittisiä tapauksia |
Yleisiä virheitä
- Vahvistaminen pelkästään onnistumis-URL-osoitteesta
- Aikakatkaisun käsittely maksun epäonnistumisena
- Olettaen, että tapahtumat saapuvat järjestyksessä
- Veloituksen toistaminen ennen tarkistus
Usein kysytyt kysymykset
Tarkoittaako aikakatkaisu epäonnistumista?
Ei. Se tarkoittaa, että vastausta ei vastaanotettu viiveen sisällä. Tarkista toiminnon tila ennen uuden luomista.
Onko toimittajan idempotenssi riittävä?
Ei. Tilauksen luomisen, täyttämisen ja ilmoitusten on myös siedettävä toistuvaa käsittelyä ilman päällekkäisiä liiketoimintavaikutuksia.
Mitä käyttäjälle tulisi kertoa?
Selitä, että vahvistus on käynnissä, anna turvallinen viite ja tapa noutaa tila. Vältä uuden maksun pyytämistä, kun edellinen on epävarma.
Mitä näyttöä hyödyllisestä tarkistuksesta säilytetään?
Säilytä ei-arkaluonteiset tunnisteet, tilat ja todiste yhdestä liiketoimintavaikutuksesta. Sido uusinta API-sopimukseen, älä pelkkään aikakatkaisuun.
Webhookit: allekirjoitus ja toisto
Tämän kieliversion tarkemmat lähdekuvaukset ovat englanniksi.
A payment notification does not close reconciliation by itself
Authenticate each webhook, bind it to the right account and compare its effect with authorised server state. A repeated event must not repeat an initial activation; missing events must remain detectable.
- Separate notification identity from the operation to perform.
- Test overlapping manual resend and automatic retry.
- Retain uncertainty after an unknown external result and check the source before retrying.
See webhook signatures, digests and the ten cases →
Sources reviewed on · Stripe · Webhooks · Stripe · Manage webhook endpoints · GitHub · Validating webhook deliveries · GitHub · Best practices for using webhooks · GitHub · Handling failed webhook deliveries
API-summien tarkkuus ja täsmälliset yksiköt
Tämän kieliversion tarkemmat lähdekuvaukset ovat englanniksi.
Separate exact conversion from payment confirmation
An interface can display the correct price while preparing an incorrect provider integer. Acceptance must reconcile the server amount with the operation contract, then check confirmed state without mistaking arithmetic for completed payment.
- Test zero-, two- and three-decimal currencies.
- Include a case where step cannot be inferred from decimals.
- Retain an exact reference before localised formatting.
Check a unit in the workshop →
Adyen · Currency codes and minor units · Provider documentation · reviewed 2026-11-06
Stripe · Supported currencies and special cases · Provider documentation · reviewed 2026-11-06
Viralliset viitteet
Viitteet tukevat menetelmää. Sovita tarkastukset kontekstiisi; ne eivät ole sertifiointia. Alkuperäiset viitteiden otsikot ja lähdeasiakirjat voivat olla toisella kielellä.
Lähteet tarkistettu .
- Stripe — Payment status updates
- Stripe — Webhooks
- Stripe — Idempotent requests
- Stripe · Manage webhook endpoints
- GitHub · Validating webhook deliveries
- GitHub · Best practices for using webhooks
- GitHub · Handling failed webhook deliveries
- Adyen · Currency codes and minor units
- Stripe · Supported currencies and special cases
