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

CVVの更新

認証済みユーザーが所有する保存済みカードに、新しいカード確認値を送信します。

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

ヘッダー#

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

パスパラメーター#

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

リクエスト本文#

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

レスポンス#

7
204リクエストは受け付けられたか完了しました。業務結果は応答ペイロードを確認してください。
400リクエストの形式が正しくないか、検証に失敗しました。
401認証情報または呼び出し元のコンテキストが無効です。
403認証情報または呼び出し元のコンテキストが無効です。
404要求されたリソースまたはルートが見つかりません。
422リクエストの形式が正しくないか、検証に失敗しました。
500サービスはリクエストを完了できませんでした。安全または冪等な操作の場合にのみ再試行してください。

CVVを更新する前に#

  • 顧客を認証し、そのユーザーアクセストークンをAuthorizationヘッダーで送信します。
  • パスのユーザーIDには認証済み顧客のUUIDを指定し、次の操作で返されたカードIDを使用します: 保存済みカードを一覧表示する.
  • 保存済みカードのカード確認値(CVV)を顧客から取得します。カードはその顧客が所有し、有効な有効期限が設定されている必要があります。

更新リクエストを送信する#

テストには以下のサンドボックスのベースURLを使用し、本番環境には次を使用します: https://api.deuna.io 。必須のcard_cvv文字列に3桁または4桁のCVVを指定したJSONオブジェクトを送信します。クエリパラメーターはありません。この操作は既存のカードを更新します。カードの作成や顧客への請求は行いません。

curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/USER_ID/cards/CARD_ID/refresh-cvv' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"card_cvv":"123"}'

結果を確認する#

リクエストが成功すると、空の本文とともにHTTP 204 No Contentが返されます。JSONとして解析しないでください。レスポンスはCVVの更新完了を確認するものであり、決済の完了を確認したり、カードのレスポンスでCVVを公開したりするものではありません。この操作の確認に決済Webhookは不要です。

次の手順に進みます: 決済リクエスト 。顧客の支払い準備ができたら実行してください。

エラーと再試行に対処する#

HTTP 400は無効な識別子、不正なJSON、またはCVVの欠落や無効な値を示します。HTTP 401は無効なユーザー認証を示します。HTTP 404は認証済みユーザーの保存済みカードが見つからないことを意味します。HTTP 422は期限切れのカード、無効な有効期限データ、またはCVVを更新できないカードを示します。再試行する前に入力を修正するか、別のカードを選択してください。

タイムアウトやサーバーエラーで結果が不明な場合は、CVVを自動的に再送信しないでください。この操作には冪等性キーの契約は定義されていません。有効なフロー内で顧客が再試行できるようにし、必要に応じてCVVを再度取得してください。次を参照してください: レスポンスコードとトラブルシューティング.