Demonstrate duplicate payment notifications with SQLite
This commit is contained in:
commit
228b888e2d
18
README.md
Normal file
18
README.md
Normal file
@ -0,0 +1,18 @@
|
|||||||
|
# Handling a payment notification twice
|
||||||
|
|
||||||
|
A sender that misses an acknowledgment can retry a notification after the receiver has already committed it. This small Python and SQLite example shows what happens when both deliveries carry the same event ID.
|
||||||
|
|
||||||
|
Run `python3 demo.py` with Python 3.8 or later and SQLite 3.24 or later. It uses an in-memory database and makes no network requests.
|
||||||
|
|
||||||
|
```text
|
||||||
|
recorded
|
||||||
|
already recorded
|
||||||
|
event ID was reused with a different amount or currency
|
||||||
|
1 row, 2500 USD minor units
|
||||||
|
```
|
||||||
|
|
||||||
|
The example stores amounts as integer minor units. A unique event ID prevents a second insert. On a conflict, the receiver checks the stored amount and currency before treating the delivery as a retry. The final query counts one row for USD 25.00.
|
||||||
|
|
||||||
|
The example assumes the caller has already authenticated the notification. It demonstrates database behavior with synthetic data.
|
||||||
|
|
||||||
|
Prepared by Cole for [NexaPay](https://nexapay.one/).
|
||||||
43
demo.py
Normal file
43
demo.py
Normal file
@ -0,0 +1,43 @@
|
|||||||
|
"""Apply a payment notification once, even when delivery is retried."""
|
||||||
|
import sqlite3
|
||||||
|
|
||||||
|
|
||||||
|
def record_payment(database, event_id, amount_minor, currency):
|
||||||
|
with database:
|
||||||
|
result = database.execute(
|
||||||
|
"""INSERT INTO payments (event_id, amount_minor, currency)
|
||||||
|
VALUES (?, ?, ?) ON CONFLICT(event_id) DO NOTHING""",
|
||||||
|
(event_id, amount_minor, currency),
|
||||||
|
)
|
||||||
|
if result.rowcount == 1:
|
||||||
|
return "recorded"
|
||||||
|
previous = database.execute(
|
||||||
|
"SELECT amount_minor, currency FROM payments WHERE event_id = ?",
|
||||||
|
(event_id,),
|
||||||
|
).fetchone()
|
||||||
|
if previous != (amount_minor, currency):
|
||||||
|
raise ValueError("event ID was reused with a different amount or currency")
|
||||||
|
return "already recorded"
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
db = sqlite3.connect(":memory:")
|
||||||
|
db.execute(
|
||||||
|
"""CREATE TABLE payments (
|
||||||
|
event_id TEXT PRIMARY KEY NOT NULL,
|
||||||
|
amount_minor INTEGER NOT NULL CHECK (amount_minor > 0),
|
||||||
|
currency TEXT NOT NULL
|
||||||
|
)"""
|
||||||
|
)
|
||||||
|
print(record_payment(db, "event-17", 2500, "USD"))
|
||||||
|
print(record_payment(db, "event-17", 2500, "USD"))
|
||||||
|
try:
|
||||||
|
record_payment(db, "event-17", 3000, "USD")
|
||||||
|
except ValueError as exc:
|
||||||
|
print(exc)
|
||||||
|
count, total = db.execute(
|
||||||
|
"SELECT count(*), sum(amount_minor) FROM payments WHERE currency = 'USD'"
|
||||||
|
).fetchone()
|
||||||
|
assert (count, total) == (1, 2500)
|
||||||
|
print(f"{count} row, {total} USD minor units")
|
||||||
|
db.close()
|
||||||
Loading…
x
Reference in New Issue
Block a user