Steamworks 문서
게임 내 반복 청구

개요

참고: 이 문서는 게임 내 구매 문서에 대한 보충 자료입니다. 여기에서 말하는 API는 게임 내 구매 API의 연장선입니다. Steam 상점에서 시작된 반복 구독에 대한 내용을 찾으시는 경우, 반복 구독 문서에 있는 정보를 참고하세요.

Steam 사용자를 위한 반복 결제를 생성하려면 먼저 해당 고객과 함께 결제 조건을 설명하는 청구 동의서를 작성해야 합니다. 사용자는 청구 절차가 시작되기 전에 해당 조건에 동의해야 합니다. Payment processing can be handled by the game's own billing system which communicates with the Steam backend for processing of the actual payment.

Payment results can be retrieved through the microtransaction API either by querying status on individual users or by parsing the settlement report which will show all payments for all users.

청구 동의서 설정

Use the ISteamMicroTxn/InitTxn Web API to define the recurring billing agreement. The agreement is created in the same fashion as other in-game item sales on Steam but requires additional data to fully define it. Establishing the agreement can be done as a stand-alone sales event or in a shopping cart with other in-game items that a user has elected to purchase. If the transaction is accepted by Steam, the user will be notified to authorize the agreement and the API will return a unique 64-bit billing agreement ID in the response. If an error is returned then the problem will need to be corrected and a new request submitted. Once approved, you should use the ISteamMicroTxn/FinalizeTxn Web API to complete the agreement.

The game's billing system initiates the recurring payment. This allows for more flexibility in the payment amount and the time of processing. For this, the game's billing server will use the ISteamMicroTxn/ProcessAgreement API to initiate a payment and also specify the amount. Use this for cases where you may want to adjust the payment amount over time or issue credit.

A user may only have one active billing agreement per game. You may create a new billing agreement for a user at any time, but all previous billing agreements will be disabled upon completing a ISteamMicroTxn/FinalizeTxn call. Each billing agreement will be given a unique 64-bit ID that you can use to reference it, but only the most recent agreement will be allowed to process payment.

Users can elect to cancel an agreement at any time from within their Steam account settings. Notification of cancellations will be done through the ISteamMicroTxn/GetReport Web API.

Additional Web APIs for recurring payments are:

상태 수신

Payment status for billing agreements can be retrieved by these two Web APIs:
  • ISteamMicroTxn/GetUserAgreementInfo - This can be used to retrieve detailed information about all agreements for a user that are applicable to your game including last payment made and time of next payment.
  • ISteamMicroTxn/GetReport – This API shows all transactions associated with your game including those produced by billing agreements. Additionally, since users can cancel and renew subscriptions from within their Steam account, the game can receive notification of those actions through this API.