メインコンテンツへスキップ
POST /api/actions/refund-ticket/resubmit-ticket 認証： マーチャント API Key（サーバー間）。 Resubmit は 返金チケットの作成 のリクエスト構造を再利用し、修正対象のチケットを識別する ticketId を追加します。元の paymentId は既存のチケットにバインドされており、変更できません。

​
リクエストボディ

フィールド型必須説明
ticketIdstring必須修正対象の返金チケット Short ID（例：TKT_3bVzrkD0FJjFdZNLk8Ualx）
reasonstring必須修正後の理由
requestedAmount.amountstring必須修正後の返金額（表示形式、> 0 かつ ≤ payment.amount）
requestedAmount.currencystring必須ISO 4217 コード、支払い通貨と一致する必要あり
create 時に書き込まれた refundTicketMerchantExternalId は resubmit 全体で 変更不可 — チケット作成後は変更できません。

​
成功レスポンス (200)

{
  "data": {
    "ticket": {
      "id": "TKT_3bVzrkD0FJjFdZNLk8Ualx",
      "status": "pending",
      "subjectId": "PAY_6eYCunG3IMmIgcQOnaXdoA",
      "versionNumber": 2,
      "refundTicketMerchantExternalId": "REF-2026-00891"
    }
  }
}
新しいチケットバージョンが追加され、versionNumber がインクリメントします。チケットはレビュー待ちに再投入されます（buyer 発起は pending、merchant 発起は processing）。

​
エラーレスポンス

リトライポリシー：4xx は一切リトライしない — リクエストを修正してから再送信。5xx は指数バックオフでリトライ（5s 開始、最大 3 回）。
ステータスerrors[0].message意味推奨処理
400Missing required field: ticketIdticketId が指定されていないticketId を追加して再送信
400Expected format: TKT_xxx, got "..."ticketId Short ID のデコード失敗ticketId フォーマットを修正して再送信
400Invalid requestedAmount.amount format金額文字列が解析できない表示形式（"10.50" など）を使用
401UnauthorizedAPI Key 署名が無効認証ヘッダーを確認
403Submitter is not the original ticket owner呼び出し元がチケット作成者ではない元の提出者のみが resubmit 可能
404Ticket not foundチケットが存在しないか、呼び出し元に属していないticketId を確認
409Ticket status is X, only rejected/failed can be resubmittedチケットが resubmit 可能な状態ではないrejected / failed を待つか、新規チケット作成
409Requested amount exceeds payment amount修正後金額が payment.amount を超過金額を修正
500Internal server errorサーバ側の予期しない障害指数バックオフでリトライ（5s 開始、最大 3 回）