easypay.js is a comprehensive payment service library designed specifically for handling various Iranian payment gateways with ease.
- Extensible: Easily extend the library to support other Iranian payment gateways in the future.
- Simple Integration: Designed for developers to quickly integrate payment functionalities into their applications.
- ZarinPal
- IDPay
- Zibal
npm install easypay.jsHere's a basic example demonstrating how to integrate ZarinPal using easypay.js with an Express.js application:
import express, { Request, Response } from "express";
import { getPaymentDriver, ZarinPalDriver } from "easypay.js";
const app = express();
app.listen(3000);
const zarinPalDriver: ZarinPalDriver = getPaymentDriver("zarinpal");
zarinPalDriver.setToken("your-zarinpal-token");
const AMOUNT = 100000;
app.post("/payment/checkout", async (req: Request, res: Response) => {
const result = await zarinPalDriver.request(
{
amount: AMOUNT,
callback_url: "https://localhost:3000/payment/checkout/cb",
description: "test description",
},
false,
);
if (result.isError) {
res.status(500).json({
success: false,
message: result.error.message,
errCode: result.error.code,
validations: result.error.validations,
});
} else {
res.status(200).json({
success: true,
messsage: result.data.message,
url: result.data.url,
});
}
});
app.get("/payment/checkout/cb", async (req: Request, res: Response) => {
const Status = String(req.query.Status);
if (Status === "OK") {
const verifyResult = await zarinPalDriver.verify({
amount: AMOUNT,
authority: String(req.query.Authority),
});
if (verifyResult.isError) {
res.status(400).json({
success: true,
message: verifyResult.error.message, // or custom message
code: verifyResult.error.code,
});
} else {
res.status(200).json({
success: true,
verifyResult,
});
}
} else {
res.status(400).json({ success: false, message: "canceled" });
}
});
console.log(`Server running on port: 3000`);For detailed documentation and API references, visit the official documentation: easypay.js Documentation
We welcome contributions! Please read our Contributing Guidelines for details on how to contribute to this project.
This project is licensed under the MIT License - see the LICENSE file for details.