メインコンテンツへスキップ

カードをデフォルトに設定する

保存済みカードを認証済みユーザーのデフォルト支払いカードに設定するか、デフォルト状態を解除します。

ドメイン
Cards and vault
所有サービス
Payments
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン

ヘッダー#

2
Authorizationstring必須
この操作で API Gateway が受け入れる、または転送する値です。
X-Merchant-IDstringオプション
この操作で API Gateway が受け入れる、または転送する値です。

パスパラメーター#

2
user_idstring必須
エンドポイントパスの `user_id` に代入される値です。
card_idstring必須
エンドポイントパスの `card_id` に代入される値です。

リクエスト本文#

1
is_defaultbooleanオプション
所有サービスが受け入れる JSON ペイロードです。リクエストパネルで本文を編集してプレビューできます。
例 true

レスポンス#

4
200リクエストは受け付けられたか完了しました。業務結果は応答ペイロードを確認してください。
401認証情報または呼び出し元のコンテキストが無効です。
403認証情報または呼び出し元のコンテキストが無効です。
404要求されたリソースまたはルートが見つかりません。

デフォルトカードの動作#

送信 {"is_default": true} すると、選択した保存済みカードがユーザーのデフォルトになります。DEUNA は同じユーザーの他のカードからデフォルト状態を解除するため、デフォルトカードは最大1枚です。

リクエスト本文は省略できます。省略した場合は、次を送信した場合と同じです。 {"is_default": true}送信 {"is_default": false} すると、他のカードを変更せずに、選択したカードのデフォルト状態を解除します。

エンドポイントを呼び出す前に#

  • 顧客を認証し、ユーザーアクセストークンを Authorization header.
  • 設定 user_id に認証済みユーザーの UUID を設定します。
  • 次によって返された card_id を使用します: 保存済みカードを一覧表示する。カードは認証済みユーザーに属している必要があります。

結果を確認する#

リクエストが成功すると、更新されたカードとともに 200 OK が返されます。カードの is_default フィールドがリクエストした値と一致することを確認します。保存済みカードを一覧表示し、他のカードがデフォルトになっていないことも確認できます。

エンドポイントは、 404 Not Found 認証済みユーザーに選択したカードが存在しない場合に返します。再試行する前に、無効な UUID または不正な JSON を修正してください。同じ is_default 値でリクエストを繰り返しても、カードの状態は変わりません。