バージョン: 最新版

異議を承認

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

顧客の主張を認めて異議を承認します。このアクションは取り消し不可能で、即座に異議をステータス"lost"でクローズします。異議金額は顧客に返還されます。

リクエストパラメータ

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

▼

`id`STRING(required)

承認する異議ID（パスパラメータ）。異議のステータスは"open"または"pending"である必要があります。

Example:"dspt_test_5xuy4w91xqz7d1w9u0t"

レスポンス

200

異議を承認

異議が正常に承認されました。異議のステータスは"lost"になり、プロセスが完了しました。

承認後：

status - "lost"に変更
closed_at - 現在のタイムスタンプに設定
異議金額は顧客に返還される
このアクションは取り消し不可能
この異議に対するこれ以上の更新はできない

400

不正なリクエスト

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

一般的な原因：

無効な異議ID形式
異議IDの欠落

401

認証エラー

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

一般的な原因：

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

404

見つかりません

異議が見つかりません。

一般的な原因：

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

422

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

異議を承認できません。

一般的な原因：

異議がすでにクローズ済み（wonまたはlost）
異議のステータスが承認を許可していない
承認期限が過ぎている

5xx

サーバーエラー

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

対処方法：

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

コードサンプル

curl https://api.omise.co/disputes/dspt_test_5xuy4w91xqz7d1w9u0t/accept \
  -X POST \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = Omise::Dispute.accept('dspt_test_5xuy4w91xqz7d1w9u0t')

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = omise.Dispute.accept('dspt_test_5xuy4w91xqz7d1w9u0t')

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

const dispute = await omise.disputes.accept('dspt_test_5xuy4w91xqz7d1w9u0t');

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

$dispute = OmiseDispute::accept('dspt_test_5xuy4w91xqz7d1w9u0t');

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

Dispute dispute = client.disputes().accept("dspt_test_5xuy4w91xqz7d1w9u0t");

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var dispute = await client.Disputes.Accept("dspt_test_5xuy4w91xqz7d1w9u0t");

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

dispute, _ := client.AcceptDispute("dspt_test_5xuy4w91xqz7d1w9u0t")

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

一般的なエラーコード

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

ステータスの遷移

承認前	承認後	結果
`open`	`lost`	異議を承認、資金が顧客に返還
`pending`	`lost`	異議を承認、資金が顧客に返還