構築するもの
Card API では、カード決済のフローを最初から最後までコントロールできます。決済の作成、オーソリ済み資金のキャプチャ、キャプチャ前の Void、キャプチャ後の返金、繰り返し利用のためのカードのトークン化、そして一覧と詳細のエンドポイントによる消込が可能です。ステータスの変更は Webhook で通知され、購入後のフローはアップセルの場面にも対応します。 対応するスキームには Visa、Mastercard、その他の主要ブランドに加え、Apple Pay と Google Pay が含まれます。資金は通貨ごとの Treasury Account へ精算され、自動的に消込されます。連携方法を選ぶ
SDK（クライアントサイド）
Hello Clever の JavaScript SDK を使ったウェブ／モバイルのフロントエンドです。USD と AUD に対応します。生のカード情報を扱わずに、そのまま組み込めるチェックアウトに最適です。
サーバー間通信 (S2S)
自社のバックエンドから生の
card_info を送信します。AUD に対応します。PCI DSS に準拠したシステムで、オーソリとキャプチャを完全にコントロールしたい場合に適します。事前準備
- 加盟店アカウントと
app-id/secret-key。 - サンドボックス
https://api.cleverhub.co、本番環境https://api-merchant.helloclever.co。 - 決済ステータスの変更を受ける Webhook のエンドポイント（TLS 1.2、公開、商用証明書）。
- S2S の場合：PCI DSS に準拠した環境。
カードのエンドポイント
決済のライフサイクル
1
作成（オーソリ）
- SDK
- S2S
- トークン化
フロントエンドで JS SDK を初期化し、決済を作成してコールバックを処理します。導入と初期化については SDK 連携ガイドを参照してください。
2
キャプチャまたは Void
- 決済がオーソリされたがキャプチャされていない場合は、Capture Payment を呼び出して全額を精算します（注文を発送するときなど）。
- キャプチャ前に取り消す必要がある場合は、Void Payment を呼び出します。
キャプチャと Void は排他的です。Void はキャプチャ前にのみ機能します。
3
返金
キャプチャ後は、Refund Payment を使って全額または一部を返金します（返品や価格の調整などの場合）。
4
購入後・アップセル
Card API は購入後のフローに対応します。保存されたトークンを再利用して、顧客がカード情報を再入力せずに、最初の購入の後にアップセルを請求できます。
トークン化と保存されたカード
カードを一度トークン化すれば、その後はtoken_id を使って Create Payment via Tokenisation で請求できます。顧客がカードを削除した場合や不要になった場合は、Delete Token を呼び出して無効化してください。
消込
- List Payment：レポート作成のため、期間とステータスで取引を取得します。既定では1ページ 20 件でページ分割されます。
- Detail Payment：サポートや異議申立ての対応のため、個々の取引を詳しく確認します。
Webhook
補足
- カード Payin サービスでは、サーチャージとデジタルウォレット（Apple Pay / Google Pay）に対応しています。
- 対応通貨は連携方法に合わせてください。SDK は USD と AUD、S2S は AUD に対応します。