連携のモード
SDK 連携
ウェブとモバイル向けのクライアントサイド JavaScript SDK です。USD と AUD に対応します。カード入力の UI は Hello Clever が描画するため、フロントエンドに PCI の対象範囲は生じません。
サーバー間通信 (S2S)
PCI DSS に準拠したサーバーから、生のカード情報を Card API へ直接送信します。AUD のみに対応します。オーソリとキャプチャのフローを完全にコントロールできます。
認証
Card API は、Bearer トークンではなくapp-id と secret-key をリクエストのヘッダーとして使用します。
app-id と secret-key は Merchant Portal（マーチャントポータル）から取得します。連携キーを参照してください。
決済のライフサイクル
1
charge を作成する
カード情報を送信する (S2S) か、SDK を使って収集します。API はオーソリの結果を返します。
2
必要な場合は 3DS を処理する
カードが 3DS 認証を必要とする場合、レスポンスに
3ds_url が含まれます。顧客をこの URL へリダイレクトしてください。認証の後、顧客は return_url へ戻ります。3
決済をキャプチャする
capture: false を設定した場合は、資金を回収する準備が整った時点でキャプチャのエンドポイントを明示的に呼び出します。capture: true の場合は、オーソリ時に自動でキャプチャされます。4
返金または Void を行う
キャプチャ後は全額または一部の返金を発行でき、まだキャプチャしていない決済は Void で取り消せます。
カードのトークンの再利用
決済がauthorised のステータスに達すると、Hello Clever は token のオブジェクト（例：tok_dfe1988a1ffc...）を返します。このトークンを保存すれば、同じ顧客に対してカード情報を再入力せずに将来の請求ができます。カードのトークン化を参照してください。
Webhook の通知
カード決済のステータスの変更は、設定した Webhook のエンドポイントへ配信されます。authorised、received、failed、return_received などのイベントを購読してください。イベントのリファレンスとペイロードのスキーマの全体は Webhook を参照してください。