Kokią užduotį sprendžia
Sukurti mokėjimų bei prenumeratų būsenų kelią, atsparų pakartojimams ir nutrūkusiems procesams.
Kada rinktis šį agentą
- Mokėjimas pavyksta, bet foninis procesas nutrūksta prieš pažymėdamas užsakymą užbaigtu.
Kada reikia kito sprendimo
- Vien naršyklės sėkmės puslapis arba išsaugotas įvykio ID neįrodo galutinio užsakymo įvykdymo.
Kokius duomenis pateikti
- Pinigų ir būsenų modelis — Sumos su valiuta, užsakymai, lėšų grąžinimo ir prenumeratos taisyklės.
- PSP sutartis — Testinės sąsajos, įvykių parašai, API versija ir operacijų ataskaitos.
Kokį rezultatą gauti
- Integracijos bei foninio proceso kodas — Patvari priimtų įvykių eilė, ribotas pakartojimas ir idempotentiški šalutiniai veiksmai.
- Sutikrinimo užklausos — Užsakymo, registro ir PSP sumų neatitikimų sąrašas.
Kaip vyksta darbas
- Būsenų projektavimas — Aprašo sėkmę, laukimą, papildomą veiksmą ir nesėkmę. Priėmimas: Kiekviena būsena turi teisėtus perėjimus.
- Patvarus priėmimas — Tikrina parašą ir išsaugo darbą iki patvirtinimo. Priėmimas: Priimtas įvykis išlieka po proceso žūties.
- Poveikio sutikrinimas — Pakartoja darbą ir lygina su tiekėjo būsena. Priėmimas: Vienas užsakymas vykdomas vieną kartą.
Įrankiai ir prieigos
- Pasirinkto PSP bandomoji aplinka ir patvari DB — Mokėjimo bei įvykio apdorojimo kodui. Prieiga: Reikia testinių raktų, konkrečios API laidos ir atskirų gyvų operacijų leidimų.
Ribos ir žmogaus sprendimai
- Integracijos aprašas nepatvirtina PCI apimties ar teisinių mokesčių reikalavimų.
Žmogaus sprendimai
- Tvirtina tikrų pinigų operacijas, lėšų grąžinimo politiką ir prieigos po nesėkmingo atnaujinimo taisykles.
Iliustracinis scenarijus
Tai sintetinis pavyzdys, o ne atlikto kliento darbo ar veikiančios integracijos ataskaita.
Prielaidos.
- Sintetinis užsakymas O-8 už 49,99 EUR, tik bandomoji aplinka.
Įvestis. Pranešimas E-1 priimtas, foninis procesas įvykdo užsakymą ir nutrūksta prieš įrašydamas užbaigimo būseną (complete).
Veiksmai.
- Pasibaigus darbo rezervacijos laikui (lease) pakartoja E-1.
- Užsakymo vykdymą tikrina pagal O-8, o ne vien E-1.
Laukiamas rezultatas. Vienas įvykdytas užsakymas, E-1 pažymėtas complete po atkūrimo, antro vykdymo nėra.
Kada sustoti. Neaiški operacijos suma ar valiuta, neteisingas parašas arba neveikia patvari priimtų įvykių eilė.
Kaip patikrinti rezultatą
- Atkūrimas — Gedimo po poveikio testas nesukuria dublio.
- Sumų sutikrinimas — Registro sumos siejamos su testinėmis PSP operacijomis.
Susiję vaidmenys ir sprendimai
- Drupal prekybos sistemų programuotojas — Kai šį būsenų kelią reikia realizuoti Drupal Commerce parduotuvėje.
- Programavimas ir technologijos — Šios grupės vaidmenų atranka ir kitų užduočių palyginimas.
Profilio kilmė
Aprašas pritaikytas pagal „agency-agents“ vaidmenį „Payments & Billing Engineer“. Prisegtas originalus šaltinis. MIT licencija. Copyright (c) 2025 AgentLand Contributors.
MB Pinet · Verslomatika. Vaidmens aprašas savaime neprijungia įrankių ir nesuteikia prieigos prie įmonės duomenų.
Profilio pagrindas: agency-agents / engineering/engineering-payments-billing-engineer.md. Viešas aprašas pritaikytas Verslomatikos procesams.
Originalaus šaltinio MIT licencija
MIT License Copyright (c) 2025 AgentLand Contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.