トルコの主要銀行・決済サービス30社以上に対応した、フレームワーク非依存のNode.js/TypeScript統一決済ライブラリです。
中辛 の解説
スタック・構成: TypeScript、Node.js 18以上、fast-xml-parser（XML解析用）。バンク系とiyzico系に分かれた複数ドライバ（FakeGateway、IyzicoGateway、ToslaGateway、AkbankPosGateway、MokaGateway、PayForGateway、PayFlexGateway、GarantiGateway他）。
バロデータ: ドライバは実装段階で、実際のテスト環境での検証がまだ完了していないものが複数あります（3D SecureフローやHash署名検証など）。
すぐに使えるか: Fake（モック）ドライバで基本的な処理フロー（支払い作成、検証、払い戻し）を検証できます。実際の銀行統合には各銀行の認証情報とテスト環境の準備が必要です。
デモ: 公式サンプルプロジェクト（anadolupay-node-example）がExpress + Reactで提供されており、同じ環境変数形式で動作します。
이런 레포예요
이럴 때 쓰면 좋아요
- トルコの複数銀行と提携する越境ECサイトで、単一の決済インターフェイスで複数の銀行APIを管理する
- iyzico、Tosla、Garanti、VakıfBankなど異なる決済事業者に対応したPOS・決済システムをNode.jsで構築する
- 3D Secure認証を含むオンライン決済フローをExpress・NestJS・Next.jsアプリケーションに組み込む
핵심 기능
대안 대비 차별점
PHP版で30以上の銀行で実際のテスト環境検証を完了済みであり、実装上の細部（Hash署名順序、3D Secureの真の動作など）がドキュメントの表記と異なる部分も判明しているため、単なるコード翻訳ではなく、既知の実装知見に基づいた堅牢な移植が可能です。
食べた人たち
実際に使ってみた人の記録です — 一言も完走の記録も、確認のうえで公開しています。
このリポジトリの作り方
はじめてですか？ むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。
준비물
- Node.js 18以上
- 各銀行のテスト環境へのアクセス（本番利用時）
- 銀行から発行された認証情報（マーチャントID、APIキー、秘密鍵など）
すぐ動かしてみるNode.js (npm)
ギット飯がリポジトリの構成を確認して組み立てた実行コマンドです。ターミナルに貼り付ければ、取得から実行までまとめて進みます。
git clone --depth 1 https://github.com/Voxyfy/anadolupay-node.git && cd anadolupay-node && npm install
실행 명령은 README를 확인하세요.
コードは自分の環境で動きます — はじめて見るリポジトリなら、中身にひととおり目を通してから実行するのがおすすめです。
README가 안내하는 자세한 단계 보기
- パッケージをインストールしてください
npm install @voxyfy/anadolupay
- ドライバを初期化してください（モック例）
import { createAnadoluPay, FakeGateway, CreatePaymentData } from '@voxyfy/anadolupay';
const anadolupay = createAnadoluPay({
drivers: {
fake: () => new FakeGateway(),
},
});
- 支払いを作成してください
const gateway = anadolupay.driver('fake');
const payment = await gateway.createPayment(
new CreatePaymentData({
amount: 100,
currency: 'TRY',
orderId: 'SIPARIS-123',
customer: {},
}),
);
- 実際の銀行を使う場合、環境変数で認証情報を設定してください
IYZICO_BASE_URL=https://api.sandbox.iyzipay.com
IYZICO_API_KEY=your_api_key
IYZICO_SECRET_KEY=your_secret_key
IYZICO_CALLBACK_URL=https://yourdomain.com/callback
- IyzicoドライバのようなREAL実装を追加してください
const anadolupay = createAnadoluPay({
drivers: {
iyzico: () =>
new IyzicoGateway({
baseUrl: process.env.IYZICO_BASE_URL!,
apiKey: process.env.IYZICO_API_KEY!,
secretKey: process.env.IYZICO_SECRET_KEY!,
defaultCallbackUrl: process.env.IYZICO_CALLBACK_URL,
}),
},
});
ギット飯トライで味見
入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。
ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。
npx gitbap-try Voxyfy/anadolupay-node
Node.js さえあれば、インストールなしで動きます · ギット飯トライとは？ →
スター推移 · 7日
使いやすさ · まねしやすいか
- ゆるいライセンス
- テストあり
- サンプル集
- 最近の更新
- AGENTS.md
- llms.txt
- テンプレート
最近の更新あり · 2026 年に作成
「커머스·결제」 こういうリポジトリを毎週受け取りませんか？
毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。
自分のリポジトリですか？ README にギット飯バッジを貼る
[](https://www.gitbap.com/r/Voxyfy/anadolupay-node)Claude からそのまま使う — ギット飯のつなぎ方
ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。
Claude の設定 → コネクタにこのアドレスを貼り付け。
https://www.gitbap.com/api/mcpプラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI が README をもとに要約しました · 原文を見る