カード登録/更新
POST/payment/SaveCard.json
指定した会員にカード情報を登録します。また、登録連番を指定することで保有情報の更新を行うことも可能です。
なお、登録/更新を行う際には、サイトに設定されたショップIDを使用してカード会社と通信を行いカード情報が有効であるかを確認し有効な情報だけを保持します。
決済完了後にカード情報を更新した場合は、決済時のカード情報は取得できなくなります。
登録方法を選択し、必要なパラメータを設定してください。
どちらも指定した場合、トークンが優先されます。
カード番号を利用して登録する場合
カード番号の取り扱いが許可された加盟店様のみ利用可能です。
トークンを利用して登録する場合
トークン発行後、呼び出してください。
カード登録連番は、指定したモードにより返却される内容が異なります。
また、登録連番を指定せずに物理モードでカード登録/更新を行った場合は、論理モードと異なり以下のような動作をしますのでご注意ください。
-
これから登録するカード番号と同一のカード番号が未登録の場合
新規として登録され、新しい登録連番が返却されます。 -
これから登録するカード番号と同一のカード番号が登録済みの場合
更新として認識され、カード番号以外の情報は更新します。該当した登録連番が返却されます。
なお、同一カード番号が登録済みの場合であっても、削除済みの場合は更新の対象外となります。
削除済みのカード情報を更新した場合、削除フラグが解除されます。
(有効なカードとなります。)
Request
Responses
- 200
- 400
- 500
- 502
カード登録/更新に成功
カード属性照会APIの契約がある場合、弊社が保有する情報を元にカード属性情報を返却します。
入力パラメータエラー、加盟店設定エラー
※返却されるエラーコードはエラーコード表をご確認ください。
システムエラー
※返却されるエラーコードはエラーコード表をご確認ください。
決済処理エラー
※返却されるエラーコードはエラーコード表をご確認ください。