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

ユーザーの削除

ユーザーアクセストークンのネットワーク範囲内で、認証済みユーザーを削除します。

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

ヘッダー#

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

パスパラメーター#

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

リクエスト本文#

0
このエンドポイントはリクエスト本文を受け付けません。

レスポンス#

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

ユーザーを削除する前に#

  • 顧客のユーザーアクセストークンは、次の手順で取得します: 認証フロー.
  • パスのユーザーIDには、認証済み顧客のUUIDを指定します。顧客は自分自身のユーザーのみ削除できます。
  • 顧客が、そのトークンに関連付けられたネットワークからアカウントを削除する意思を確認します。

削除の範囲を理解する#

ネットワークに限定されたトークンの場合、削除操作はそのネットワーク内のユーザーの所属と住所を削除し、同じネットワーク内のカードの削除を要求します。すべてのDEUNAネットワークからの削除を意味するものではありません。DEUNA全体を対象とするアカウントトークンの場合は、アカウントとネットワークへの所属も削除します。削除が成功すると、ユーザーの有効なセッションも削除されます。

この操作を、すべての過去の決済記録やすべての個人データが消去されたという確認として扱わないでください。アカウントの閉鎖フローを構築する前に、必要なアカウントとデータの削除範囲をDEUNAのTechnical Account Managerに確認してください。

削除リクエストを送信する#

テストには以下のサンドボックスのベースURLを使用し、本番環境には次を使用します: https://api.deuna.io 。顧客のBearerトークンをAuthorizationヘッダーで送信します。このエンドポイントにクエリパラメーターやリクエスト本文はありません。

curl --request DELETE \
  --url 'https://api.sandbox.deuna.io/users/USER_ID' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN'

結果を確認する#

リクエストが成功すると、空の本文とともにHTTP 204 No Contentが返されます。顧客のローカルセッションを消去し、サインアウトした画面に戻します。レスポンスをJSONとして解析したり、この操作の確認のために決済Webhookを待ったりしないでください。

エラーと結果が不明な場合に対処する#

HTTP 400は、パスのユーザーとトークンのユーザーが異なる場合に返されることがあります。HTTP 401はユーザートークンでリクエストを承認できないことを、HTTP 404は要求したレコードが見つからないことを意味します。再試行する前にリクエストまたは認証を修正してください。

削除の一部が反映された後に、タイムアウトやサーバーエラーが発生することがあります。削除後のセッションのクリーンアップ中にHTTP 503が発生することもあります。再試行で同じレスポンスが返ると想定したり、リクエストを自動的に繰り返したりしないでください。結果が不明な場合は、DEUNAサポートにアカウントの状態を確認してください。この操作には冪等性キーの契約は定義されていません。

参照 レスポンスコードとトラブルシューティング で、一般的なエラー処理を確認してください。