paypal

type Address struct {
	Line1       string `json:"line1,omitempty"`
	Line2       string `json:"line2,omitempty"`
	City        string `json:"city,omitempty"`
	CountryCode string `json:"country_code,omitempty"`
	PostalCode  string `json:"postal_code,omitempty"`
	State       string `json:"state,omitempty"`
	Phone       string `json:"phone,omitempty"`
}

type AggregatedDiscount struct {
	InvoiceDiscount InvoicingDiscount `json:"invoice_discount,omitempty"`
	ItemDiscount    *Money            `json:"item_discount,omitempty"`
}

type AgreeMoney struct {
	Currency string `json:"currency"`
	Value    string `json:"value"`
}

type AgreementDetails struct {
	OutstandingBalance AmountPayout `json:"outstanding_balance"`
	CyclesRemaining    int          `json:"cycles_remaining,string"`
	CyclesCompleted    int          `json:"cycles_completed,string"`
	NextBillingDate    time.Time    `json:"next_billing_date"`
	LastPaymentDate    time.Time    `json:"last_payment_date"`
	LastPaymentAmount  AmountPayout `json:"last_payment_amount"`
	FinalPaymentDate   time.Time    `json:"final_payment_date"`
	FailedPaymentCount int          `json:"failed_payment_count,string"`
}

type AgreementTransaction struct {
	TransactionID   string     `json:"transaction_id"`
	Status          string     `json:"status"`
	TransactionType string     `json:"transaction_type"`
	Amount          AgreeMoney `json:"amount"`
	FeeAmount       AgreeMoney `json:"fee_amount"`
	NetAmount       AgreeMoney `json:"net_amount"`
	PayerEmail      string     `json:"payer_email"`
	PayerName       string     `json:"payer_name"`
	TimeStamp       JSONTime   `json:"time_stamp"`
	TimeZone        string     `json:"time_zone"`
}

type AgreementTransactionListParams struct {
	StartDate string
	EndDate   string
}

type AgreementTransactionListResponse struct {
	AgreementTransactionList []AgreementTransaction `json:"agreement_transaction_list"`
}

type Amount struct {
	Currency string  `json:"currency"`
	Total    string  `json:"total"`
	Details  Details `json:"details,omitempty"`
}

type AmountPayout struct {
	Currency string `json:"currency"`
	Value    string `json:"value"`
}

type AmountSummaryDetail struct {
	Breakdown InvoiceAmountWithBreakdown `json:"breakdown,omitempty"`
	Currency  string                     `json:"currency_code,omitempty"`
	Value     string                     `json:"value,omitempty"`
}

type AmountWithBreakdown struct {
	GrossAmount    Money `json:"gross_amount"`
	FeeAmount      Money `json:"fee_amount"`
	ShippingAmount Money `json:"shipping_amount"`
	TaxAmount      Money `json:"tax_amount"`
	NetAmount      Money `json:"net_amount"`
}

type AnyEvent struct {
	Event
	Resource json.RawMessage `json:"resource"`
}

type ApplicationContext struct {
	BrandName          string             `json:"brand_name,omitempty"`
	Locale             string             `json:"locale,omitempty"`
	ShippingPreference ShippingPreference `json:"shipping_preference,omitempty"`
	UserAction         UserAction         `json:"user_action,omitempty"`
	PaymentMethod      PaymentMethod      `json:"payment_method,omitempty"`
	//LandingPage        string `json:"landing_page,omitempty"` // not found in documentation
	ReturnURL string `json:"return_url,omitempty"`
	CancelURL string `json:"cancel_url,omitempty"`
}

type Authorization struct {
	ID               string                `json:"id,omitempty"`
	CustomID         string                `json:"custom_id,omitempty"`
	InvoiceID        string                `json:"invoice_id,omitempty"`
	Status           string                `json:"status,omitempty"`
	StatusDetails    *CaptureStatusDetails `json:"status_details,omitempty"`
	Amount           *PurchaseUnitAmount   `json:"amount,omitempty"`
	SellerProtection *SellerProtection     `json:"seller_protection,omitempty"`
	CreateTime       *time.Time            `json:"create_time,omitempty"`
	UpdateTime       *time.Time            `json:"update_time,omitempty"`
	ExpirationTime   *time.Time            `json:"expiration_time,omitempty"`
	Links            []Link                `json:"links,omitempty"`
}

type AuthorizeOrderRequest struct {
	PaymentSource      *PaymentSource     `json:"payment_source,omitempty"`
	ApplicationContext ApplicationContext `json:"application_context,omitempty"`
}

type AuthorizeOrderResponse struct {
	CreateTime    *time.Time             `json:"create_time,omitempty"`
	UpdateTime    *time.Time             `json:"update_time,omitempty"`
	ID            string                 `json:"id,omitempty"`
	Status        string                 `json:"status,omitempty"`
	Intent        string                 `json:"intent,omitempty"`
	PurchaseUnits []PurchaseUnitRequest  `json:"purchase_units,omitempty"`
	Payer         *PayerWithNameAndPhone `json:"payer,omitempty"`
}

type BatchHeader struct {
	Amount            *AmountPayout      `json:"amount,omitempty"`
	Fees              *AmountPayout      `json:"fees,omitempty"`
	PayoutBatchID     string             `json:"payout_batch_id,omitempty"`
	BatchStatus       string             `json:"batch_status,omitempty"`
	TimeCreated       *time.Time         `json:"time_created,omitempty"`
	TimeCompleted     *time.Time         `json:"time_completed,omitempty"`
	SenderBatchHeader *SenderBatchHeader `json:"sender_batch_header,omitempty"`
}

type BillingAgreement struct {
	ID                          string               `json:"id,omitempty"`
	State                       string               `json:"state,omitempty"`
	Name                        string               `json:"name,omitempty"`
	Description                 string               `json:"description,omitempty"`
	StartDate                   *JSONTime            `json:"start_date,omitempty"`
	AgreementDetails            *AgreementDetails    `json:"agreement_details,omitempty"`
	Plan                        *BillingPlan         `json:"plan,omitempty"`
	Payer                       *Payer               `json:"payer,omitempty"`
	ShippingAddress             *ShippingAddress     `json:"shipping_address,omitempty"`
	OverrideMerchantPreferences *MerchantPreferences `json:"override_merchant_preferences,omitempty"`
}

type BillingAgreementFromToken struct {
	ID          string      `json:"id,omitempty"`
	Description string      `json:"description,omitempty"`
	Payer       *Payer      `json:"payer,omitempty"`
	Plan        BillingPlan `json:"plan,omitempty"`
	Links       []Link      `json:"links,omitempty"`
}

type BillingAgreementToken struct {
	Links   []Link `json:"links,omitempty"`
	TokenID string `json:"token_id,omitempty"`
}

type BillingCycle struct {
	PricingScheme PricingScheme `json:"pricing_scheme"` // The active pricing scheme for this billing cycle. A free trial billing cycle does not require a pricing scheme.
	Frequency     Frequency     `json:"frequency"`      // The frequency details for this billing cycle.
	TenureType    TenureType    `json:"tenure_type"`    // The tenure type of the billing cycle. In case of a plan having trial cycle, only 2 trial cycles are allowed per plan. The possible values are:
	Sequence      int           `json:"sequence"`       // The order in which this cycle is to run among other billing cycles. For example, a trial billing cycle has a sequence of 1 while a regular billing cycle has a sequence of 2, so that trial cycle runs before the regular cycle.
	TotalCycles   int           `json:"total_cycles"`   // The number of times this billing cycle gets executed. Trial billing cycles can only be executed a finite number of times (value between 1 and 999 for total_cycles). Regular billing cycles can be executed infinite times (value of 0 for total_cycles) or a finite number of times (value between 1 and 999 for total_cycles).
}

type BillingCycleOverride struct {
	PricingScheme PricingScheme `json:"pricing_scheme,omitempty"`
	Sequence      *int          `json:"sequence,omitempty"`
	TotalCycles   *int          `json:"total_cycles,omitempty"`
}

type BillingInfo struct {
	OutstandingBalance  AmountPayout      `json:"outstanding_balance,omitempty"`
	CycleExecutions     []CycleExecutions `json:"cycle_executions,omitempty"`
	LastPayment         LastPayment       `json:"last_payment,omitempty"`
	NextBillingTime     time.Time         `json:"next_billing_time,omitempty"`
	FailedPaymentsCount int               `json:"failed_payments_count,omitempty"`
}

type BillingPlan struct {
	ID                  string               `json:"id,omitempty"`
	Name                string               `json:"name,omitempty"`
	Description         string               `json:"description,omitempty"`
	Type                string               `json:"type,omitempty"`
	State               string               `json:"state,omitempty"`
	CreateTime          *time.Time           `json:"create_time",omitempty"`
	UpdateTime          *time.Time           `json:"update_time",omitempty"`
	PaymentDefinitions  []PaymentDefinition  `json:"payment_definitions,omitempty"`
	MerchantPreferences *MerchantPreferences `json:"merchant_preferences,omitempty"`
	Links               []Link               `json:"links,omitempty"`
}

type BillingPlanListParams struct {
	ListParams
	Status string `json:"status,omitempty"` //Allowed values: CREATED, ACTIVE, INACTIVE, ALL.
}

type BillingPlanListResponse struct {
	SharedListResponse
	Plans []BillingPlan `json:"plans,omitempty"`
}

type BillingPlanStatus string

type Capture struct {
	ID             string     `json:"id,omitempty"`
	Amount         *Amount    `json:"amount,omitempty"`
	State          string     `json:"state,omitempty"`
	ParentPayment  string     `json:"parent_payment,omitempty"`
	TransactionFee string     `json:"transaction_fee,omitempty"`
	IsFinalCapture bool       `json:"is_final_capture"`
	CreateTime     *time.Time `json:"create_time,omitempty"`
	UpdateTime     *time.Time `json:"update_time,omitempty"`
	Links          []Link     `json:"links,omitempty"`
}

type CaptureAmount struct {
	Status                    string                     `json:"status,omitempty"`
	ID                        string                     `json:"id,omitempty"`
	CustomID                  string                     `json:"custom_id,omitempty"`
	Amount                    *PurchaseUnitAmount        `json:"amount,omitempty"`
	SellerProtection          *SellerProtection          `json:"seller_protection,omitempty"`
	SellerReceivableBreakdown *SellerReceivableBreakdown `json:"seller_receivable_breakdown,omitempty"`
}

type CaptureDetailsResponse struct {
	Status                    string                     `json:"status,omitempty"`
	StatusDetails             *CaptureStatusDetails      `json:"status_details,omitempty"`
	ID                        string                     `json:"id,omitempty"`
	Amount                    *Money                     `json:"amount,omitempty"`
	InvoiceID                 string                     `json:"invoice_id,omitempty"`
	CustomID                  string                     `json:"custom_id,omitempty"`
	SellerProtection          *SellerProtection          `json:"seller_protection,omitempty"`
	FinalCapture              bool                       `json:"final_capture,omitempty"`
	SellerReceivableBreakdown *SellerReceivableBreakdown `json:"seller_receivable_breakdown,omitempty"`
	DisbursementMode          string                     `json:"disbursement_mode,omitempty"`
	Links                     []Link                     `json:"links,omitempty"`
	UpdateTime                *time.Time                 `json:"update_time,omitempty"`
	CreateTime                *time.Time                 `json:"create_time,omitempty"`
}

type CaptureOrderMockResponse struct {
	MockApplicationCodes string `json:"mock_application_codes"`
}

type CaptureOrderRequest struct {
	PaymentSource *PaymentSource `json:"payment_source"`
}

type CaptureOrderResponse struct {
	ID            string                 `json:"id,omitempty"`
	Status        string                 `json:"status,omitempty"`
	Payer         *PayerWithNameAndPhone `json:"payer,omitempty"`
	Address       *Address               `json:"address,omitempty"`
	PurchaseUnits []CapturedPurchaseUnit `json:"purchase_units,omitempty"`
}

type CaptureRequest struct {
	Note        string      `json:"note"`
	CaptureType CaptureType `json:"capture_type"`
	Amount      Money       `json:"amount"`
}

type CaptureSellerBreakdown struct {
	GrossAmount         PurchaseUnitAmount  `json:"gross_amount"`
	PayPalFee           PurchaseUnitAmount  `json:"paypal_fee"`
	NetAmount           PurchaseUnitAmount  `json:"net_amount"`
	TotalRefundedAmount *PurchaseUnitAmount `json:"total_refunded_amount,omitempty"`
}

type CaptureStatusDetails struct {
	Reason string `json:"reason,omitempty"`
}

type CaptureType string

type CapturedPayments struct {
	Captures []CaptureAmount `json:"captures,omitempty"`
}

type CapturedPurchaseItem struct {
	Quantity    string `json:"quantity"`
	Name        string `json:"name"`
	SKU         string `json:"sku,omitempty"`
	Description string `json:"description,omitempty"`
}

type CapturedPurchaseUnit struct {
	Items       []CapturedPurchaseItem       `json:"items,omitempty"`
	ReferenceID string                       `json:"reference_id"`
	Shipping    CapturedPurchaseUnitShipping `json:"shipping,omitempty"`
	Payments    *CapturedPayments            `json:"payments,omitempty"`
}

type CapturedPurchaseUnitShipping struct {
	Address ShippingDetailAddressPortable `json:"address,omitempty"`
}

type CardBillingAddress struct {
	AddressLine1 string `json:"address_line_1"`
	AddressLine2 string `json:"address_line_2"`
	AdminArea2   string `json:"admin_area_2"`
	AdminArea1   string `json:"admin_area_1"`
	PostalCode   string `json:"postal_code"`
	CountryCode  string `json:"country_code"`
}

type ChargeModel struct {
	Type   string       `json:"type,omitempty"`
	Amount AmountPayout `json:"amount,omitempty"`
}

type Client struct {
	Client   *http.Client
	ClientID string
	Secret   string
	APIBase  string
	Log      io.Writer // If user set log file name all requests will be logged there
	Token    *TokenResponse
	// contains filtered or unexported fields
}

type Consent struct {
	Type    string `json:"type"`
	Granted bool   `json:"granted"`
}

type CreateAgreementResponse struct {
	Name        string      `json:"name,omitempty"`
	State       string      `json:"state"`
	Description string      `json:"description,omitempty"`
	Plan        BillingPlan `json:"plan,omitempty"`
	Links       []Link      `json:"links,omitempty"`
	StartDate   string      `json:"start_date,omitempty"`
}

type CreateBillingResponse struct {
	ID                  string              `json:"id,omitempty"`
	State               string              `json:"state,omitempty"`
	PaymentDefinitions  []PaymentDefinition `json:"payment_definitions,omitempty"`
	MerchantPreferences MerchantPreferences `json:"merchant_preferences,omitempty"`
	CreateTime          time.Time           `json:"create_time,omitempty"`
	UpdateTime          time.Time           `json:"update_time,omitempty"`
	Links               []Link              `json:"links,omitempty"`
}

type CreateOrderPayer struct {
	Name         *CreateOrderPayerName          `json:"name,omitempty"`
	EmailAddress string                         `json:"email_address,omitempty"`
	PayerID      string                         `json:"payer_id,omitempty"`
	Phone        *PhoneWithType                 `json:"phone,omitempty"`
	BirthDate    string                         `json:"birth_date,omitempty"`
	TaxInfo      *TaxInfo                       `json:"tax_info,omitempty"`
	Address      *ShippingDetailAddressPortable `json:"address,omitempty"`
}

type CreateOrderPayerName struct {
	GivenName string `json:"given_name,omitempty"`
	Surname   string `json:"surname,omitempty"`
}

type CreateProductResponse struct {
	Product
	SharedResponse
}

type CreateSubscriptionPlanResponse struct {
	SubscriptionPlan
	SharedResponse
}

type CreateWebhookRequest struct {
	URL        string             `json:"url"`
	EventTypes []WebhookEventType `json:"event_types"`
}

type CreditCard struct {
	ID                 string   `json:"id,omitempty"`
	PayerID            string   `json:"payer_id,omitempty"`
	ExternalCustomerID string   `json:"external_customer_id,omitempty"`
	Number             string   `json:"number"`
	Type               string   `json:"type"`
	ExpireMonth        string   `json:"expire_month"`
	ExpireYear         string   `json:"expire_year"`
	CVV2               string   `json:"cvv2,omitempty"`
	FirstName          string   `json:"first_name,omitempty"`
	LastName           string   `json:"last_name,omitempty"`
	BillingAddress     *Address `json:"billing_address,omitempty"`
	State              string   `json:"state,omitempty"`
	ValidUntil         string   `json:"valid_until,omitempty"`
}

type CreditCardField struct {
	Operation string `json:"op"`
	Path      string `json:"path"`
	Value     string `json:"value"`
}

type CreditCardToken struct {
	CreditCardID string `json:"credit_card_id"`
	PayerID      string `json:"payer_id,omitempty"`
	Last4        string `json:"last4,omitempty"`
	ExpireYear   string `json:"expire_year,omitempty"`
	ExpireMonth  string `json:"expire_month,omitempty"`
}

type CreditCards struct {
	Items []CreditCard `json:"items"`
	SharedListResponse
}

type CreditCardsFilter struct {
	PageSize int
	Page     int
}

type Currency struct {
	Currency string `json:"currency,omitempty"`
	Value    string `json:"value,omitempty"`
}

type CustomAmount struct {
	Label  string `json:"label"`
	Amount Money  `json:"amount,omitempty"`
}

type CycleExecutions struct {
	TenureType      string `json:"tenure_type,omitempty"`
	Sequence        int    `json:"sequence,omitempty"`
	CyclesCompleted int    `json:"cycles_completed,omitempty"`
	CyclesRemaining int    `json:"cycles_remaining,omitempty"`
	TotalCycles     int    `json:"total_cycles,omitempty"`
}

type Details struct {
	Subtotal         string `json:"subtotal,omitempty"`
	Shipping         string `json:"shipping,omitempty"`
	Tax              string `json:"tax,omitempty"`
	HandlingFee      string `json:"handling_fee,omitempty"`
	ShippingDiscount string `json:"shipping_discount,omitempty"`
	Insurance        string `json:"insurance,omitempty"`
	GiftWrap         string `json:"gift_wrap,omitempty"`
}

type ErrorResponse struct {
	Response        *http.Response        `json:"-"`
	Name            string                `json:"name"`
	DebugID         string                `json:"debug_id"`
	Message         string                `json:"message"`
	InformationLink string                `json:"information_link"`
	Details         []ErrorResponseDetail `json:"details"`
}

type ErrorResponseDetail struct {
	Field       string `json:"field"`
	Issue       string `json:"issue"`
	Name        string `json:"name"`
	Message     string `json:"message"`
	Description string `json:"description"`
	Links       []Link `json:"link"`
}

type Event struct {
	ID              string    `json:"id"`
	CreateTime      time.Time `json:"create_time"`
	ResourceType    string    `json:"resource_type"`
	EventType       string    `json:"event_type"`
	Summary         string    `json:"summary,omitempty"`
	Links           []Link    `json:"links"`
	EventVersion    string    `json:"event_version,omitempty"`
	ResourceVersion string    `json:"resource_version,omitempty"`
}

type ExchangeRate struct {
	SourceCurrency string `json:"source_currency"`
	TargetCurrency string `json:"target_currency"`
	Value          string `json:"value"`
}

type ExecuteAgreementResponse struct {
	ID               string           `json:"id"`
	State            string           `json:"state"`
	Description      string           `json:"description,omitempty"`
	Payer            Payer            `json:"payer"`
	Plan             BillingPlan      `json:"plan"`
	StartDate        time.Time        `json:"start_date"`
	ShippingAddress  ShippingAddress  `json:"shipping_address"`
	AgreementDetails AgreementDetails `json:"agreement_details"`
	Links            []Link           `json:"links"`
}

type ExecuteResponse struct {
	ID           string        `json:"id"`
	Links        []Link        `json:"links"`
	State        string        `json:"state"`
	Payer        PaymentPayer  `json:"payer"`
	Transactions []Transaction `json:"transactions,omitempty"`
}

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

type FlowConfig struct {
	LandingPageType   string `json:"landing_page_type,omitempty"`
	BankTXNPendingURL string `json:"bank_txn_pending_url,omitempty"`
	UserAction        string `json:"user_action,omitempty"`
}

type Frequency struct {
	IntervalUnit  IntervalUnit `json:"interval_unit"`
	IntervalCount int          `json:"interval_count"` //different per unit. check documentation
}

type FundingInstrument struct {
	CreditCard      *CreditCard      `json:"credit_card,omitempty"`
	CreditCardToken *CreditCardToken `json:"credit_card_token,omitempty"`
}

type InputFields struct {
	AllowNote       bool `json:"allow_note,omitempty"`
	NoShipping      uint `json:"no_shipping,omitempty"`
	AddressOverride uint `json:"address_override,omitempty"`
}

type IntegrationDetails struct {
	RestAPIIntegration *RestAPIIntegration `json:"rest_api_integration,omitempty"`
}

type IntervalUnit string

type Invoice struct {
	AdditionalRecipients []InvoiceEmailAddress  `json:"additional_recipients,omitempty"` // An array of one or more CC: emails to which notifications are sent.
	AmountSummary        AmountSummaryDetail    `json:"amount,omitempty"`
	Configuration        InvoiceConfiguration   `json:"configuration,omitempty"`
	Detail               InvoiceDetail          `json:"detail,omitempty"`
	DueAmount            Money                  `json:"due_amount,omitempty"` // balance amount outstanding after payments.
	Gratuity             Money                  `json:"gratuity,omitempty"`   // amount paid by the payer as gratuity to the invoicer.
	ID                   string                 `json:"id,omitempty"`
	Invoicer             InvoicerInfo           `json:"invoicer,omitempty"`
	Items                []InvoiceItem          `json:"items,omitempty"`
	Links                []Link                 `json:"links,omitempty"`
	ParentID             string                 `json:"parent_id,omitempty"`
	Payments             InvoicePayments        `json:"payments,omitempty"`
	PrimaryRecipients    []InvoiceRecipientInfo `json:"primary_recipients,omitempty"`
	Refunds              InvoiceRefund          `json:"refunds,omitempty"` // List of refunds against this invoice.
	Status               string                 `json:"status,omitempty"`
}

type InvoiceAddressDetails struct {
	BuildingName    string `json:"building_name,omitempty"`
	DeliveryService string `json:"delivery_service,omitempty"`
	StreetName      string `json:"street_name,omitempty"`
	StreetNumber    string `json:"street_number,omitempty"`
	StreetType      string `json:"street_type,omitempty"`
	SubBuilding     string `json:"sub_building,omitempty"`
}

type InvoiceAddressPortable struct {
	CountryCode    string                `json:"country_code"`
	AddressDetails InvoiceAddressDetails `json:"address_details,omitempty"`
	AddressLine1   string                `json:"address_line_1,omitempty"`
	AddressLine2   string                `json:"address_line_2,omitempty"`
	AddressLine3   string                `json:"address_line_3,omitempty"`
	AdminArea1     string                `json:"admin_area_1,omitempty"`
	AdminArea2     string                `json:"admin_area_2,omitempty"`
	AdminArea3     string                `json:"admin_area_3,omitempty"`
	AdminArea4     string                `json:"admin_area_4,omitempty"`
	PostalCode     string                `json:"postal_code,omitempty"`
}

type InvoiceAmountWithBreakdown struct {
	Custom    CustomAmount        `json:"custom,omitempty"` // The custom amount to apply to an invoice.
	Discount  AggregatedDiscount  `json:"discount,omitempty"`
	ItemTotal Money               `json:"item_total,omitempty"` // The subtotal for all items.
	Shipping  InvoiceShippingCost `json:"shipping,omitempty"`   // The shipping fee for all items. Includes tax on shipping.
	TaxTotal  Money               `json:"tax_total,omitempty"`
}

type InvoiceAuditMetadata struct {
	CreateTime       string `json:"create_time,omitempty"`
	CreatedBy        string `json:"created_by,omitempty"`
	LastUpdateTime   string `json:"last_update_time,omitempty"`
	LastUpdatedBy    string `json:"last_updated_by,omitempty"`
	CancelTime       string `json:"cancel_time,omitempty"`
	CancellledTimeBy string `json:"cancelled_by,omitempty"`
	CreatedByFlow    string `json:"created_by_flow,omitempty"`
	FirstSentTime    string `json:"first_sent_time,omitempty"`
	InvoicerViewUrl  string `json:"invoicer_view_url,omitempty"`
	LastSentBy       string `json:"last_sent_by,omitempty"`
	LastSentTime     string `json:"last_sent_time,omitempty"`
	RecipientViewUrl string `json:"recipient_view_url,omitempty"`
}

type InvoiceBillingInfo struct {
	AdditionalInfo string                `json:"additional_info,omitempty"`
	EmailAddress   string                `json:"email_address,omitempty"`
	Language       string                `json:"language,omitempty"`
	Phones         []InvoicerPhoneDetail `json:"phones,omitempty"` // invoice recipient's phone numbers.
}

type InvoiceConfiguration struct {
	AllowTip                   bool                  `json:"allow_tip,omitempty"`
	PartialPayment             InvoicePartialPayment `json:"partial_payment,omitempty"`
	TaxCalculatedAfterDiscount bool                  `json:"tax_calculated_after_discount,omitempty"`
	TaxInclusive               bool                  `json:"tax_inclusive,omitempty"`
	TemplateId                 string                `json:"template_id,omitempty"`
}

type InvoiceContactInfo struct {
	BusinessName     string                 `json:"business_name,omitempty"`
	RecipientAddress InvoiceAddressPortable `json:"address,omitempty"` // address of the recipient.
	RecipientName    Name                   `json:"name,omitempty"`    // The first and Last name of the recipient.
}

type InvoiceDetail struct {
	CurrencyCode       string                 `json:"currency_code"` // required, hence omitempty not used
	Attachments        []InvoiceFileReference `json:"attachments,omitempty"`
	Memo               string                 `json:"memo,omitempty"`
	Note               string                 `json:"note,omitempty"`
	Reference          string                 `json:"reference,omitempty"`
	TermsAndConditions string                 `json:"terms_and_conditions,omitempty"`
	InvoiceDate        string                 `json:"invoice_date,omitempty"`
	InvoiceNumber      string                 `json:"invoice_number,omitempty"`
	Metadata           InvoiceAuditMetadata   `json:"metadata,omitempty"`     // The audit metadata.
	PaymentTerm        InvoicePaymentTerm     `json:"payment_term,omitempty"` // payment due date for the invoice. Value is either but not both term_type or due_date.
}

type InvoiceEmailAddress struct {
	EmailAddress string `json:"email_address,omitempty"`
}

type InvoiceFileReference struct {
	ContentType string `json:"content_type,omitempty"`
	CreateTime  string `json:"create_time,omitempty"`
	ID          string `json:"id,omitempty"`
	URL         string `json:"reference_url,omitempty"`
	Size        string `json:"size,omitempty"`
}

type InvoiceItem struct {
	Name            string            `json:"name"`
	Quantity        string            `json:"quantity"`
	UnitAmount      Money             `json:"unit_amount"`
	Description     string            `json:"description,omitempty"`
	InvoiceDiscount InvoicingDiscount `json:"discount,omitempty"`
	ID              string            `json:"id,omitempty"`
	ItemDate        string            `json:"item_date,omitempty"`
	Tax             InvoiceTax        `json:"tax,omitempty"`
	UnitOfMeasure   string            `json:"unit_of_measure,omitempty"`
}

type InvoiceNumber struct {
	InvoiceNumberValue string `json:"invoice_number"`
}

type InvoicePartialPayment struct {
	AllowPartialPayment bool  `json:"allow_partial_payment,omitempty"`
	MinimumAmountDue    Money `json:"minimum_amount_due,omitempty"` // Valid only when allow_partial_payment is true.
}

type InvoicePaymentDetails struct {
	Method       string             `json:"method"`
	Amount       Money              `json:"amount,omitempty"`
	Note         string             `json:"note,omitempty"`
	PaymentDate  string             `json:"payment_date,omitempty"`
	PaymentID    string             `json:"payment_id,omitempty"`
	ShippingInfo InvoiceContactInfo `json:"shipping_info,omitempty"` // The recipient's shipping information.
	Type         string             `json:"type,omitempty"`
}

type InvoicePaymentTerm struct {
	TermType string `json:"term_type,omitempty"`
	DueDate  string `json:"due_date,omitempty"`
}

type InvoicePayments struct {
	PaidAmount   Money                   `json:"paid_amount,omitempty"`
	Transactions []InvoicePaymentDetails `json:"transactions,omitempty"`
}

type InvoiceRecipientInfo struct {
	BillingInfo  InvoiceBillingInfo `json:"billing_info,omitempty"`  // billing information for the invoice recipient.
	ShippingInfo InvoiceContactInfo `json:"shipping_info,omitempty"` // recipient's shipping information.
}

type InvoiceRefund struct {
	RefundAmount  Money                  `json:"refund_amount,omitempty"`
	RefundDetails []InvoiceRefundDetails `json:"transactions,omitempty"`
}

type InvoiceRefundDetails struct {
	Method       string `json:"method"`
	RefundAmount Money  `json:"amount,omitempty"`
	RefundDate   string `json:"refund_date,omitempty"`
	RefundID     string `json:"refund_id,omitempty"`
	RefundType   string `json:"type,omitempty"`
}

type InvoiceShippingCost struct {
	Amount Money      `json:"amount,omitempty"`
	Tax    InvoiceTax `json:"tax,omitempty"`
}

type InvoiceTax struct {
	Name    string `json:"name,omitempty"`
	Percent string `json:"percent,omitempty"`
	ID      string `json:"id,omitempty"` //  not mentioned here, but is still returned in response payload, when invoice is requested by ID.
	Amount  Money  `json:"amount,omitempty"`
}

type InvoicerInfo struct {
	AdditionalNotes string                `json:"additional_notes,omitempty"`
	EmailAddress    string                `json:"email_address,omitempty"`
	LogoUrl         string                `json:"logo_url,omitempty"`
	Phones          []InvoicerPhoneDetail `json:"phones,omitempty"`
	TaxId           string                `json:"tax_id,omitempty"`
	Website         string                `json:"website,omitempty"`
}

type InvoicerPhoneDetail struct {
	CountryCode     string `json:"country_code"`
	NationalNumber  string `json:"national_number"`
	ExtensionNumber string `json:"extension_number,omitempty"`
	PhoneType       string `json:"phone_type,omitempty"`
}

type InvoicingDiscount struct {
	DiscountAmount Money  `json:"amount,omitempty"`
	Percent        string `json:"percent,omitempty"`
}

type Item struct {
	Name        string `json:"name"`
	UnitAmount  *Money `json:"unit_amount,omitempty"`
	Tax         *Money `json:"tax,omitempty"`
	Quantity    string `json:"quantity"`
	Description string `json:"description,omitempty"`
	SKU         string `json:"sku,omitempty"`
	Category    string `json:"category,omitempty"`
}

type ItemList struct {
	Items           []Item           `json:"items,omitempty"`
	ShippingAddress *ShippingAddress `json:"shipping_address,omitempty"`
}

type JSONTime time.Time

type LastPayment struct {
	Amount Money     `json:"amount,omitempty"`
	Time   time.Time `json:"time,omitempty"`
}

type Link struct {
	Href        string `json:"href"`
	Rel         string `json:"rel,omitempty"`
	Method      string `json:"method,omitempty"`
	Description string `json:"description,omitempty"`
	Enctype     string `json:"enctype,omitempty"`
}

type ListParams struct {
	Page          string `json:"page,omitempty"`           //Default: 0.
	PageSize      string `json:"page_size,omitempty"`      //Default: 10.
	TotalRequired string `json:"total_required,omitempty"` //Default: no.
}

type ListProductsResponse struct {
	Products []Product `json:"products"`
	SharedListResponse
}

type ListSubscriptionPlansResponse struct {
	Plans []SubscriptionPlan `json:"plans"`
	SharedListResponse
}

type ListWebhookResponse struct {
	Webhooks []Webhook `json:"webhooks"`
}

type MerchantPreferences struct {
	SetupFee                *AmountPayout `json:"setup_fee,omitempty"`
	ReturnURL               string        `json:"return_url,omitempty"`
	CancelURL               string        `json:"cancel_url,omitempty"`
	AutoBillAmount          string        `json:"auto_bill_amount,omitempty"`
	InitialFailAmountAction string        `json:"initial_fail_amount_action,omitempty"`
	MaxFailAttempts         string        `json:"max_fail_attempts,omitempty"`
}

type Money struct {
	Currency string `json:"currency_code"`
	Value    string `json:"value"`
}

type Name struct {
	FullName   string `json:"full_name,omitempty"`
	Suffix     string `json:"suffix,omitempty"`
	Prefix     string `json:"prefix,omitempty"`
	GivenName  string `json:"given_name,omitempty"`
	Surname    string `json:"surname,omitempty"`
	MiddleName string `json:"middle_name,omitempty"`
}

type Operation struct {
	Operation                string              `json:"operation"`
	APIIntegrationPreference *IntegrationDetails `json:"api_integration_preference,omitempty"`
}

type Order struct {
	ID            string                 `json:"id,omitempty"`
	Status        string                 `json:"status,omitempty"`
	Intent        string                 `json:"intent,omitempty"`
	Payer         *PayerWithNameAndPhone `json:"payer,omitempty"`
	PurchaseUnits []PurchaseUnit         `json:"purchase_units,omitempty"`
	Links         []Link                 `json:"links,omitempty"`
	CreateTime    *time.Time             `json:"create_time,omitempty"`
	UpdateTime    *time.Time             `json:"update_time,omitempty"`
}

type PartnerConfigOverride struct {
	PartnerLogoURL       string `json:"partner_logo_url,omitempty"`
	ReturnURL            string `json:"return_url,omitempty"`
	ReturnURLDescription string `json:"return_url_description,omitempty"`
	ActionRenewalURL     string `json:"action_renewal_url,omitempty"`
	ShowAddCreditCard    *bool  `json:"show_add_credit_card,omitempty"`
}

type Patch struct {
	Operation string      `json:"op"`
	Path      string      `json:"path"`
	Value     interface{} `json:"value"`
}

type PatchField struct {
	Operation string      `json:"op"`
	Path      string      `json:"path"`
	Value     interface{} `json:"value"`
}

type Payee struct {
	Email string `json:"email"`
}

type PayeeForOrders struct {
	EmailAddress string `json:"email_address,omitempty"`
	MerchantID   string `json:"merchant_id,omitempty"`
}

type PayeePreferred string // Doc: https://developer.paypal.com/api/orders/v2/#definition-payment_method

type Payer struct {
	PaymentMethod      string              `json:"payment_method"`
	FundingInstruments []FundingInstrument `json:"funding_instruments,omitempty"`
	PayerInfo          *PayerInfo          `json:"payer_info,omitempty"`
	Status             string              `json:"payer_status,omitempty"`
}

type PayerInfo struct {
	Email           string           `json:"email,omitempty"`
	FirstName       string           `json:"first_name,omitempty"`
	LastName        string           `json:"last_name,omitempty"`
	PayerID         string           `json:"payer_id,omitempty"`
	Phone           string           `json:"phone,omitempty"`
	ShippingAddress *ShippingAddress `json:"shipping_address,omitempty"`
	TaxIDType       string           `json:"tax_id_type,omitempty"`
	TaxID           string           `json:"tax_id,omitempty"`
	CountryCode     string           `json:"country_code"`
}

type PayerWithNameAndPhone struct {
	Name         *CreateOrderPayerName          `json:"name,omitempty"`
	EmailAddress string                         `json:"email_address,omitempty"`
	Phone        *PhoneWithType                 `json:"phone,omitempty"`
	PayerID      string                         `json:"payer_id,omitempty"`
	BirthDate    string                         `json:"birth_date,omitempty"`
	TaxInfo      *TaxInfo                       `json:"tax_info,omitempty"`
	Address      *ShippingDetailAddressPortable `json:"address,omitempty"`
}

type PaymentCaptureRequest struct {
	InvoiceID      string `json:"invoice_id,omitempty"`
	NoteToPayer    string `json:"note_to_payer,omitempty"`
	SoftDescriptor string `json:"soft_descriptor,omitempty"`
	Amount         *Money `json:"amount,omitempty"`
	FinalCapture   bool   `json:"final_capture,omitempty"`
}

type PaymentCaptureResponse struct {
	Status           string                `json:"status,omitempty"`
	StatusDetails    *CaptureStatusDetails `json:"status_details,omitempty"`
	ID               string                `json:"id,omitempty"`
	Amount           *Money                `json:"amount,omitempty"`
	InvoiceID        string                `json:"invoice_id,omitempty"`
	FinalCapture     bool                  `json:"final_capture,omitempty"`
	DisbursementMode string                `json:"disbursement_mode,omitempty"`
	Links            []Link                `json:"links,omitempty"`
}

type PaymentDefinition struct {
	ID                string        `json:"id,omitempty"`
	Name              string        `json:"name,omitempty"`
	Type              string        `json:"type,omitempty"`
	Frequency         string        `json:"frequency,omitempty"`
	FrequencyInterval string        `json:"frequency_interval,omitempty"`
	Amount            AmountPayout  `json:"amount,omitempty"`
	Cycles            string        `json:"cycles,omitempty"`
	ChargeModels      []ChargeModel `json:"charge_models,omitempty"`
}

type PaymentInstruction struct {
	PlatformFees     []PlatformFee `json:"platform_fees,omitempty"`
	DisbursementMode string        `json:"disbursement_mode,omitempty"`
}

type PaymentMethod struct {
	PayeePreferred         PayeePreferred         `json:"payee_preferred,omitempty"`
	StandardEntryClassCode StandardEntryClassCode `json:"standard_entry_class_code,omitempty"`
}

type PaymentOptions struct {
	AllowedPaymentMethod string `json:"allowed_payment_method,omitempty"`
}

type PaymentPatch struct {
	Operation string      `json:"op"`
	Path      string      `json:"path"`
	Value     interface{} `json:"value"`
}

type PaymentPayer struct {
	PaymentMethod string     `json:"payment_method"`
	Status        string     `json:"status,omitempty"`
	PayerInfo     *PayerInfo `json:"payer_info,omitempty"`
}

type PaymentPreferences struct {
	AutoBillOutstanding     bool                  `json:"auto_bill_outstanding"`
	SetupFee                *Money                `json:"setup_fee"`
	SetupFeeFailureAction   SetupFeeFailureAction `json:"setup_fee_failure_action"`
	PaymentFailureThreshold int                   `json:"payment_failure_threshold"`
}

type PaymentPreferencesOverride struct {
	AutoBillOutstanding     bool                  `json:"auto_bill_outstanding,omitempty"`
	SetupFee                Money                 `json:"setup_fee,omitempty"`
	SetupFeeFailureAction   SetupFeeFailureAction `json:"setup_fee_failure_action,omitempty"`
	PaymentFailureThreshold int                   `json:"payment_failure_threshold,omitempty"`
}

type PaymentResponse struct {
	ID           string        `json:"id"`
	State        string        `json:"state"`
	Intent       string        `json:"intent"`
	Payer        Payer         `json:"payer"`
	Transactions []Transaction `json:"transactions"`
	Links        []Link        `json:"links"`
}

type PaymentSource struct {
	Card  *PaymentSourceCard  `json:"card,omitempty"`
	Token *PaymentSourceToken `json:"token,omitempty"`
}

type PaymentSourceCard struct {
	ID             string              `json:"id"`
	Name           string              `json:"name"`
	Number         string              `json:"number"`
	Expiry         string              `json:"expiry"`
	SecurityCode   string              `json:"security_code"`
	LastDigits     string              `json:"last_digits"`
	CardType       string              `json:"card_type"`
	BillingAddress *CardBillingAddress `json:"billing_address"`
}

type PaymentSourceToken struct {
	ID   string `json:"id"`
	Type string `json:"type"`
}

type Payout struct {
	SenderBatchHeader *SenderBatchHeader `json:"sender_batch_header"`
	Items             []PayoutItem       `json:"items"`
}

type PayoutItem struct {
	RecipientType   string        `json:"recipient_type"`
	RecipientWallet string        `json:"recipient_wallet"`
	Receiver        string        `json:"receiver"`
	Amount          *AmountPayout `json:"amount"`
	Note            string        `json:"note,omitempty"`
	SenderItemID    string        `json:"sender_item_id,omitempty"`
}

type PayoutItemResponse struct {
	PayoutItemID      string        `json:"payout_item_id"`
	TransactionID     string        `json:"transaction_id"`
	TransactionStatus string        `json:"transaction_status"`
	PayoutBatchID     string        `json:"payout_batch_id,omitempty"`
	PayoutItemFee     *AmountPayout `json:"payout_item_fee,omitempty"`
	PayoutItem        *PayoutItem   `json:"payout_item"`
	TimeProcessed     *time.Time    `json:"time_processed,omitempty"`
	Links             []Link        `json:"links"`
	Error             ErrorResponse `json:"errors,omitempty"`
}

type PayoutResponse struct {
	BatchHeader *BatchHeader         `json:"batch_header"`
	Items       []PayoutItemResponse `json:"items"`
	Links       []Link               `json:"links"`
}

type PhoneWithType struct {
	PhoneType   string               `json:"phone_type,omitempty"`
	PhoneNumber *PhoneWithTypeNumber `json:"phone_number,omitempty"`
}

type PhoneWithTypeNumber struct {
	NationalNumber string `json:"national_number,omitempty"`
}

type Plan struct {
	ID                 string              `json:"id"`
	Name               string              `json:"name"`
	Description        string              `json:"description"`
	CreateTime         string              `json:"create_time,omitempty"`
	UpdateTime         string              `json:"update_time,omitempty"`
	PaymentDefinitions []PaymentDefinition `json:"payment_definitions,omitempty"`
}

type PlanOverride struct {
	BillingCycles      []BillingCycleOverride      `json:"billing_cycles,omitempty"`
	PaymentPreferences *PaymentPreferencesOverride `json:"payment_preferences,omitempty"`
	Taxes              *TaxesOverride              `json:"taxes,omitempty"`
}

type PlatformFee struct {
	Amount *Money          `json:"amount,omitempty"`
	Payee  *PayeeForOrders `json:"payee,omitempty"`
}

type Presentation struct {
	BrandName  string `json:"brand_name,omitempty"`
	LogoImage  string `json:"logo_image,omitempty"`
	LocaleCode string `json:"locale_code,omitempty"`
}

type PricingScheme struct {
	Version    int       `json:"version"`
	FixedPrice Money     `json:"fixed_price"`
	CreateTime time.Time `json:"create_time"`
	UpdateTime time.Time `json:"update_time"`
}

type PricingSchemeUpdate struct {
	BillingCycleSequence int           `json:"billing_cycle_sequence"`
	PricingScheme        PricingScheme `json:"pricing_scheme"`
}

type PricingSchemeUpdateRequest struct {
	Schemes []PricingSchemeUpdate `json:"pricing_schemes"`
}

type Product struct {
	ID          string          `json:"id,omitempty"`
	Name        string          `json:"name"`
	Description string          `json:"description,omitempty"`
	Category    ProductCategory `json:"category,omitempty"`
	Type        ProductType     `json:"type"`
	ImageUrl    string          `json:"image_url,omitempty"`
	HomeUrl     string          `json:"home_url,omitempty"`
}

type ProductCategory string //Doc: https://developer.paypal.com/docs/api/catalog-products/v1/#definition-product_category

type ProductListParameters struct {
	ListParams
}

type ProductType string

type PurchaseUnit struct {
	ReferenceID        string              `json:"reference_id"`
	Amount             *PurchaseUnitAmount `json:"amount,omitempty"`
	Payee              *PayeeForOrders     `json:"payee,omitempty"`
	Payments           *CapturedPayments   `json:"payments,omitempty"`
	PaymentInstruction *PaymentInstruction `json:"payment_instruction,omitempty"`
	Description        string              `json:"description,omitempty"`
	CustomID           string              `json:"custom_id,omitempty"`
	InvoiceID          string              `json:"invoice_id,omitempty"`
	ID                 string              `json:"id,omitempty"`
	SoftDescriptor     string              `json:"soft_descriptor,omitempty"`
	Shipping           *ShippingDetail     `json:"shipping,omitempty"`
	Items              []Item              `json:"items,omitempty"`
}

type PurchaseUnitAmount struct {
	Currency  string                       `json:"currency_code"`
	Value     string                       `json:"value"`
	Breakdown *PurchaseUnitAmountBreakdown `json:"breakdown,omitempty"`
}

type PurchaseUnitAmountBreakdown struct {
	ItemTotal        *Money `json:"item_total,omitempty"`
	Shipping         *Money `json:"shipping,omitempty"`
	Handling         *Money `json:"handling,omitempty"`
	TaxTotal         *Money `json:"tax_total,omitempty"`
	Insurance        *Money `json:"insurance,omitempty"`
	ShippingDiscount *Money `json:"shipping_discount,omitempty"`
	Discount         *Money `json:"discount,omitempty"`
}

type PurchaseUnitRequest struct {
	ReferenceID        string              `json:"reference_id,omitempty"`
	Amount             *PurchaseUnitAmount `json:"amount"`
	Payee              *PayeeForOrders     `json:"payee,omitempty"`
	Description        string              `json:"description,omitempty"`
	CustomID           string              `json:"custom_id,omitempty"`
	InvoiceID          string              `json:"invoice_id,omitempty"`
	SoftDescriptor     string              `json:"soft_descriptor,omitempty"`
	Items              []Item              `json:"items,omitempty"`
	Shipping           *ShippingDetail     `json:"shipping,omitempty"`
	PaymentInstruction *PaymentInstruction `json:"payment_instruction,omitempty"`
}

type RedirectURLs struct {
	ReturnURL string `json:"return_url,omitempty"`
	CancelURL string `json:"cancel_url,omitempty"`
}

type ReferralRequest struct {
	TrackingID            string                 `json:"tracking_id"`
	PartnerConfigOverride *PartnerConfigOverride `json:"partner_config_override,omitempty"`
	Operations            []Operation            `json:"operations,omitempty"`
	Products              []string               `json:"products,omitempty"`
	LegalConsents         []Consent              `json:"legal_consents,omitempty"`
}

type ReferralResponse struct {
	Links []Link `json:"links,omitempty"`
}

type Refund struct {
	ID            string     `json:"id,omitempty"`
	Amount        *Amount    `json:"amount,omitempty"`
	CreateTime    *time.Time `json:"create_time,omitempty"`
	State         string     `json:"state,omitempty"`
	CaptureID     string     `json:"capture_id,omitempty"`
	ParentPayment string     `json:"parent_payment,omitempty"`
	UpdateTime    *time.Time `json:"update_time,omitempty"`
	SaleID        string     `json:"sale_id,omitempty"`
}

type RefundCaptureRequest struct {
	Amount      *Money `json:"amount,omitempty"`
	InvoiceID   string `json:"invoice_id,omitempty"`
	NoteToPayer string `json:"note_to_payer,omitempty"`
}

type RefundResponse struct {
	ID     string              `json:"id,omitempty"`
	Amount *PurchaseUnitAmount `json:"amount,omitempty"`
	Status string              `json:"status,omitempty"`
	Links  []Link              `json:"links,omitempty"`
}

type Related struct {
	Sale          *Sale          `json:"sale,omitempty"`
	Authorization *Authorization `json:"authorization,omitempty"`
	Order         *Order         `json:"order,omitempty"`
	Capture       *Capture       `json:"capture,omitempty"`
	Refund        *Refund        `json:"refund,omitempty"`
}

type RestAPIIntegration struct {
	IntegrationMethod string            `json:"integration_method"`
	IntegrationType   string            `json:"integration_type"`
	ThirdPartyDetails ThirdPartyDetails `json:"third_party_details"`
}

type Sale struct {
	ID                        string     `json:"id,omitempty"`
	Amount                    *Amount    `json:"amount,omitempty"`
	TransactionFee            *Currency  `json:"transaction_fee,omitempty"`
	Description               string     `json:"description,omitempty"`
	CreateTime                *time.Time `json:"create_time,omitempty"`
	State                     string     `json:"state,omitempty"`
	ParentPayment             string     `json:"parent_payment,omitempty"`
	UpdateTime                *time.Time `json:"update_time,omitempty"`
	PaymentMode               string     `json:"payment_mode,omitempty"`
	PendingReason             string     `json:"pending_reason,omitempty"`
	ReasonCode                string     `json:"reason_code,omitempty"`
	ClearingTime              string     `json:"clearing_time,omitempty"`
	ProtectionEligibility     string     `json:"protection_eligibility,omitempty"`
	ProtectionEligibilityType string     `json:"protection_eligibility_type,omitempty"`
	BillingAgreementID        string     `json:"billing_agreement_id,omitempty"`
	Links                     []Link     `json:"links,omitempty"`
}

type SearchCartInfo struct {
	ItemDetails     []SearchItemDetails `json:"item_details"`
	TaxInclusive    *bool               `json:"tax_inclusive"`
	PayPalInvoiceID string              `json:"paypal_invoice_id"`
}

type SearchCheckoutOption struct {
	CheckoutOptionName  string `json:"checkout_option_name"`
	CheckoutOptionValue string `json:"checkout_option_value"`
}

type SearchItemDetails struct {
	ItemCode            string                 `json:"item_code"`
	ItemName            string                 `json:"item_name"`
	ItemDescription     string                 `json:"item_description"`
	ItemOptions         string                 `json:"item_options"`
	ItemQuantity        string                 `json:"item_quantity"`
	ItemUnitPrice       Money                  `json:"item_unit_price"`
	ItemAmount          Money                  `json:"item_amount"`
	DiscountAmount      *Money                 `json:"discount_amount"`
	AdjustmentAmount    *Money                 `json:"adjustment_amount"`
	GiftWrapAmount      *Money                 `json:"gift_wrap_amount"`
	TaxPercentage       string                 `json:"tax_percentage"`
	TaxAmounts          []SearchTaxAmount      `json:"tax_amounts"`
	BasicShippingAmount *Money                 `json:"basic_shipping_amount"`
	ExtraShippingAmount *Money                 `json:"extra_shipping_amount"`
	HandlingAmount      *Money                 `json:"handling_amount"`
	InsuranceAmount     *Money                 `json:"insurance_amount"`
	TotalItemAmount     Money                  `json:"total_item_amount"`
	InvoiceNumber       string                 `json:"invoice_number"`
	CheckoutOptions     []SearchCheckoutOption `json:"checkout_options"`
}

type SearchPayerInfo struct {
	AccountID     string               `json:"account_id"`
	EmailAddress  string               `json:"email_address"`
	PhoneNumber   *PhoneWithTypeNumber `json:"phone_number"`
	AddressStatus string               `json:"address_status"`
	PayerStatus   string               `json:"payer_status"`
	PayerName     SearchPayerName      `json:"payer_name"`
	CountryCode   string               `json:"country_code"`
	Address       *Address             `json:"address"`
}

type SearchPayerName struct {
	GivenName string `json:"given_name"`
	Surname   string `json:"surname"`
}

type SearchShippingInfo struct {
	Name                     string   `json:"name"`
	Method                   string   `json:"method"`
	Address                  Address  `json:"address"`
	SecondaryShippingAddress *Address `json:"secondary_shipping_address"`
}

type SearchTaxAmount struct {
	TaxAmount Money `json:"tax_amount"`
}

type SearchTransactionDetails struct {
	TransactionInfo SearchTransactionInfo `json:"transaction_info"`
	PayerInfo       *SearchPayerInfo      `json:"payer_info"`
	ShippingInfo    *SearchShippingInfo   `json:"shipping_info"`
	CartInfo        *SearchCartInfo       `json:"cart_info"`
}

type SearchTransactionInfo struct {
	PayPalAccountID           string   `json:"paypal_account_id"`
	TransactionID             string   `json:"transaction_id"`
	PayPalReferenceID         string   `json:"paypal_reference_id"`
	PayPalReferenceIDType     string   `json:"paypal_reference_id_type"`
	TransactionEventCode      string   `json:"transaction_event_code"`
	TransactionInitiationDate JSONTime `json:"transaction_initiation_date"`
	TransactionUpdatedDate    JSONTime `json:"transaction_updated_date"`
	TransactionAmount         Money    `json:"transaction_amount"`
	FeeAmount                 *Money   `json:"fee_amount"`
	InsuranceAmount           *Money   `json:"insurance_amount"`
	ShippingAmount            *Money   `json:"shipping_amount"`
	ShippingDiscountAmount    *Money   `json:"shipping_discount_amount"`
	ShippingTaxAmount         *Money   `json:"shipping_tax_amount"`
	OtherAmount               *Money   `json:"other_amount"`
	TipAmount                 *Money   `json:"tip_amount"`
	TransactionStatus         string   `json:"transaction_status"`
	TransactionSubject        string   `json:"transaction_subject"`
	PaymentTrackingID         string   `json:"payment_tracking_id"`
	BankReferenceID           string   `json:"bank_reference_id"`
	TransactionNote           string   `json:"transaction_note"`
	EndingBalance             *Money   `json:"ending_balance"`
	AvailableBalance          *Money   `json:"available_balance"`
	InvoiceID                 string   `json:"invoice_id"`
	CustomField               string   `json:"custom_field"`
	ProtectionEligibility     string   `json:"protection_eligibility"`
	CreditTerm                string   `json:"credit_term"`
	CreditTransactionalFee    *Money   `json:"credit_transactional_fee"`
	CreditPromotionalFee      *Money   `json:"credit_promotional_fee"`
	AnnualPercentageRate      string   `json:"annual_percentage_rate"`
	PaymentMethodType         string   `json:"payment_method_type"`
}

type SellerProtection struct {
	Status            string   `json:"status,omitempty"`
	DisputeCategories []string `json:"dispute_categories,omitempty"`
}

type SellerReceivableBreakdown struct {
	GrossAmount                   *Money        `json:"gross_amount,omitempty"`
	PaypalFee                     *Money        `json:"paypal_fee,omitempty"`
	PaypalFeeInReceivableCurrency *Money        `json:"paypal_fee_in_receivable_currency,omitempty"`
	NetAmount                     *Money        `json:"net_amount,omitempty"`
	ReceivableAmount              *Money        `json:"receivable_amount,omitempty"`
	ExchangeRate                  *ExchangeRate `json:"exchange_rate,omitempty"`
	PlatformFees                  []PlatformFee `json:"platform_fees,omitempty"`
}

type SenderBatchHeader struct {
	EmailSubject  string `json:"email_subject"`
	EmailMessage  string `json:"email_message"`
	SenderBatchID string `json:"sender_batch_id,omitempty"`
}

type SetupFeeFailureAction string

type SharedListResponse struct {
	TotalItems int    `json:"total_items,omitempty"`
	TotalPages int    `json:"total_pages,omitempty"`
	Links      []Link `json:"links,omitempty"`
}

type SharedResponse struct {
	CreateTime string `json:"create_time"`
	UpdateTime string `json:"update_time"`
	Links      []Link `json:"links"`
}

type ShippingAddress struct {
	RecipientName string `json:"recipient_name,omitempty"`
	Type          string `json:"type,omitempty"`
	Line1         string `json:"line1"`
	Line2         string `json:"line2,omitempty"`
	City          string `json:"city"`
	CountryCode   string `json:"country_code"`
	PostalCode    string `json:"postal_code,omitempty"`
	State         string `json:"state,omitempty"`
	Phone         string `json:"phone,omitempty"`
}

type ShippingAmount struct {
	Money
}

type ShippingDetail struct {
	Name    *Name                          `json:"name,omitempty"`
	Address *ShippingDetailAddressPortable `json:"address,omitempty"`
}

type ShippingDetailAddressPortable struct {
	AddressLine1 string `json:"address_line_1,omitempty"`
	AddressLine2 string `json:"address_line_2,omitempty"`
	AdminArea1   string `json:"admin_area_1,omitempty"`
	AdminArea2   string `json:"admin_area_2,omitempty"`
	PostalCode   string `json:"postal_code,omitempty"`
	CountryCode  string `json:"country_code,omitempty"`
}

type ShippingPreference string

type StandardEntryClassCode string // Doc: https://developer.paypal.com/api/orders/v2/#definition-payment_method

type Subscriber struct {
	PayerID         string               `json:"payer_id"`
	ShippingAddress *ShippingDetail      `json:"shipping_address,omitempty"`
	Name            CreateOrderPayerName `json:"name,omitempty"`
	EmailAddress    string               `json:"email_address,omitempty"`
}

type Subscription struct {
	SubscriptionDetailResp
}

type SubscriptionBase struct {
	PlanID             string              `json:"plan_id"`
	StartTime          *JSONTime           `json:"start_time,omitempty"`
	EffectiveTime      *JSONTime           `json:"effective_time,omitempty"`
	Quantity           string              `json:"quantity,omitempty"`
	ShippingAmount     *Money              `json:"shipping_amount,omitempty"`
	Subscriber         *Subscriber         `json:"subscriber,omitempty"`
	AutoRenewal        bool                `json:"auto_renewal,omitempty"`
	ApplicationContext *ApplicationContext `json:"application_context,omitempty"`
	CustomID           string              `json:"custom_id,omitempty"`
	Plan               *PlanOverride       `json:"plan,omitempty"`
}

type SubscriptionCaptureResponse struct {
	Status              SubscriptionTransactionStatus `json:"status"`
	Id                  string                        `json:"id"`
	AmountWithBreakdown AmountWithBreakdown           `json:"amount_with_breakdown"`
	PayerName           Name                          `json:"payer_name"`
	PayerEmail          string                        `json:"payer_email"`
	Time                time.Time                     `json:"time"`
}

type SubscriptionDetailResp struct {
	SubscriptionBase
	SubscriptionDetails
	BillingInfo BillingInfo `json:"billing_info,omitempty"` // not found in documentation
	SharedResponse
}

type SubscriptionDetails struct {
	ID                           string             `json:"id,omitempty"`
	SubscriptionStatus           SubscriptionStatus `json:"status,omitempty"`
	SubscriptionStatusChangeNote string             `json:"status_change_note,omitempty"`
	StatusUpdateTime             time.Time          `json:"status_update_time,omitempty"`
}

type SubscriptionPlan struct {
	ID                 string                 `json:"id,omitempty"`
	ProductId          string                 `json:"product_id"`
	Name               string                 `json:"name"`
	Status             SubscriptionPlanStatus `json:"status"`
	Description        string                 `json:"description,omitempty"`
	BillingCycles      []BillingCycle         `json:"billing_cycles"`
	PaymentPreferences *PaymentPreferences    `json:"payment_preferences"`
	Taxes              *Taxes                 `json:"taxes"`
	QuantitySupported  bool                   `json:"quantity_supported"` //Indicates whether you can subscribe to this plan by providing a quantity for the goods or service.
}

type SubscriptionPlanListParameters struct {
	ProductId string `json:"product_id"`
	PlanIds   string `json:"plan_ids"` // Filters the response by list of plan IDs. Filter supports upto 10 plan IDs.
	ListParams
}

type SubscriptionPlanStatus string

type SubscriptionStatus string

type SubscriptionTransactionStatus string

type SubscriptionTransactionsParams struct {
	SubscriptionId string
	StartTime      time.Time
	EndTime        time.Time
}

type SubscriptionTransactionsResponse struct {
	Transactions []SubscriptionCaptureResponse `json:"transactions"`
	SharedListResponse
}

type TaxInfo struct {
	TaxID     string `json:"tax_id,omitempty"`
	TaxIDType string `json:"tax_id_type,omitempty"`
}

type Taxes struct {
	Percentage string `json:"percentage"`
	Inclusive  bool   `json:"inclusive"`
}

type TaxesOverride struct {
	Percentage string `json:"percentage,omitempty"`
	Inclusive  *bool  `json:"inclusive,omitempty"`
}

type TenureType string

type TextField struct {
	Is string
	// contains filtered or unexported fields
}

type ThirdPartyDetails struct {
	Features []string `json:"features"`
}

type TimeField struct {
	Is time.Time
	// contains filtered or unexported fields
}

type TokenResponse struct {
	RefreshToken string         `json:"refresh_token"`
	Token        string         `json:"access_token"`
	Type         string         `json:"token_type"`
	ExpiresIn    expirationTime `json:"expires_in"`
}

type Transaction struct {
	Amount           *Amount         `json:"amount"`
	Description      string          `json:"description,omitempty"`
	ItemList         *ItemList       `json:"item_list,omitempty"`
	InvoiceNumber    string          `json:"invoice_number,omitempty"`
	Custom           string          `json:"custom,omitempty"`
	SoftDescriptor   string          `json:"soft_descriptor,omitempty"`
	RelatedResources []Related       `json:"related_resources,omitempty"`
	PaymentOptions   *PaymentOptions `json:"payment_options,omitempty"`
	NotifyURL        string          `json:"notify_url,omitempty"`
	OrderURL         string          `json:"order_url,omitempty"`
	Payee            *Payee          `json:"payee,omitempty"`
}

type TransactionSearchRequest struct {
	TransactionID               *string
	TransactionType             *string
	TransactionStatus           *string
	TransactionAmount           *string
	TransactionCurrency         *string
	StartDate                   time.Time
	EndDate                     time.Time
	PaymentInstrumentType       *string
	StoreID                     *string
	TerminalID                  *string
	Fields                      *string
	BalanceAffectingRecordsOnly *string
	PageSize                    *int
	Page                        *int
}

type TransactionSearchResponse struct {
	TransactionDetails  []SearchTransactionDetails `json:"transaction_details"`
	AccountNumber       string                     `json:"account_number"`
	StartDate           JSONTime                   `json:"start_date"`
	EndDate             JSONTime                   `json:"end_date"`
	LastRefreshDatetime JSONTime                   `json:"last_refreshed_datetime"`
	Page                int                        `json:"page"`
	SharedListResponse
}

type UserAction string

type UserInfo struct {
	ID              string   `json:"user_id"`
	Name            string   `json:"name"`
	GivenName       string   `json:"given_name"`
	FamilyName      string   `json:"family_name"`
	Email           string   `json:"email"`
	Verified        bool     `json:"verified,omitempty,string"`
	Gender          string   `json:"gender,omitempty"`
	BirthDate       string   `json:"birthdate,omitempty"`
	ZoneInfo        string   `json:"zoneinfo,omitempty"`
	Locale          string   `json:"locale,omitempty"`
	Phone           string   `json:"phone_number,omitempty"`
	Address         *Address `json:"address,omitempty"`
	VerifiedAccount bool     `json:"verified_account,omitempty,string"`
	AccountType     string   `json:"account_type,omitempty"`
	AgeRange        string   `json:"age_range,omitempty"`
	PayerID         string   `json:"payer_id,omitempty"`
}

type VerifyWebhookResponse struct {
	VerificationStatus string `json:"verification_status,omitempty"`
}

type WebProfile struct {
	ID           string       `json:"id,omitempty"`
	Name         string       `json:"name"`
	Presentation Presentation `json:"presentation,omitempty"`
	InputFields  InputFields  `json:"input_fields,omitempty"`
	FlowConfig   FlowConfig   `json:"flow_config,omitempty"`
}

type Webhook struct {
	ID         string             `json:"id"`
	URL        string             `json:"url"`
	EventTypes []WebhookEventType `json:"event_types"`
	Links      []Link             `json:"links"`
}

type WebhookEventType struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Status      string `json:"status,omitempty"`
}

type WebhookEventTypesResponse struct {
	EventTypes []WebhookEventType `json:"event_types"`
}

type WebhookField struct {
	Operation string      `json:"op"`
	Path      string      `json:"path"`
	Value     interface{} `json:"value"`
}