返金 - Waffo Pancake

概要

Waffo Pancake は返金チケットシステムを採用しています。マーチャントはダッシュボードまたは API から返金を行い、各返金は定義されたライフサイクルを持つチケットとして作成されます。

ビジネスルール

これらのルールは API によって強制されており、上書きすることはできません。

単発商品は支払い後、マーチャントがいつでも返金できます（返金期限はありません）。返金額は注文金額以下、かつアカウントの現在の出金可能残高以下である必要があります。
サブスクリプションの各支払いも同じく返金チケットで返金できます。返金してもサブスクリプションはキャンセルされないため、以降の請求を止めるには別途サブスクリプションをキャンセルしてください。
一部返金は、チケット作成時にカスタム amount（表示形式の文字列、例：“15.00”）を指定することでサポートされます。

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

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

pending

返金チケットが作成され、審査待ち。

approved

返金が承認された。マーチャントが行った返金は送信後に自動承認され、購入者がポータルから行った申請はプラットフォームが審査します。

rejected

返金チケットが却下された。

processing

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

succeeded

返金が正常に完了。

failed

返金処理が失敗。

返金の反映時期と「processing」の意味。 カードの返金は購入者のカード発行会社が処理し、通常 3〜10 営業日（遅くとも 14 営業日）で反映されます。WeChat Pay の返金は即時に反映されます。チケットが processing の状態は決済プロバイダー／銀行側の処理段階を示しており、Waffo が別途社内の財務審査を行っているわけではありません。

返金チケットの作成

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

エンドポイント

POST /v1/actions/refund-ticket/create-ticket

認証： API Key

リクエストボディ

string

必須

返金対象の支払い ID（UUID v4）。

string

必須

返金をリクエストする理由の説明。

string

表示形式の文字列での返金金額（例：“15.00”）。全額返金の場合は省略します。

レスポンス

string

作成された返金チケットの一意な ID。

string

チケットの初期ステータス。作成時は常に pending。

string

表示形式の文字列での返金金額。

使用例

cURL の例は API Key 認証（Bearer トークンではなく 3 つの署名ヘッダー）を使います。X-Signature の計算方法は API Key 認証を参照してください。

curl -X POST https://api.waffo.ai/v1/actions/refund-ticket/create-ticket \
  -H "Content-Type: application/json" \
  -H "X-Merchant-Id: MER_xxx" \
  -H "X-Timestamp: 1705312200" \
  -H "X-Signature: BASE64_RSA_SHA256_SIGNATURE" \
  -d '{
    "paymentId": "550e8400-e29b-41d4-a716-446655440000",
    "reason": "Product not as described",
    "amount": "15.00"
  }'

マーチャント SDK（@waffo/pancake-ts）はこのエンドポイントをまだラップしていません。上の例のとおり、自分で署名して REST を呼び出してください。顧客トークンクライアント（client.customer(token)）の createRefundTicket() は現在ゲートウェイで 403 として拒否されるため、使用しないでください。

返金チケットの照会

GraphQL を使用して返金チケットデータを取得します。

query {
  refundTickets(storeId: "STORE_ID") {
    id
    paymentId
    storeId
    customerId
    reason
    status
    requestedAmount
    approvedAmount
    currency
    createdAt
    updatedAt
    resolvedAt
  }
}

フィールド	型	説明
`id`	string	返金チケット ID
`paymentId`	string	関連する支払い ID
`storeId`	string	支払いが属するストア
`customerId`	string	元の支払いを行った購入者
`reason`	string	返金の理由
`status`	string	現在のチケットステータス
`requestedAmount`	string	購入者がリクエストした金額（表示形式の文字列）
`approvedAmount`	string	承認された金額（リクエスト金額と異なる場合あり）
`currency`	string	ISO 4217 通貨コード
`createdAt`	string	ISO 8601 タイムスタンプ
`updatedAt`	string	ISO 8601 タイムスタンプ
`resolvedAt`	string	ISO 8601 タイムスタンプ（未解決の場合は null）

Webhook 通知

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

返金リクエストの削減

明確な商品説明

正確な説明により「期待と異なる」という返金リクエストを減らせます。

トライアル期間

購入前に試用してもらうことで、購入後の後悔を減らせます。

迅速なサポート対応

問題を迅速に解決し、返金リクエストに発展する前に対応します。

認識しやすい請求明細

顧客が課金を認識できる明確な請求明細を使用します。

はじめに

機能

マーチャント

ストア

マーチャント・オブ・レコード

返金

概要

ビジネスルール

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

pending

approved

rejected

processing

succeeded

failed

返金チケットの作成

エンドポイント

リクエストボディ

レスポンス

使用例

返金チケットの照会

Webhook 通知

返金リクエストの削減

​概要

​ビジネスルール

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

pending

approved

rejected

processing

succeeded

failed

​返金チケットの作成

​エンドポイント

​リクエストボディ

​レスポンス

​使用例

​返金チケットの照会

​Webhook 通知

​返金リクエストの削減

概要

ビジネスルール

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

返金チケットの作成

エンドポイント

リクエストボディ

レスポンス

使用例

返金チケットの照会

Webhook 通知

返金リクエストの削減