# nosibbiswas22/sslcommerz architecture

> Architecture diagram of the GitHub repository nosibbiswas22/sslcommerz, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nosibbiswas22/sslcommerz
- Repository: https://github.com/nosibbiswas22/sslcommerz

## Overview

This is a minimal Next.js App Router example for SSLCommerz payments. A user starts a payment from the home page; the pre-transaction route creates a gateway session, and SSLCommerz sends a callback to the post-transaction route, which queries transaction status and redirects to a result page. The success page performs a further server-side verification. The admin page initiates refunds or checks their status through one API route. The cancelled page exists, but the sampled callback does not route to it; links reflect only documented or excerpted behavior.

Main entry points: [`app/api/sslcommerz/post-transaction/route.js`](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/post-transaction/route.js) (Callback handler), [`app/page.js`](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/page.js) (Payment page), [`app/success/page.js`](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/success/page.js) (Success page), [`app/api/sslcommerz/pre-transaction/route.js`](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/pre-transaction/route.js) (Start transaction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer_ui["Customer UI"]
  node_home["Payment page<br/>[page.js]"]
  node_success["Success page<br/>[page.js]"]
  node_failed["Failed page<br/>[page.js]"]
  node_cancelled["Cancelled page<br/>[page.js]"]
end

subgraph group_payment_api["Payment API"]
  node_pre_transaction["Start transaction<br/>[route.js]"]
  node_post_transaction["Callback handler<br/>[route.js]"]
  node_verify_transaction["Verify transaction<br/>[route.js]"]
  node_refund["Refund API<br/>[route.js]"]
end

subgraph group_admin_ui["Refund Admin"]
  node_admin["Admin panel<br/>[page.js]"]
end

node_customer(("Customer"))
node_sslcommerz{{"SSLCommerz"}}

node_customer -->|"starts payment"| node_home
node_home -->|"requests session"| node_pre_transaction
node_pre_transaction -->|"creates session"| node_sslcommerz
node_home -->|"redirects to gateway"| node_sslcommerz
node_sslcommerz -->|"posts callback"| node_post_transaction
node_post_transaction -->|"queries status"| node_sslcommerz
node_post_transaction -->|"redirects on valid"| node_success
node_post_transaction -->|"redirects otherwise"| node_failed
node_success -->|"requests verification"| node_verify_transaction
node_verify_transaction -->|"queries transaction"| node_sslcommerz
node_customer -->|"opens admin"| node_admin
node_admin -->|"requests refund or status"| node_refund
node_refund -->|"initiates or queries refund"| node_sslcommerz

click node_home "https://github.com/nosibbiswas22/sslcommerz/blob/main/app/page.js"
click node_pre_transaction "https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/pre-transaction/route.js"
click node_post_transaction "https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/post-transaction/route.js"
click node_success "https://github.com/nosibbiswas22/sslcommerz/blob/main/app/success/page.js"
click node_verify_transaction "https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/verify-transaction/route.js"
click node_failed "https://github.com/nosibbiswas22/sslcommerz/blob/main/app/failed/page.js"
click node_cancelled "https://github.com/nosibbiswas22/sslcommerz/blob/main/app/cancelled/page.js"
click node_admin "https://github.com/nosibbiswas22/sslcommerz/blob/main/app/admin/page.js"
click node_refund "https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/refund/route.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_success,node_failed,node_cancelled toneBlue
class node_pre_transaction,node_post_transaction,node_verify_transaction,node_refund toneAmber
class node_admin toneMint
class node_customer,node_sslcommerz toneIndigo
```

## Components

### Customer UI

- [Payment page](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/page.js): `app/page.js`
- [Success page](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/success/page.js): `app/success/page.js`
- [Failed page](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/failed/page.js): `app/failed/page.js`
- [Cancelled page](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/cancelled/page.js): `app/cancelled/page.js`

### Payment API

- [Start transaction](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/pre-transaction/route.js): `app/api/sslcommerz/pre-transaction/route.js`
- [Callback handler](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/post-transaction/route.js): `app/api/sslcommerz/post-transaction/route.js`
- [Verify transaction](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/verify-transaction/route.js): `app/api/sslcommerz/verify-transaction/route.js`
- [Refund API](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/api/sslcommerz/refund/route.js): `app/api/sslcommerz/refund/route.js`

### Refund Admin

- [Admin panel](https://github.com/nosibbiswas22/sslcommerz/blob/main/app/admin/page.js): `app/admin/page.js`

### Other components

- **Customer**
- **SSLCommerz**

## Connections

- Customer → Payment page: starts payment (evidence: `app/page.js`)
- Payment page → Start transaction: requests session (evidence: `app/page.js`)
- Start transaction → SSLCommerz: creates session (evidence: `app/api/sslcommerz/pre-transaction/route.js`)
- Payment page → SSLCommerz: redirects to gateway (evidence: `app/page.js`)
- SSLCommerz → Callback handler: posts callback
- Callback handler → SSLCommerz: queries status (evidence: `app/api/sslcommerz/post-transaction/route.js`)
- Callback handler → Success page: redirects on valid (evidence: `app/api/sslcommerz/post-transaction/route.js`)
- Callback handler → Failed page: redirects otherwise (evidence: `app/api/sslcommerz/post-transaction/route.js`)
- Success page → Verify transaction: requests verification (evidence: `app/success/page.js`)
- Verify transaction → SSLCommerz: queries transaction (evidence: `app/api/sslcommerz/verify-transaction/route.js`)
- Customer → Admin panel: opens admin
- Admin panel → Refund API: requests refund or status (evidence: `app/admin/page.js`)
- Refund API → SSLCommerz: initiates or queries refund (evidence: `app/api/sslcommerz/refund/route.js`)
