異議をクローズ

POSThttps://api.omise.co/disputes/:id/close

解決後に異議をクローズします。このエンドポイントは、防御が成功した場合または審査プロセスが完了した後に解決された異議を確定します。

---

リクエストパラメータ

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

▼

`id`STRING(required)

クローズする異議ID（パスパラメータ）。異議はクローズを許可する状態である必要があります。

Example:"dspt_test_5xuy4w91xqz7d1w9u0t"

追加 - 1フィールド追加パラメータ

▼

---

レスポンス

200

異議をクローズ

異議が正常にクローズされました。異議は確定し、これ以上のアクションは実行できません。

クローズ後：

• status - 最終ステータス（wonまたはlost）に設定
• closed_at - 現在のタイムスタンプに設定
• 勝訴の場合：異議金額は加盟店に保持される
• 敗訴の場合：異議金額は顧客に返還される
• この異議に対するこれ以上の更新はできない

400

不正なリクエスト

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

一般的な原因：

• 無効な異議ID形式
• 無効なステータス値
• 異議IDの欠落

401

認証エラー

認証に失敗しました。APIキーが無効または欠落しています。

一般的な原因：

• Authorizationヘッダーの欠落
• 無効なシークレットキー
• シークレットキーの代わりにパブリックキーを使用
• 誤ったHTTP Basic Auth形式

404

見つかりません

異議が見つかりません。

一般的な原因：

• 異議IDが正しくない
• 異議が別のアカウントに属している
• IDのタイプミスまたはフォーマットエラー

422

処理不可能なエンティティ

異議をクローズできません。

一般的な原因：

• 異議がすでにクローズ済み
• 異議のステータスがクローズを許可していない
• 異議がまだ審査中で手動でクローズできない

5xx

サーバーエラー

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

対処方法：

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

---

コードサンプル

cURL

curl https://api.omise.co/disputes/dspt_test_5xuy4w91xqz7d1w9u0t/close \
  -X POST \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "status=won"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = Omise::Dispute.close('dspt_test_5xuy4w91xqz7d1w9u0t', {
  status: 'won'
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = omise.Dispute.close('dspt_test_5xuy4w91xqz7d1w9u0t', status='won')

Node.js

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

const dispute = await omise.disputes.close('dspt_test_5xuy4w91xqz7d1w9u0t', {
  status: 'won'
});

PHP

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

$dispute = OmiseDispute::close('dspt_test_5xuy4w91xqz7d1w9u0t', [
    'status' => 'won'
]);

Java

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

Dispute dispute = client.disputes().close("dspt_test_5xuy4w91xqz7d1w9u0t")
    .status("won")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var dispute = await client.Disputes.Close("dspt_test_5xuy4w91xqz7d1w9u0t", new CloseDisputeRequest
{
    Status = "won"
});

Go

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

dispute, _ := client.CloseDispute("dspt_test_5xuy4w91xqz7d1w9u0t", &operations.CloseDispute{
    Status: "won",
})

---

エラーコードと結果コード

一般的なエラーコード

コード	説明	解決方法
authentication_failure	無効なAPIキー	シークレットキーが正しいことを確認
not_found	異議が見つからない	異議IDが正しいことを確認
dispute_already_closed	異議がすでにクローズ済み	すでにクローズ済みの異議をクローズできない
invalid_dispute_status	異議のステータスが無効	異議はクローズ可能な状態である必要がある

最終ステータス値

ステータス	説明	財務的影響
won	加盟店が異議に勝訴	資金が加盟店に保持される
lost	加盟店が異議に敗訴	資金が顧客に返還される

異議解決のタイムライン

段階	説明
Open	異議が作成、加盟店の回答待ち
Pending	回答が提出、銀行審査中
Closed (Won/Lost)	最終決定が下された

---

🔑API認証情報

▼

試してみる

必須 - 1項目

▼

id(必須)

追加 - 1項目

▼

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