payments

type Callback struct {
	Secret string
	// contains filtered or unexported fields
}

type Error struct {
	// Numerical code error
	Code int `json:"error_code"`

	// Error description in easy-to-read format
	// (required for error_code >= 100).
	Msg string `json:"error_msg,omitempty"`

	// Error severity. Possible values are:
	//
	// true — if a notification with identical parameters is passed
	// repeatedly, the same error will occur. For example, the indicated
	// product does not exist. The notification will not be resent as the user
	// will receive an error.
	//
	// false — if the error is temporary, a notification may be processed
	// later. For example, a temporary error in posting to the database.
	// The notification will be sent after some time and the user will wait
	// for the response.
	Critical bool `json:"critical"`
}

type GetItemRequest struct {
	Notification

	// The recipient’s ID.
	ReceiverID int `schema:"receiver_id,required"`

	// The ID of the order.
	OrderID int `schema:"order_id,required"`

	// User language as language_country.
	Lang string `schema:"lang,required"`

	// Product name passed to the purchase dialog box.
	Item string `schema:"item,required"`
}

type GetItemResponse struct {
	// product name, max 48 characters
	//
	// Required parameter
	Title string `json:"title"`

	// URL of product image on the developer's server
	PhotoURL string `json:"photo_url,omitempty"`

	// product price, in votes
	//
	// Required parameter
	Price int `json:"price"`

	// the size of the discount on the goods in the votes. Should be within
	// 1 to 1000 votes and less than the price of goods.
	Discount int `json:"discount,omitempty"`

	// product ID in the application
	ItemID string `json:"item_id,omitempty"`

	// allows product caching for {Expiration} seconds. Allowed
	// range from 600 to 604800 seconds.
	//
	// Warning! In the absence of the parameter is possible to cache the goods
	// for 3600 seconds with a large number of consecutive identical
	// responses. For cancellation of caching it is necessary to pass 0 as
	// value of parameter.
	Expiration int `json:"expiration,omitempty"`
}

type GetSubscriptionRequest struct {
	Notification

	// The recipient’s ID.
	ReceiverID int `schema:"receiver_id,required"`

	// Order identifier in the VK payment system.
	OrderID int `schema:"order_id,required"`

	// User language in the language_country format.
	//
	// ru_RU — Russian
	//
	// uk_UA — Ukrainian
	//
	// be_BY — Belarusian
	//
	// en_US — English
	Lang string `schema:"lang,required"`

	// Product name passed to the subscription dialog window.
	Item string `schema:"item,required"`
}

type GetSubscriptionResponse struct {
	// Product identifier in the application.
	ItemID int `json:"item_id,omitempty"`

	// Subscription name.
	Title string `json:"title"`

	// Image URL on the developer’s server for the subscription.
	PhotoURL string `json:"photo_url,omitempty"`

	// Subscription price shown in votes.
	Price int `json:"price"`

	// Subscription period duration in days. Possible values: 3, 7, 30.
	Period int `json:"period"`

	// Trial period duration in days. Possible values: 3, 7, 30.
	TrialDuration int `json:"trial_duration,omitempty"`

	// Allows product caching for {expiration} seconds. Permitted range is
	// from 600 to 604,800 seconds.
	//
	// Warning! Without the parameter, caching of the product is possible for
	// 3,600 seconds if many identical consecutive responses occur. To disable
	// caching, it is necessary to pass 0 as the parameter value.
	Expiration int `json:"expiration,omitempty"`
}

type Notification struct {
	// The type of notification.
	Type NotificationType `schema:"notification_type,required"`

	// The app’s ID.
	AppID int `schema:"app_id,required"`

	// The ID of the user who made the order.
	UserID int `schema:"user_id,required"`

	// The notification signature.
	Sig string `schema:"sig,required"`
}

type NotificationType string

type OrderStatusChangeRequest struct {
	Notification

	// The recipient’s ID.
	ReceiverID int `schema:"receiver_id,required"`

	// Order ID in VK payment system.
	OrderID int `schema:"order_id,required"`

	// Date when the order was created (as "unix timestamp").
	Date int `schema:"date,required"`

	// New status of the order.
	//
	// chargeable - order ready for payment. User shall complete the order
	// in the application. In case of successful reply the payment system will
	// charge votes to the application account. In case of error message the
	// order will be canceled.
	//
	// refunded - Available as of API version 5.132. Order cancelled. It is necessary
	// to pick up game values given to the user for payments.
	Status Status `schema:"status,required"`

	// Product name passed to the purchase dialog box.
	//
	// For special offer (call of the payment dialog box with type=offers), Item
	// parameter will include "offer_{offer_id}", item_price parameter is the
	// number of votes charged for such special offer.
	Item string `schema:"item,required"`

	// Product ID in the application.
	ItemID string `schema:"item_id"`

	// Product name.
	ItemTitle string `schema:"item_title,required"`

	// Product image.
	ItemPhotoURL string `schema:"item_photo_url"`

	// Product price.
	ItemPrice string `schema:"item_price,required"`

	// Cost in application currency.
	//
	// See https://vk.com/dev/payments_offers
	ItemCurrencyAmount string `schema:"item_currency_amount"`

	// Product discount.
	ItemDiscount string `schema:"item_discount"`
}

type OrderStatusChangeResponse struct {
	// order ID in VK payment system
	OrderID int `json:"order_id"`

	// ID of the order in the application. Shall be unique for each order
	AppOrderID int `json:"app_order_id,omitempty"`
}

type Reason string

type Status string

type SubscriptionStatusChangeRequest struct {
	Notification

	// Reason for cancellation.
	CancelReason Reason `schema:"cancel_reason"`

	// Product identifier in the application.
	ItemID string `schema:"item_id,required"`

	// Product price.
	ItemPrice string `schema:"item_price,required"`

	// New subscription status. Possible values:
	//
	// chargeable — subscription is ready for payments. An order for the user
	// needs to be processed within the application. If the response is
	// successful, the payment system credits votes to the application
	// balance. If the response is a failure, the order is canceled.
	//
	// active — subscription is active;
	//
	// cancelled — subscription is canceled.
	Status Status `schema:"status,required"`

	// Subscription is active until the end of the paid period (status = active).
	//
	// integer, [1]
	PendingCancel int `schema:"pending_cancel"`

	// Subscription identifier.
	SubscriptionID int `schema:"subscription_id,required"`

	// Subscription next bill time
	NextBillTime int `schema:"next_bill_time"`
}

type SubscriptionStatusChangeResponse struct {
	// Global subscription identifier.
	SubscriptionID int `json:"subscription_id"`

	// Order identifier within the app. Must be unique for each order.
	AppOrderID int `json:"app_order_id,omitempty"`
}