リンクされたアカウント削除

DELETEhttps://api.omise.co/linked_accounts/:id

プラットフォームからリンクされたアカウントを完全に削除します。この操作は取り消せず、リンクされたアカウントは支払いに使用できなくなります。

---

リクエストパラメータ

必須 - 1フィールド必須パラメータ

▼

`id`STRING(required)

削除するLinked Account ID（lacct_で始まる有効なリンクされたアカウントIDである必要があります）。

Example:"lacct_test_5xuy4w91xqz7d1w9u0t"

Constraints:有効なリンクされたアカウントIDである必要があります

---

レスポンス

200

リンクされたアカウントが正常に削除されました

リンクされたアカウントが完全に削除されました。アカウントは支払いに使用できなくなります。

削除の影響:

• リンクされたアカウントのステータスが "deleted" に設定されます
• アカウントは支払いを処理できなくなります
• 登録URIは無効になります
• 過去の取引は記録に残ります
• 削除は元に戻せません

400

不正なリクエスト

リンクされたアカウントIDの形式が無効です。

一般的な原因:

• リンクされたアカウントID形式が無効
• IDがlacct_で始まっていない

401

認証エラー

認証に失敗しました。無効または不足しているAPIキー。

一般的な原因:

• Authorizationヘッダーがない
• 無効なシークレットキー
• シークレットキーの代わりにパブリックキーを使用している
• 不正なHTTP Basic Auth形式

404

見つかりません

リンクされたアカウントが見つかりません。

一般的な原因:

• リンクされたアカウントIDが存在しない
• リンクされたアカウントがすでに削除されている
• リンクされたアカウントがプラットフォームに属していない
• テストモードと本番モードのIDが混在している

5xx

サーバーエラー

サーバー側でエラーが発生しました。まれですが、適切に処理する必要があります。

対処方法:

• 指数バックオフでリクエストをリトライ
• status.omise.coでサービスインシデントを確認
• 詳細なガイダンスについてはエラー処理を参照

---

コードサンプル

cURL

curl https://api.omise.co/linked_accounts/lacct_test_5xuy4w91xqz7d1w9u0t \
  -X DELETE \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

linked_account = Omise::LinkedAccount.destroy('lacct_test_5xuy4w91xqz7d1w9u0t')

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

linked_account = omise.LinkedAccount.retrieve('lacct_test_5xuy4w91xqz7d1w9u0t')
linked_account.destroy()

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const linkedAccount = await omise.linkedAccounts.destroy('lacct_test_5xuy4w91xqz7d1w9u0t');

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$linked_account = OmiseLinkedAccount::retrieve('lacct_test_5xuy4w91xqz7d1w9u0t');
$linked_account->destroy();

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

LinkedAccount linkedAccount = client.linkedAccounts().destroy("lacct_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var linkedAccount = await client.LinkedAccounts.Destroy("lacct_test_5xuy4w91xqz7d1w9u0t");

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "skey_test_5xuy4w91xqz7d1w9u0t",
)

deleted, _ := client.LinkedAccounts().Destroy("lacct_test_5xuy4w91xqz7d1w9u0t")

---

エラーと結果コード

一般的なエラーコード

コード	説明	解決策
bad_request	リンクされたアカウントID形式が無効	ID形式を確認
authentication_failure	無効なAPIキー	シークレットキーが正しいか確認
not_found	リンクされたアカウントが見つからない	リンクされたアカウントIDが存在するか確認

削除レスポンス

フィールド	説明
object	オブジェクトタイプ（常に "linked_account"）
id	削除されたリンクされたアカウントのID
livemode	本番モードのリンクされたアカウントかどうか
status	ステータス（削除成功時は常に "deleted"）
deleted	ブーリアンフラグ（削除成功時は常にtrue）

---

🔑API認証情報

▼

試してみる

必須 - 1項目

▼

id(必須)

あなたのIP: ...読み込み中...