クレジットカード決済

オンラインサイト（オンラインモール・チケットサイト・チャージサイトなど）を持つ商店は、国際クレジットカードでの支払いをサポートしたい場合、この章で提供するクレジットカード決済製品を統合できます。

クレジットカード決済は、PayCloudオンライン決済センターの決済方法の一つです。商店は注文時にクレジットカード決済を指定し、ユーザーが商店ページでクレジットカード決済を選択すると、ブラウザが自動的にPayCloudオンライン決済センターへ遷移し、ユーザーは決済センターでカード情報を入力して決済を完了します。

ユーザーが決済を完了すると、商店はPayCloudの決済通知を受け取ることができます。また、商店は注文照会APIを呼び出して決済結果を取得することもできます。決済結果を取得した後、PayCloudは商店に注文情報を同期・更新し、残りの商品やサービスの提供を完了します。

対応カードブランド：JCB、VISA、Mastercard、American Express、Diners、Discover など。

対応取引タイプ：消費（Consumption）、取消（Cancellation）、返金（Refund）、与信（PreAuth）など。

端末タイプ	シーン	説明
WEB	PCウェブ決済	商店のウェブサイトをPCブラウザで開き、決済センターへ遷移して決済を完了
WAP	モバイルウェブ決済	商店のウェブサイトをモバイル/タブレットブラウザで開き、決済センターへ遷移して決済を完了、os_type の指定が必要

統合説明

1. カード情報入力ページを自前で開発する必要はありません。 カード番号・有効期限・セキュリティコードなどの機密情報はすべてPayCloud決済センター内で入力されるため、商店システムは機密性の高いカードデータに触れず、商店のPCI DSSコンプライアンス負担を軽減できます。
2. 注文時の pay_method_id には CreditLinkPay（クレジットカード決済の総称）を指定してください。カードブランド（Visa/MasterCard/JCBなど）を決済方法として渡さないでください。 ユーザーが実際に使用するカードブランドは、決済センターがカード番号（BIN）から自動的に識別します。
3. 3D Secure（3DS）認証は決済センターが自動的に行うため、商店側での追加開発は不要です。発行銀行がカード会員の認証を要求する場合、決済センターがユーザーを認証完了へ誘導してから決済を続行します。
4. ユーザーが決済を完了すると、商店はPayCloudの決済通知を受け取ることができ、注文照会APIを呼び出して決済結果を取得することもできます。
5. このAPIを呼び出す前に、対応する製品権限が開通済みであることを確認してください。

注意事項

クレジットカード決済では現在 sub_pay_method_id の指定はサポートされていません。特定カードブランドのキャンペーンや分割払いが必要な場合は、事前に営業担当にご連絡のうえ評価してください。

画面と操作の詳細

決済センター画面イメージ

PayCloud オンライン決済センター

図1　PCウェブ決済センター

図2　モバイルウェブ決済センター

決済フロー

ステップ1：ユーザーは商店のウェブサイトで商品を選択して注文し、支払い方法の一覧から「クレジットカード決済」を選択します。商店のサーバーはPC/モバイルウェブ決済・注文API（pay_method_id = CreditLinkPay、terminal_type = WEB/WAP）を呼び出し、決済センターの遷移先URLを取得します。

ステップ2：商店ページからPayCloudオンライン決済センターへ遷移します（または新しいウィンドウで開きます）。決済センターの左側には取引詳細（商店名/店舗、取引番号、取引時間、説明、決済金額）が表示され、右側がクレジットカード決済フォームです。

ステップ3：ユーザーはカード情報を入力します：カード番号（入力中、決済センターがBINからカードブランドを識別し、該当アイコンをハイライト表示します）、有効期限（月/年のプルダウン）、セキュリティコード（CVV/CVC、ヘルプ表示付き）、カード名義。

ステップ4：ユーザーが「支払いへ進む」をクリックします。発行銀行が3D Secure認証を要求する場合、ページは発行銀行の認証ページ（SMS認証コード/アプリ確認など）へ遷移し、認証完了後に自動的に戻ります。

ステップ5：決済完了後、決済センターは決済結果ページを表示します。注文時に return_url が指定されていた場合、ユーザーは商店ページへリダイレクトされ、商店はこれに基づいてカスタマイズした注文処理結果を表示できます。

ステップ6：PayCloudは商店のサーバーへ非同期の決済結果通知（notify_url）を送信し、通知結果を最終的な入金の根拠とします。

決済結果の取得（2チャネル）

• 非同期通知：取引完了後、PayCloudは notify_url 宛てに取引結果通知を送信します。商店は署名検証のうえ注文ステータスを更新し、規定の応答を返します。
• 能動照会：通知が届かない・遅延する・ユーザーが途中でページを閉じた場合は、注文照会を呼び出して最終ステータスを確認します。

注意事項

決済センター画面からの同期リダイレクト（return_url）を決済成功の判断根拠にしないでください。同期リダイレクトは、ユーザーが途中でブラウザを閉じた場合に失われる可能性があります。

開発ガイド

API一覧

REST APIのセットを提供しています。下表をご参照ください。複数言語のSDKも提供しており、SDKの章をご参照ください。

API名	説明
PC/モバイルウェブ決済・注文	このAPIで決済注文を送信、pay_method_id = CreditLinkPay を指定
注文取消	未払いの注文をクローズします。すでに支払い済みの場合、ユーザーへ返金されます
返金申請	このAPIで返金リクエストを送信した後、すぐに入金されない場合は返金照会APIで進捗を確認できます
決済注文照会	順方向取引（消費/与信/与信完了）の取引結果を照会
返金注文照会	返金取引（消費取消/消費返金など）の取引結果を照会
取引結果通知	取引完了後、商店に取引結果を通知します

注文APIの主要パラメーター（クレジットカード決済関連）

完全なパラメーター定義は注文APIドキュメントをご参照ください。クレジットカード決済に直接関連するパラメーターは以下のとおりです：

パラメーター	必須	値 / 説明
pay_method_id	必須	固定値 CreditLinkPay（クレジットカード決済の総称）、カードブランドは指定しない
terminal_type	必須	WEB = PC決済センター、WAP = モバイル決済センター
os_type	WAP の場合は必須	ANDROID / IOS
merchant_order_no	必須	商店システム内部の注文番号、商店ごとに一意
price_currency	必須	ISO-4217の3桁通貨コード（例：JPY、CNY）
order_amount	必須	注文金額。JPYは小数なし、正の整数のみ
expires	必須	決済注文の有効期間（秒）、最大12時間
description	必須	商品説明、決済センターの「説明」欄に表示
notify_url	推奨	非同期決済結果通知の送信先URL
return_url	推奨	決済完了後にユーザーが戻る商店ページのURL
language	推奨	決済センターの表示言語：ja-JP / en-US / zh-CN
term_ip / longitude / latitude	推奨	リスク管理パラメーター。現在は任意ですが、将来のリスク管理要件に備えて事前に渡すことを推奨

注意事項

1. 決済方法の値：常に CreditLinkPay を使用してください。カードブランドは決済センターがBINから自動識別するため、ブランドごとに注文エントリーを分割する必要はありません（分割してはいけません）。
2. 有効期間の設定：expires は決済注文の有効期間（業務注文の有効期間ではありません）です。期限切れの未払い注文はクローズされるため、在庫保持戦略と合わせて適切に設定してください。
3. 金額の規範：JPY通貨は正の整数金額のみ許可されます。小数は注文失敗や金額エラーの原因になります。
4. 結果処理：非同期通知と能動照会の2チャネルで決済結果を確認してください。通知は署名検証を行い、冪等処理を実装してください。
5. 返金/取消：当日の取引は注文取消APIで取消できます。翌日以降や部分返金は返金申請APIを使用します。カードへの返金到着までの期間は発行銀行により異なります（通常1〜10営業日）。
6. セキュリティコンプライアンス：商店システムはカード番号・有効期限・セキュリティコードなどの機密データの保存・送信を禁止します。これらはすべてPayCloud決済センターが収集します。