IR Bank Mock

A service for testing the internet payment gateways of Iranian banks for development environments.

سرویسی برای تست درگاه پرداخت اینترنتی بانک های ایرانی در محیط‌های توسعه

Support

This service currently only supports Saman Bank (SEP).

Configuration

Visit conf.go to see which environment variables are supported.

Deploy with Docker

docker run -v "irbankmock-data:/opt/irbankmock/data" -p 13000:3000 ghcr.io/abramad-labs/irbankmock:0.0.9-r1

Deploy with Compose

Download docker-compose.yml from this repository and then execute:

docker compose up -d

Security Considerations

This is a lightweight service used for testing purposes only. This is why there is no authentication or banking security protocols invloved. Do not expose this service into to the wilderness.

Sqlite Notice

We decided to use github.com/glebarez/sqlite instead of gorm.io/driver/sqlite. The trade-off was to lose a little bit of performance to gain a cgo-free package. This also enabled us to use distroless/static instead of distroless/base.

Read more:

• cgo is not go
• SQLite in Go, with and without cgo

Debugging

1. Run the backend (golang) server with: go run .\cmd\server\main.go
2. Run the frontend (typescript) server with: cd .\web\app and bun run dev
   • Note that in development environemnt the frontend server proxies the requests it can't handle using nextjs rewrite config to the backend server. In production however, both backend and frontend are served using the same Go fiber server.

Specification

Saman Electronic Payment (SEP)

• Implemented based on SEP_OnlinePG_Merchant Document_Minimal_Current.pdf

• It's a terrible documentation, I know...