リンクされたアカウント取得

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

認証ステータス、機能、アカウント情報を含む、特定のリンクされたアカウントの詳細を取得します。

---

リクエストパラメータ

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

▼

`id`STRING(required)

リンクされたアカウントID（例：lacct_test_...）。URLパスで提供されます。

Example:"lacct_test_5xuy4w91xqz7d1w9u0t"

---

レスポンス

200

取引成功

リンクされたアカウントが正常に取得されました。すべての属性を含む完全なリンクされたアカウントオブジェクトを返します。

返されるリンクされたアカウントの属性:

• id - リンクされたアカウント識別子
• object - 常に "linked_account"
• livemode - 本番アカウントかテストアカウントか
• status - アカウントステータス（pending、verified、suspended、rejected）
• type - アカウントタイプ（individual、business）
• name - アカウント保有者名または事業者名
• email - 連絡先メールアドレス
• capabilities - 有効な機能（card_payments、transfers、refunds）
• metadata - カスタムメタデータ
• created_at - アカウント作成タイムスタンプ

400

不正なリクエスト

リクエストの検証に失敗しました。詳細はエラーメッセージを確認してください。

一般的な原因:

• リンクされたアカウントID形式が不正
• 無効なリクエストパラメータ

401

認証エラー

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

一般的な原因:

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

404

見つかりません

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

一般的な原因:

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

5xx

サーバーエラー

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

対処方法:

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

---

コードサンプル

cURL

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

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

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

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

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

Node.js

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

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

PHP

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

$linked_account = OmiseLinkedAccount::retrieve('lacct_test_5xuy4w91xqz7d1w9u0t');

Java

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

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

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

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

Go

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

linkedAccount, _ := client.LinkedAccounts().Get("lacct_test_5xuy4w91xqz7d1w9u0t")

---

🔑API認証情報

▼

試してみる

必須 - 1項目

▼

id(必須)

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