Web サービスエンドポイント


取引の払い戻しを要求する


1 回限りの請求またはサブスクリプション取引の払い戻しを要求します。


Advanced Commerce API 1.0+




URL


POST https://api.storekit.itunes.apple.com/advancedCommerce/v1/transaction/requestRefund/
{transactionId}


サンドボックス URL


POST https://api.storekit-sandbox.itunes.apple.com/advancedCommerce/v1/transaction/requestRefund/{transactionId}


パスパラメータ


transactionId
string		(必須)払い戻しを要求する取引 ID。


HTTP 本体


RequestRefund
Request		要求本文。
Content-Type: application/json

応答コード


200
RequestRefund
Response		OK
要求は成功しました。
Content-Type: application/json
400
(RepeatedRequest
ReferenceIdError |
NullRequestInfo
Error | InvalidApp
AccountTokenError
| NullRequest
ReferenceIDError |
InvalidRequest
ReferenceIDError |
InvalidConsistency
TokenError |
InvalidStorefront
Error | Mismatched
StorefrontError |
Mismatched
StorefrontError |
OperationNot
AllowedError |
MalformedPayload
Error | Simulate
RefundDeclineOnly
InSandboxError |
RefundAmount
WithoutCustomError
| NullRefund
RiskingError |
Invalid
RefundTypeError
| Invalid
RefundReasonError
| NegativeRefund
AmountError | Null
RefundAmountError
| NullRefundReason
Error | NullRefund
TypeError |
RemovalAllNot
AllowedError |
PendingRefundError
| ProratedOnly
LatestTransaction
Error | Partial
SimulateRefund
DeclineError)		不正な要求です
Content-Type: application/json
401許可されていません
認証ヘッダー内の JSON Web Token (JWT) が無効です。詳細については、あなたのサーバーからの API 要求の承認 をご覧ください。
403
(SubscriptionDoesNot
ExistError | SubscriptionNot
EligibleError | ProductNotOwned
Error |
InsufficientFunds
Error | Already
RefundedError | TransactionNot
RefundableError)		禁止されている
Content-Type: application/json
404
TransactionIdNotFound
Error 		見つからない
Content-Type: application/json
429
RateLimitExceeded
Error		要求がレート制限を超えました。詳細については、Advanced Commerce API のレート制限の特定 をご覧ください。
Content-Type: application/json
500
(GeneralInternalError | GeneralInternal
RetryableError)		内部サーバーエラー
サーバーエラーです。後で再度試して下さい。
Content-Type: application/json

以下で言及


あなたのサーバーからの API 要求の承認


Advanced Commerce API の変更履歴


Advanced Commerce API のレート制限の特定



議論


注意

取引の払い戻しを要求する エンドポイントを使用するには、あなたのメンバーシップアカウント所有者が Advanced Commerce API 補足契約に署名し、特定の資格要件を満たしていなければなりません。詳しくは、Advanced Commerce API をご覧ください。この契約の最新バージョンがまだ承認されていない場合、このエンドポイントを呼び出すことはあなたはできず、エラーが返されます。


サブスクリプションのキャンセル、サブスクリプションを取り消す、および 取引払い戻しの要求 API の使用例については、Advanced Commerce API 補足資料を参照してください。




以下も見よ


サーバーからの払い戻し要求


object RequestRefundRequest

取引の払い戻しを要求するための要求本文。


object RequestRefundResponse

取引払い戻し要求に対する応答本文。


object RequestRefundItem

アイテムの払い戻し要求に関する情報 (SKU、払い戻し金額、理由、型など)。














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ