How nosibbiswas22/sslcommerz works
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: post-transaction/route.js Callback handler · app/page.js Payment page · success/page.js Success page · pre-transaction/route.js Start transaction
Components 11
Customer UI
- Payment page
app/page.js - Success page
app/success/page.js - Failed page
app/failed/page.js - Cancelled page
app/cancelled/page.js
Payment API
- Start transaction
app/api/sslcommerz/pre-transaction/route.js - Callback handler
app/api/sslcommerz/post-transaction/route.js - Verify transaction
app/api/sslcommerz/verify-transaction/route.js - Refund API
app/api/sslcommerz/refund/route.js
Refund Admin
- Admin panel
app/admin/page.js
Other components
- Customer
- SSLCommerz
Connections 13
- Customer → Payment page: starts payment
app/page.js - Payment page → Start transaction: requests session
app/page.js - Start transaction → SSLCommerz: creates session
app/api/sslcommerz/pre-transaction/route.js - Payment page → SSLCommerz: redirects to gateway
app/page.js - SSLCommerz → Callback handler: posts callback
- Callback handler → SSLCommerz: queries status
app/api/sslcommerz/post-transaction/route.js - Callback handler → Success page: redirects on valid
app/api/sslcommerz/post-transaction/route.js - Callback handler → Failed page: redirects otherwise
app/api/sslcommerz/post-transaction/route.js - Success page → Verify transaction: requests verification
app/success/page.js - Verify transaction → SSLCommerz: queries transaction
app/api/sslcommerz/verify-transaction/route.js - Customer → Admin panel: opens admin
- Admin panel → Refund API: requests refund or status
app/admin/page.js - Refund API → SSLCommerz: initiates or queries refund
app/api/sslcommerz/refund/route.js