{"id":24779099,"url":"https://github.com/lehuygiang28/vnpay","last_synced_at":"2025-04-04T12:07:59.609Z","repository":{"id":199523089,"uuid":"703120983","full_name":"lehuygiang28/vnpay","owner":"lehuygiang28","description":"An open-source nodejs library support to payment with VNPay (vnpay.vn)","archived":false,"fork":false,"pushed_at":"2024-10-29T19:07:50.000Z","size":1186,"stargazers_count":70,"open_issues_count":3,"forks_count":26,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-29T21:21:48.193Z","etag":null,"topics":["node","nodejs","payment","vnpay","vnpayjs"],"latest_commit_sha":null,"homepage":"https://vnpay.js.org","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lehuygiang28.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["lehuygiang28"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"lehuygiang28","custom":null}},"created_at":"2023-10-10T16:23:45.000Z","updated_at":"2024-10-29T19:07:55.000Z","dependencies_parsed_at":"2024-05-18T12:26:46.571Z","dependency_job_id":"68c70b98-f4f9-414d-b6d6-8af24a218c8e","html_url":"https://github.com/lehuygiang28/vnpay","commit_stats":null,"previous_names":["lehuygiang28/vnpay"],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lehuygiang28%2Fvnpay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lehuygiang28%2Fvnpay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lehuygiang28%2Fvnpay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lehuygiang28%2Fvnpay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lehuygiang28","download_url":"https://codeload.github.com/lehuygiang28/vnpay/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247174418,"owners_count":20896078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["node","nodejs","payment","vnpay","vnpayjs"],"created_at":"2025-01-29T09:35:30.426Z","updated_at":"2025-04-04T12:07:59.596Z","avatar_url":"https://github.com/lehuygiang28.png","language":"TypeScript","funding_links":["https://github.com/sponsors/lehuygiang28","https://buymeacoffee.com/lehuygiang28","https://www.buymeacoffee.com/lehuygiang28","https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee\u0026emoji=\u0026slug=lehuygiang28\u0026button_colour=1a1b27\u0026font_colour=ffffff\u0026font_family=Lato\u0026outline_colour=ffffff\u0026coffee_colour=FFDD00"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 📦 vnpayjs\n\n[🇻🇳 Tiếng Việt](./README.md) | [🇺🇸 English](./README_en-US.md)\n\n[![NPM Version](https://img.shields.io/npm/v/vnpay)](https://www.npmjs.com/package/vnpay)\n[![Package License](https://img.shields.io/npm/l/vnpay)](https://www.npmjs.com/package/vnpay)\n[![NPM Downloads](https://img.shields.io/npm/d18m/vnpay)](https://www.npmjs.com/package/vnpay)\n\n**Thư viện Node.js tích hợp cổng thanh toán [VNPay](https://vnpay.vn) vào ứng dụng của bạn.**\n\n\u003c/div\u003e\n\n## 📚 Tài liệu\n\n**Thư viện VNPay:**\n- [vnpay.js.org](https://vnpay.js.org/) - Tài liệu chi tiết của thư viện\n- [sandbox.vnpayment.vn/apis](https://sandbox.vnpayment.vn/apis) - Tài liệu tích hợp từ VNPay\n\n## 🚀 Cài đặt\n\n\u003e [!TIP]\n\u003e Nếu bạn đang sử dụng [`Nestjs`](https://docs.nestjs.com), hãy cài đặt [`nestjs-vnpay`](https://github.com/lehuygiang28/nestjs-vnpay) - một wrapper tích hợp sẵn cho NestJS.\n\n```bash\n# NPM\nnpm install vnpay\n\n# Yarn\nyarn add vnpay\n\n# PNPM\npnpm install vnpay\n```\n\n## 💡 Cách sử dụng\n\n### Khởi tạo VNPay\n\n```typescript\nimport { VNPay, ignoreLogger } from 'vnpay';\n\nconst vnpay = new VNPay({\n    // Thông tin cấu hình bắt buộc\n    tmnCode: '2QXUI4B4',\n    secureSecret: 'secret',\n    vnpayHost: 'https://sandbox.vnpayment.vn',\n    \n    // Cấu hình tùy chọn\n    testMode: true,                // Chế độ test\n    hashAlgorithm: 'SHA512',      // Thuật toán mã hóa\n    enableLog: true,              // Bật/tắt ghi log\n    loggerFn: ignoreLogger,       // Hàm xử lý log tùy chỉnh\n    \n    // Tùy chỉnh endpoints cho từng phương thức API (mới)\n    // Hữu ích khi VNPay thay đổi endpoints trong tương lai\n    endpoints: {\n        paymentEndpoint: 'paymentv2/vpcpay.html',          // Endpoint thanh toán\n        queryDrRefundEndpoint: 'merchant_webapi/api/transaction', // Endpoint tra cứu \u0026 hoàn tiền\n        getBankListEndpoint: 'qrpayauth/api/merchant/get_bank_list', // Endpoint lấy danh sách ngân hàng\n    }\n});\n```\n\n## 🤝 Hỗ trợ \u0026 Đóng góp\n\n**vnpayjs là một dự án mã nguồn mở và miễn phí**\n\nNếu bạn thấy thư viện hữu ích, hãy:\n- Tặng sao ⭐️ trên [GitHub](https://github.com/lehuygiang28/vnpay)\n- Mời tác giả một ly cà phê ☕️\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://www.buymeacoffee.com/lehuygiang28\" target=\"_blank\"\u003e\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee\u0026emoji=\u0026slug=lehuygiang28\u0026button_colour=1a1b27\u0026font_colour=ffffff\u0026font_family=Lato\u0026outline_colour=ffffff\u0026coffee_colour=FFDD00\" height=\"48\" alt=\"Buy me a coffee\"\u003e\u003c/a\u003e\n\u003ca href=\"https://me.momo.vn/lehuygiang28\" target=\"_blank\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/lehuygiang28/about-me/refs/heads/main/public/images/momo-donation.png\" height=\"48\" alt=\"Momo donation\"\u003e\u003c/a\u003e\n\n\u003c/div\u003e\n\n### Tham gia đóng góp\n\nTham gia phát triển dự án:\n1. Đọc [hướng dẫn đóng góp](.github/CONTRIBUTING.md)\n2. Fork dự án và tạo Pull Request\n3. Tham gia thảo luận trong [Issues](https://github.com/lehuygiang28/vnpay/issues)\n\n### Những người đóng góp\n\nCảm ơn tất cả những người đã đóng góp cho dự án:\n\n\u003cdiv align=\"center\"\u003e\n\n[![Contributors](https://contrib.rocks/image?repo=lehuygiang28/vnpay\u0026max=20)](https://github.com/lehuygiang28/vnpay/graphs/contributors)\n\n\u003c/div\u003e\n\n## 📄 Giấy phép\n\n[MIT](LICENSE) © [Lê Huy Giang](https://github.com/lehuygiang28)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flehuygiang28%2Fvnpay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flehuygiang28%2Fvnpay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flehuygiang28%2Fvnpay/lists"}