24 lines
1.4 KiB
Markdown
24 lines
1.4 KiB
Markdown
# 0029 Every payment ends on its result page
|
||
|
||
Status: Proposed · Area: architecture · Date: 2026-10-08 · Decided by: agent
|
||
|
||
## Context
|
||
|
||
U10 §۹ (Oct 2026) ends every payment on one result page. The API, not the front, verifies with the bank: its `/payments/callback` redirects the browser to `CHECKOUT_SUCCESS_URL`, `CHECKOUT_CANCEL_URL` or `CHECKOUT_PENDING_URL` with `?paymentId=&status=`.
|
||
|
||
## Decision
|
||
|
||
- Set those three API URLs to the site's `/payment/return` (`ROUTES.paymentReturn`). The page shows «در حال تأیید پرداخت...», reads the payment every 2 s until it is settled, then `router.replace`s itself with `/payment/result/[paymentId]` (`ROUTES.paymentResult`). After 30 s it moves on anyway, and the result shows «در حال بررسی».
|
||
- Subscribe, renew and reactivate all end there, including a development grant (no bank).
|
||
- Both pages render in the browser behind `AuthGuard role="investor"`; the return page's skeleton is the confirming screen itself.
|
||
|
||
## Alternatives
|
||
|
||
- Return straight to checkout or the channel with a toast (U9 ۵.۲, U10 ۱.۲): superseded by the design.
|
||
- Point the API at the result page: its callback appends a query string, not a path segment.
|
||
|
||
## Consequences
|
||
|
||
- Each deployment's API env must name the right site; bull and bear share the URL, and the edge routes by device.
|
||
- The in-sheet renew success and failure states (R3 03, 04) are not built: the result page replaces them.
|