SDK概要

Jamm連携用の公式サーバーサイドSDK — 言語を選んで始められます。

JammはPayment APIをラップする公式のサーバーサイドSDKを提供します：認証、on-session／off-session決済、返金・キャンセル、カスタマー管理、Webhook検証。トークンの交換と更新はSDKが処理するため、生のHTTPではなく型付きメソッドで操作できます。

⚠️ セキュリティ上の注意: これらのSDKは貴社のバックエンドで動作します。Client IDとClient Secretは、ブラウザやモバイルのコードに決して公開してはいけません。

利用可能なSDK

初期化

各SDKは、認証情報と対象環境（テスト用はstaging、本番用はproduction）で一度だけ設定します。

// Node.js
import jamm from "@jamm-pay/node-sdk";

jamm.config.init({ 
  clientId: process.env.JAMM_CLIENT_ID, 
  clientSecret: process.env.JAMM_CLIENT_SECRET, 
  environment: "staging" 
});

# Ruby
Jamm.configure(
  client_id: ENV["JAMM_CLIENT_ID"], 
  client_secret: ENV["JAMM_CLIENT_SECRET"], 
  env: "develop"
)

// PHP
$jamm = new \Jamm\Client(
    $clientId, 
    $clientSecret, 
    environment: "staging"
);

// Java
JammClient client = JammClient.builder()
    .clientId(System.getenv("JAMM_CLIENT_ID"))
    .clientSecret(System.getenv("JAMM_CLIENT_SECRET"))
    .environment(Environment.STAGING)
    .build();

SDKがカバーする範囲

• 決済 — on-session（ホスト型リダイレクト）とoff-session（バックグラウンド、非同期）。
• 返金・キャンセル — 全額・部分返金、当日キャンセル。
• カスタマー — 作成・取得・更新・削除。activated準備完了フラグの確認。
• Webhook — 署名検証とイベントのパース。

フロントエンド

Jammの決済は貴社のバックエンドから制御します。サーバーが決済を作成してpayment URLを受け取り、フロントエンドはbuyerをそこへリダイレクトするだけです。現時点で必須のフロントエンドSDKはありません。