メインコンテンツへスキップ

​
概要

Waffo Pancake は返金チケットシステムを採用しています。購入者は API またはカスタマーポータルを通じて返金をリクエストし、各リクエストは定義されたライフサイクルを持つチケットとして作成されます。マーチャントはダッシュボードからチケットを審査し、解決します。

​
ビジネスルール

これらのルールは API によって強制されており、上書きすることはできません。
  • 単発商品は支払いから 7 日以内に返金対象となります。
  • サブスクリプションは返金チケットシステムを使用しません。キャンセルは現在の請求期間の終了時に有効になります。
  • 一部返金は、チケット作成時にカスタム amount（最小通貨単位）を指定することでサポートされます。

​
返金チケットのステータス

すべての返金チケットは以下のライフサイクルを経ます：

pending

返金がリクエストされ、審査待ち。

approved

マーチャントにより返金が承認された。

rejected

返金リクエストが却下された。

processing

決済プロバイダーによる返金処理中。

succeeded

返金が正常に完了。

failed

返金処理が失敗。

​
返金チケットの作成

API Key 認証を使用して API を呼び出し、返金チケットを作成します。

​
エンドポイント

POST /v1/actions/refund-ticket/create-ticket
認証： API Key

​
リクエストボディ

​
paymentId
string
必須
返金対象の支払い ID（UUID v4）。
​
reason
string
必須
返金をリクエストする理由の説明。
​
amount
integer
最小通貨単位（例：セント）での返金金額。全額返金の場合は省略します。

​
レスポンス

​
ticketId
string
作成された返金チケットの一意な ID。
​
status
string
チケットの初期ステータス。作成時は常に pending。
​
requestedAmount
integer
最小通貨単位での返金金額。

​
使用例

curl -X POST https://waffo-pancake-auth-service.vercel.app/v1/actions/refund-ticket/create-ticket \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_TOKEN" \
  -d '{
    "paymentId": "550e8400-e29b-41d4-a716-446655440000",
    "reason": "Product not as described",
    "amount": 1500
  }'

​
返金チケットの照会

GraphQL を使用して返金チケットデータを取得します。 
query {
  refundTickets(storeId: "STORE_ID") {
    id
    paymentId
    storeId
    customerId
    reason
    status
    requestedAmount
    approvedAmount
    currency
    createdAt
    updatedAt
    resolvedAt
  }
}
フィールド型説明
idstring返金チケット ID
paymentIdstring関連する支払い ID
storeIdstring支払いが属するストア
customerIdstring返金をリクエストした購入者
reasonstring購入者が提供した理由
statusstring現在のチケットステータス
requestedAmountinteger購入者がリクエストした金額
approvedAmountinteger承認された金額（リクエスト金額と異なる場合あり）
currencystringISO 4217 通貨コード
createdAtstringISO 8601 タイムスタンプ
updatedAtstringISO 8601 タイムスタンプ
resolvedAtstringISO 8601 タイムスタンプ（未解決の場合は null）

​
Webhook 通知

返金チケットイベントが発生した際に通知を受信するよう Webhook を設定できます。設定手順は Webhooks ガイドをご覧ください。

​
返金リクエストの削減

正確な説明により「期待と異なる」という返金リクエストを減らせます。
購入前に試用してもらうことで、購入後の後悔を減らせます。
問題を迅速に解決し、返金リクエストに発展する前に対応します。
顧客が課金を認識できる明確な請求明細を使用します。