pay

Documentation

Index

• Constants
• type GooglePay
  • func NewGooglePay(opts ...Option) *GooglePay
  • func (gp *GooglePay) ConfirmConsumable(conf *PurchaseConfig) error
  • func (gp *GooglePay) ConfirmNonConsumable(conf *PurchaseConfig) error
  • func (gp *GooglePay) GetConsumable(purchaseConf *PurchaseConfig) (*ProductPurchase, error)
  • func (gp *GooglePay) GetNonConsumable(conf *PurchaseConfig) (*ProductPurchase, error)
  • func (gp *GooglePay) Provide(ctx context.Context) any
  • func (gp *GooglePay) VerifySubscriptionsPurchase(conf *PurchaseConfig) error
• type Option
  • func WithServerAccountFile(file string) Option
• type Options
• type ProductPurchase
• type PurchaseConfig

Constants

const (
	SubscriptionStateUnspecified             = "SUBSCRIPTION_STATE_UNSPECIFIED"               // 未指定的订阅状态
	SubscriptionStatePending                 = "SUBSCRIPTION_STATE_PENDING"                   // 订阅已创建，但在注册期间正在等待付款。在此状态下，所有商品都在等待付款。
	SubscriptionStateActive                  = "SUBSCRIPTION_STATE_ACTIVE"                    // 订阅有效。- (1) 如果订阅是自动续订型方案，则至少有一个项目处于 autoRenewEnabled 且未过期。- (2) 如果订阅是预付费方案，则至少有一个商品未过期。
	SubscriptionStatePaused                  = "SUBSCRIPTION_STATE_PAUSED"                    // 订阅已暂停。仅当订阅为自动续订型方案时，状态才可用。在此状态下，所有项目都处于暂停状态。
	SubscriptionStateInGracePeriod           = "SUBSCRIPTION_STATE_IN_GRACE_PERIOD"           // 订阅处于宽限期。仅当订阅为自动续订型方案时，状态才可用。在此状态下，所有项都处于宽限期。
	SubscriptionStateOnHold                  = "SUBSCRIPTION_STATE_ON_HOLD"                   // 订阅处于暂停状态（已暂停）。仅当订阅为自动续订型方案时，状态才可用。在此状态下，所有项目均处于保全状态。
	SubscriptionStateCancelled               = "SUBSCRIPTION_STATE_CANCELED"                  // 订阅已取消，但尚未到期。仅当订阅为自动续订型方案时，状态才可用。所有项的 autoRenewEnabled 都设为了 false。
	SubscriptionStateExpired                 = "SUBSCRIPTION_STATE_EXPIRED"                   // 订阅已过期。所有商品的 expiryTime 都是过去的时间。
	SubscriptionStatePendingPurchaseCanceled = "SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED" // 待处理的订阅交易已取消。如果此待处理的购买交易是针对现有订阅，请使用 linkedPurchaseToken 获取该订阅的当前状态。
)

const (
	AcknowledgementStateUnspecified  = "ACKNOWLEDGEMENT_STATE_UNSPECIFIED"  // 未指定的确认状态。
	AcknowledgementStatePending      = "ACKNOWLEDGEMENT_STATE_PENDING"      // 订阅尚未确认。
	AcknowledgementStateAcknowledged = "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED" // 订阅已确认。
)

Types

type GooglePay

type GooglePay struct {
	// contains filtered or unexported fields
}

func NewGooglePay

func NewGooglePay(opts ...Option) *GooglePay

func (*GooglePay) ConfirmConsumable

func (gp *GooglePay) ConfirmConsumable(conf *PurchaseConfig) error

ConfirmConsumable 确认消耗型商品

func (*GooglePay) ConfirmNonConsumable

func (gp *GooglePay) ConfirmNonConsumable(conf *PurchaseConfig) error

func (*GooglePay) GetConsumable

func (gp *GooglePay) GetConsumable(purchaseConf *PurchaseConfig) (*ProductPurchase, error)

GetConsumable 获取内购消耗型商品

func (*GooglePay) GetNonConsumable

func (gp *GooglePay) GetNonConsumable(conf *PurchaseConfig) (*ProductPurchase, error)

GetNonConsumable 获取非消耗型商品

func (*GooglePay) Provide

func (gp *GooglePay) Provide(ctx context.Context) any

func (*GooglePay) VerifySubscriptionsPurchase

func (gp *GooglePay) VerifySubscriptionsPurchase(conf *PurchaseConfig) error

VerifySubscriptionsPurchase 确认内购订阅商品

type Option

type Option func(*Options)

func WithServerAccountFile

func WithServerAccountFile(file string) Option

type Options

type Options struct {
	ServerAccountFile string
}

type ProductPurchase

type ProductPurchase struct {
	/* 此种类表示 androidpublisher 服务中的 inappPurchase 对象。 */
	Kind string `json:"kind"`
	/* 购买商品的时间，以从公元纪年（1970 年 1 月 1 日）开始计算的毫秒数表示。 */
	PurchaseTimeMillis int64 `json:"purchaseTimeMillis"`
	/* 订单的购买状态。可能的值包括：0。已购买 1.已取消 2.待处理 */
	PurchaseState int64 `json:"purchaseState"`
	/* 应用内商品的使用状态。可能的值包括：0。还将被消耗 1.已使用 */
	ConsumptionState int64 `json:"consumptionState"`
	/* 开发者指定的字符串，其中包含有关订单的补充信息。*/
	DeveloperPayload string `json:"developerPayload"`
	/* 与应用内商品的购买相关联的订单 ID。 */
	OrderId string `json:"orderId"`
	/* 应用内商品的购买类型。仅当此次购买并非通过标准应用内购买结算流程进行时，才会设置此字段。
	可能的值包括：0。测试（即通过许可测试账号购买）1.促销（即使用促销代码购买）。不包括 Play Points 购买交易。2. 激励广告（即通过观看视频广告而不是付费观看） */
	PurchaseType int64 `json:"purchaseType"`
	/* 应用内商品的确认状态。可能的值包括：0。尚未确认 1.已确认 */
	AcknowledgementState int64 `json:"acknowledgementState"`
	/* 系统为标识此次购买交易而生成的购买令牌。可能不存在。 */
	PurchaseToken string `json:"purchaseToken"`
	/* 应用内商品 SKU。可能不存在。*/
	ProductId string `json:"productId"`
	/* 与应用内商品的购买相关联的数量。如果不存在，则数量为 1。 */
	Quantity int64 `json:"quantity"`
	/* 混淆版本的 ID，与您应用中的用户账号唯一关联。
	仅当在购买时使用 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid
	指定时才存在。 */
	ObfuscatedExternalAccountId string `json:"obfuscatedExternalAccountId"`
	/* ID 的混淆版本，与应用中的用户个人资料唯一关联。仅当在购买时使用 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid 指定时才存在。 */
	ObfuscatedExternalProfileId string `json:"obfuscatedExternalProfileId"`
	/* 用户授予产品时的 ISO 3166-1 alpha-2 结算地区代码。 */
	RegionCode string `json:"regionCode"`
	/* 符合退款条件的数量，即尚未退款的数量。该值反映的是基于数量的部分退款和全额退款。 */
	RefundableQuantity int64 `json:"refundableQuantity"`
}

ProductPurchase 资源指明了用户的应用内商品购买交易的状态。 有关详细信息，请参阅 androidpublisher.purchases.products API 文档。 https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.products?hl=zh-cn#ProductPurchase

type PurchaseConfig

type PurchaseConfig struct {
	/* GooglePlay 包名 */
	PackageName string `json:"packageName"`
	/* GooglePlay 商品 ID */
	ProductID string `json:"productId"`
	/* 内购商品购买的 token */
	PurchaseToken string `json:"purchaseToken"`
}