| Charge ID |
Order No |
金額 |
決済方法 |
ステータス |
作成日時 |
操作 |
直近100件のチャージから refunded / partially_refunded の取引を抽出して
GET /charges/{id}/refunds で返金履歴を取得しています。
| Refund ID |
Charge ID |
返金金額 |
理由 |
ステータス |
処理日時 |
| 読込中… |
実 GET /customers から取得。各顧客の保存カード(Sources)と請求履歴(Charges)も実APIで集計。
| Customer ID |
Name |
Email |
登録日 |
保存カード |
累計取引 |
ステータス |
| 読込中… |
elepay は明示的なSubscriptionリソースを持たないため、加盟店側で
customerId + sourceId による継続課金を実装する。
このページは GET /charges + GET /customers から MRR/アクティブ顧客などを推定集計表示。
アクティブ顧客
…
elepay /customers
継続課金実行(直近)
…
customerId+sourceId付charge
課金失敗
…
継続課金で status:failed
継続課金履歴(customerId + sourceId 付き取引)
| 請求日 |
Charge ID |
顧客 |
金額 |
ステータス |
説明 |
| 読込中… |
📡 Webhook エンドポイント
elepay 管理画面の Webhook 設定で以下のURLを登録してください:
読込中…
有効
このエンドポイントが elepay からのPOSTを受け取り、HMAC-SHA256で署名検証した上で
Cloudflare KVに保存します(30日TTL)
推奨購読イベント
charge.captured
charge.failed
charge.refunded
charge.revoked
refund.created
refund.failed
source.chargeable
elepay 管理画面でこれらのイベントを購読するよう設定してください
⚠️ 署名検証について(既知の課題)
elepay 公式仕様 (HMAC-SHA256 over "<timestamp>.<body>") に従って
検証していますが、Cloudflare Pages Functions で受信したボディと elepay 側の署名対象が
完全一致しない問題があります(200+パターンと公式 Java SDK の実装を確認済)。
このため、送信元IP(elepay AWS 東京リージョン: 3.x / 18.x / 54.x)による信頼判定を
補助として併用しています。本番運用では elepay サポートへの照会を推奨。
📥 受信履歴 (実 Cloudflare KV)
| 受信時刻 |
Event Type |
Event ID |
関連 ID |
署名検証 |
サイズ |
| 読込中… |
⚠️ 秘密鍵は厳重に管理してください。クライアント側コードには絶対含めず、環境変数で管理しましょう。
Live モード API キー
公開鍵 (Publishable Key)
pk_live_xxxxxxxxxxxxxxxxxxxxxxxx
秘密鍵 (Secret Key)
sk_live_••••••••••••••••••••••••
Test モード API キー
公開鍵
pk_test_xxxxxxxxxxxxxxxxxxxxxxxx