sharedwallet

Documentation

Overview

Package sharedwallet 资金共享

Index

• type AccountRelationGetRequest
  • func (r AccountRelationGetRequest) Encode() string
• type AccountRelationGetResponse
• type AccountRelationGetResult
• type AllocatedBalance
• type BalanceBillingInventory
• type BalanceDetail
• type BalanceGetRequest
  • func (r BalanceGetRequest) Encode() string
• type BalanceGetResponse
• type BalanceInfo
• type BalanceStatus
• type BasicBalanceInfo
• type CanTransferBalanceRequest
  • func (r CanTransferBalanceRequest) Encode() string
• type CanTransferBalanceResponse
• type CanTransferDetail
• type CapitalDetail
• type CapitalType
• type CommonWalletInfo
• type DailyStat
• type DailyStatGetRequest
  • func (r DailyStatGetRequest) Encode() string
• type DailyStatGetResponse
• type DailyStatGetResult
• type DeliveryType
• type GeneralBalanceInfo
• type MainSharedRange
• type MainSharedRangeItem
• type MainWalletGetRequest
  • func (r MainWalletGetRequest) Encode() string
• type MainWalletGetResponse
• type MainWalletInfo
• type PayeeTransferAmountDetail
• type RemitterCapitalDetail
• type SharedMainWalletInfo
• type SubSharedRange
• type SubWalletInfo
• type TargetWalletDetail
• type TransactionDetail
• type TransactionDetailGetRequest
  • func (r TransactionDetailGetRequest) Encode() string
• type TransactionDetailGetResponse
• type TransactionDetailGetResult
• type TransferCapitalRecord
• type TransferCreateRequest
  • func (r TransferCreateRequest) Encode() []byte
• type TransferCreateResponse
• type TransferDetail
• type TransferDetailRequest
  • func (r TransferDetailRequest) Encode() string
• type TransferDetailResponse
• type TransferListRequest
  • func (r TransferListRequest) Encode() string
• type TransferListResponse
• type TransferRecord
• type TransferWalletRecord
• type UnallocatedBalance
• type WalletBalanceFilter
• type WalletBalanceGetRequest
  • func (r WalletBalanceGetRequest) Encode() string
• type WalletBalanceGetResponse
• type WalletBalanceInfo
• type WalletBasicBalanceInfo
• type WalletInfo
• type WalletInfoGetRequest
  • func (r WalletInfoGetRequest) Encode() string
• type WalletInfoGetResponse
• type WalletRelation
• type WalletRelationGetRequest
  • func (r WalletRelationGetRequest) Encode() string
• type WalletRelationGetResponse
• type WalletRelationGetResult

Types

type AccountRelationGetRequest

type AccountRelationGetRequest struct {
	// AccountID 账户ID，对于巨量AD、千川、本地推是广告主ID，对于代理商是代理商ID
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType string `json:"account_type,omitempty"`
}

AccountRelationGetRequest 资金共享-查询账户对应公司下的钱包关系 API Request

func (AccountRelationGetRequest) Encode

func (r AccountRelationGetRequest) Encode() string

Encode implements GetRequest interface

type AccountRelationGetResponse

type AccountRelationGetResponse struct {
	model.BaseResponse
	Data *AccountRelationGetResult `json:"data,omitempty"`
}

AccountRelationGetResponse 资金共享-查询账户对应公司下的钱包关系 API Response

type AccountRelationGetResult

type AccountRelationGetResult struct {
	// CompanyID 客户公司ID
	CompanyID uint64 `json:"company_id,omitempty"`
	// MainWalletID 共享钱包ID
	MainWalletID uint64 `json:"main_wallet_id,omitempty"`
	// SubWalletIDs 子钱包ID列表
	SubWalletIDs []uint64 `json:"sub_wallet_ids,omitempty"`
}

type AllocatedBalance

type AllocatedBalance struct {
	// AdOnlyAllocatedBalance 巨量广告业务线待分配余额(单位元)
	AdOnlyAllocatedBalance *WalletBasicBalanceInfo `json:"ad_only_allocated_balance,omitempty"`
	// EcpOnlyAllocatedBalance 巨量千川业务线待分配余额(单位元)
	EcpOnlyAllocatedBalance *WalletBasicBalanceInfo `json:"ecp_only_allocated_balance,omitempty"`
	// LocalOnlyAllocatedBalance 巨量本地推业务线待分配余额(单位元)
	LocalOnlyAllocatedBalance *WalletBasicBalanceInfo `json:"local_only_allocated_balance,omitempty"`
	// AdSharedAllocatedBalance 巨量广告/千川/本地推业务线待分配余额(单位元)
	AdSharedAllocatedBalance *WalletBasicBalanceInfo `json:"ad_shared_allocated_balance,omitempty"`
}

AllocatedBalance 钱包已分配余额(单位元)

type BalanceBillingInventory

type BalanceBillingInventory string

BalanceBillingInventory 余额可用广告位

const (
	// BalanceBillingInventory_DEFAULT 默认
	BalanceBillingInventory_DEFAULT BalanceBillingInventory = "DEFAULT"
	// BalanceBillingInventory_SEARCH 搜索
	BalanceBillingInventory_SEARCH BalanceBillingInventory = "SEARCH"
	// BalanceBillingInventory_UNION 穿山甲
	BalanceBillingInventory_UNION BalanceBillingInventory = "UNION"
	// BalanceBillingInventory_COMMON 通用
	BalanceBillingInventory_COMMON BalanceBillingInventory = "COMMON"
)

type BalanceDetail

type BalanceDetail struct {
	// Balance 余额，单位：元，精度：两位小数
	Balance float64 `json:"balance,omitempty"`
	// BillingInventory 余额可用广告位，DEFAULT：默认、SEARCH：搜索、UNION：穿山甲、COMMON：通用
	BillingInventory string `json:"billing_inventory,omitempty"`
}

BalanceDetail 余额详情

type BalanceGetRequest

type BalanceGetRequest struct {
	// AdvertiserIDs 广告主ID列表，长度1-100
	AdvertiserIDs []uint64 `json:"advertiser_ids,omitempty"`
}

BalanceGetRequest 获取共享钱包余额 API Request

func (BalanceGetRequest) Encode

func (r BalanceGetRequest) Encode() string

Encode implement GetRequest interface

type BalanceGetResponse

type BalanceGetResponse struct {
	model.BaseResponse
	// Data json返回值
	Data struct {
		// List 账户列表
		List []BalanceInfo `json:"list,omitempty"`
	} `json:"data,omitempty"`
}

BalanceGetResponse 获取共享钱包余额 API Response

type BalanceInfo

type BalanceInfo struct {
	// AdvertiserID 账户id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// BalanceDetail 余额详情列表
	BalanceDetail []BalanceDetail `json:"balance_detail,omitempty"`
	// Status 余额查询状态，SUCCESS：成功、FAIL：失败、NO_WALLET：钱包不存在
	Status BalanceStatus `json:"status,omitempty"`
	// StatusMessage 状态说明
	StatusMessage string `json:"status_message,omitempty"`
}

BalanceInfo 共享钱包余额

type BalanceStatus

type BalanceStatus string

BalanceStatus 余额查询状态

const (
	// BalanceStatus_SUCCESS 成功
	BalanceStatus_SUCCESS BalanceStatus = "SUCCESS"
	// BalanceStatus_FAIL 失败
	BalanceStatus_FAIL BalanceStatus = "FAIL"
	// BalanceStatus_NO_WALLET 钱包不存在
	BalanceStatus_NO_WALLET BalanceStatus = "NO_WALLET"
)

type BasicBalanceInfo

type BasicBalanceInfo struct {
	// TotalBalance 总余额(单位元)
	TotalBalance float64 `json:"total_balance,omitempty"`
	// TotalValidBalance 总可用余额(单位元)
	TotalValidBalance float64 `json:"total_valid_balance,omitempty"`
	// TotalTransferableBalance 总可转余额(单位元)
	TotalTransferableBalance float64 `json:"total_transferable_balance,omitempty"`
	// NonGrantBalance 非赠款总余额(单位元)
	NonGrantBalance float64 `json:"non_grant_balance,omitempty"`
	// NonGrantValidBalance 非赠款可用余额(单位元)                         n
	NonGrantValidBalance float64 `json:"non_grant_valid_balance,omitempty"`
	// NonGrantTransferableBalance 非赠款可转余额(单位元)                                                        n
	NonGrantTransferableBalance float64 `json:"non_grant_transferable_balance,omitempty"`
	// PrepayBiddingBalance 预付竞价可用余额(单位元)
	PrepayBiddingBalance float64 `json:"prepay_bidding_balance,omitempty"`
	// PrepayBiddingValidBalance 预付竞价可用余额(单位元)
	PrepayBiddingValidBalance float64 `json:"prepay_bidding_valid_balance,omitempty"`
	// PrepayBrandBalance 预付品牌可用余额(单位元)
	PrepayBrandBalance float64 `json:"prepay_brand_balance,omitempty"`
	// PrepayBrandValidBalance 预付品牌可用余额(单位元)
	PreBrandValidBalance float64 `json:"prepay_brand_valid_balance,omitempty"`
	// PrepayGeneralBalance 预付通用可用余额(单位元)
	PrepayGeneralBalance float64 `json:"prepay_general_balance,omitempty"`
	// PrepayGeneralValidBalance 预付通用可用余额(单位元)
	PrepayGeneralValidBalance float64 `json:"prepay_general_valid_balance,omitempty"`
	// CreditBiddingBalance 授信竞价可用余额(单位元)
	CreditBiddingBalance float64 `json:"credit_bidding_balance,omitempty"`
	// CreditBiddingValidBalance 授信竞价可用余额(单位元)
	CreditBiddingValidBalance float64 `json:"credit_bidding_valid_balance,omitempty"`
	// CreditBrandBalance 授信品牌可用余额(单位元)
	CreditBrandBalance float64 `json:"credit_brand_balance,omitempty"`
	// CreditBrandValidBalance 授信品牌可用余额(单位元)
	CreditBrandValidBalance float64 `json:"credit_brand_valid_balance,omitempty"`
	// CreditGeneralBalance 授信通用可用余额(单位元)
	CreditGeneralBalance float64 `json:"credit_general_balance,omitempty"`
	// CreditGeneralValidBalance 授信通用可用余额(单位元)
	CreditGeneralValidBalance float64 `json:"credit_general_valid_balance,omitempty"`
}

BasicBalanceInfo 常用余额信息

type CanTransferBalanceRequest

type CanTransferBalanceRequest struct {
	// AccountID 鉴权账户
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 鉴权账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType string `json:"account_type,omitempty"`
	// BizRequestNo 请求id，推荐uuid，方便请求链路对齐
	BizRequestNo string `json:"biz_request_no,omitempty"`
	// MainWalletID 大钱包id
	MainWalletID uint64 `json:"main_wallet_id,omitempty"`
	// SubWalletList 小钱包id列表
	SubWalletList []uint64 `json:"sub_wallet_list,omitempty"`
	// TransferDirection 转账方向，以小钱包视角确定 可选值:
	// TRANSFER_IN 转入
	// TRANSFER_OUT 转出
	TransferDirection enum.TransferDirection `json:"transfer_direction,omitempty"`
}

CanTransferBalanceRequest 资金共享-最大可转余额查询 API Request

func (CanTransferBalanceRequest) Encode

func (r CanTransferBalanceRequest) Encode() string

Encode implements GetRequest interface

type CanTransferBalanceResponse

type CanTransferBalanceResponse struct {
	model.BaseResponse
	Data struct {
		// CanTransferDetailList 可转余额信息列表
		CanTransferDetailList []CanTransferDetail `json:"can_transfer_detail_list,omitempty"`
	} `json:"data,omitempty"`
}

CanTransferBalanceResponse 资金共享-最大可转余额查询 API Response

type CanTransferDetail

type CanTransferDetail struct {
	// RemitterWalletID 减款钱包id
	RemitterWalletID uint64 `json:"remitter_wallet_id,omitempty"`
	// NonBrandMaxTransferBalance 减款钱包非品牌资金最大可转出金额（单位：分）
	NonBrandMaxTransferBalance int64 `json:"non_brand_max_transfer_balance,omitempty"`
	// RemitterCapitalDetailList 减款钱包可转资金列表
	RemitterCapitalDetailList []RemitterCapitalDetail `json:"remitter_capital_detail_list,omitempty"`
	// PayeeTransferAmountDetailList 加款钱包可转余额信息列表
	PayeeTransferAmountDetailList []PayeeTransferAmountDetail `json:"payee_transfer_amount_detail_list,omitempty"`
}

CanTransferDetail 可转余额信息

type CapitalDetail

type CapitalDetail struct {
	// Platform 业务线 可选值:
	// AD 广告
	// AD_ALL 广告通用
	// BENDITUI 本地推
	// QIANCHUAN 千川
	// STAR 星图
	Platform string `json:"platform,omitempty"`
	// CapitalType 可转资金类型 可选值:
	// CREDIT_BIDDING 授信竞价
	// CREDIT_BRAND 授信品牌
	// CREDIT_GENERAL 授信通用
	// PREPAY_BIDDING 预付竞价
	// PREPAY_BRAND 预付品牌
	// PREPAY_GENERAL 预付通用
	CapitalType enum.CapitalType `json:"capital_type,omitempty"`
	// TransferBalance 可转资金金额(单位：分)
	TransferBalance int64 `json:"transfer_balance,omitempty"`
}

CapitalDetail 加款钱包可转资金

type CapitalType

type CapitalType string

CapitalType 资金类型包括 预付、授信

const (
	// CapitalType_CREDIT 授信
	CapitalType_CREDIT CapitalType = "CREDIT"
	// CapitalType_NO_LIMIT 不限
	CapitalType_NO_LIMIT CapitalType = "NO_LIMIT"
	// CapitalType_PREPAY 预付
	CapitalType_PREPAY CapitalType = "PREPAY"
)

type CommonWalletInfo

type CommonWalletInfo struct {
	// WalletName 钱包名称
	WalletName string `json:"wallet_name,omitempty"`
	// WalletDescription 钱包描述
	WalletDescription string `json:"wallet_description,omitempty"`
	// WalletLabel 钱包标签
	WalletLabel string `json:"wallet_label,omitempty"`
	// SharedWalletStatus 钱包状态 可选值:
	// DEFUALT 默认测试
	SharedWalletStatus string `json:"shared_wallet_status,omitempty"`
	// CreateTime 钱包创建时间
	CreateTime string `json:"create_time,omitempty"`
}

CommonWalletInfo 通用钱包信息

type DailyStat

type DailyStat struct {
	// TransactionDate 日期,精确到天，格式YYYY-MM-DD
	TransactionDate string `json:"transaction_date,omitempty"`
	// SharedWalletID 共享钱包ID
	SharedWalletID uint64 `json:"shared_wallet_id,omitempty"`
	// SharedWalletName 共享钱包名称
	SharedWalletName string `json:"shared_wallet_name,omitempty"`
	// WalletType 共享钱包类型 可选值:
	// MAIN_WALLET 共享钱包 即大钱包
	// SUB_CONSUME_WALLET 投放子钱包，可以挂多个广告主，可以投放
	// SUB_MANAGE_WALLET 管理子钱包，只能挂一个广告主（如代理商），不能投放
	WalletType enum.SharedWalletType `json:"wallet_type,omitempty"`
	// Balance 日终结余(单位元）
	Balance float64 `json:"balance,omitempty"`
	// PrepayBalance 预付日终结余(单位元）
	PrepayBalance float64 `json:"prepay_balance,omitempty"`
	// CreditBalance 授信日终结余(单位元）
	CreditBalance float64 `json:"credit_balance,omitempty"`
	// Incomes 总存入(单位元)
	Incomes float64 `json:"incomes,omitempty"`
	// Expenses 总支出(单位元)
	Expenses float64 `json:"expenses,omitempty"`
	// Cost 总消耗(单位元)
	Cost float64 `json:"cost,omitempty"`
}

DailyStat 日流水列表信息

type DailyStatGetRequest

type DailyStatGetRequest struct {
	// AccountID 账户ID，对于巨量AD、千川、本地推是广告主ID，对于代理商是代理商ID
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType enum.AccountType `json:"account_type,omitempty"`
	// SharedWalletID 共享钱包ID
	SharedWalletID uint64 `json:"shared_wallet_id,omitempty"`
	// StartDate 开始时间，格式YYYY-MM-DD
	StartDate string `json:"start_date,omitempty"`
	// EndDate 结束时间，格式YYYY-MM-DD
	EndDate string `json:"end_date,omitempty"`
	// Page 页码；默认为1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小；默认为10; 注意：page*page_size不可大于10000
	PageSize int `json:"page_size,omitempty"`
}

DailyStatGetRequest 资金共享-查询共享钱包日流水 API Request

func (DailyStatGetRequest) Encode

func (r DailyStatGetRequest) Encode() string

Encode implements GetRequest interface

type DailyStatGetResponse

type DailyStatGetResponse struct {
	model.BaseResponse
	Data *DailyStatGetResult `json:"data,omitempty"`
}

DailyStatGetResponse 资金共享-查询共享钱包日流水 API Response

type DailyStatGetResult

type DailyStatGetResult struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// Results 流水明细结果
	Results []DailyStat `json:"results,omitempty"`
}

type DeliveryType

type DeliveryType string

DeliveryType 投放类型：竞价、品牌、通用

const (
	// DeliveryType_BIDDING 竞价
	DeliveryType_BIDDING DeliveryType = "BIDDING"
	// DeliveryType_BRAND 品牌
	DeliveryType_BRAND DeliveryType = "BRAND"
	// DeliveryType_GENERAL 通用
	DeliveryType_GENERAL DeliveryType = "GENERAL"
	// DeliveryType_NO_LIMIT 不过滤
	DeliveryType_NO_LIMIT DeliveryType = "NO_LIMIT"
)

type GeneralBalanceInfo

type GeneralBalanceInfo struct {
	// AdOnlyBalanceInfo 巨量广告业务线余额信息
	AdOnlyBalanceInfo *BasicBalanceInfo `json:"ad_only_balance_info,omitempty"`
	// EcpOnlyBalanceInfo 巨量千川业务线余额信息
	EcpOnlyBalanceInfo *BasicBalanceInfo `json:"ecp_only_balance_info,omitempty"`
	// LocalOnlyBalanceInfo 巨量本地推业务线余额信息
	LocalOnlyBalanceInfo *BasicBalanceInfo `json:"local_only_balance_info,omitempty"`
	// AdSharedBalanceInfo 巨量AD/千川/本地推业务线余额信息
	AdSharedBalanceInfo *BasicBalanceInfo `json:"ad_shared_balance_info,omitempty"`
}

GeneralBalanceInfo 通用余额信息

type MainSharedRange

type MainSharedRange struct {
	// Items
	Items []MainSharedRangeItem `json:"items,omitempty"`
}

MainSharedRange 大钱包共享范围

type MainSharedRangeItem

type MainSharedRangeItem struct {
	// AccountPlatform 账户业务线 可选值:
	// AD 巨量广告
	// ECP 巨量千川
	// LOCAL_ADS 巨量本地推
	AccountPlatform string `json:"account_platform,omitempty"`
	// CustomerCategory 客户类型 可选值:
	// AGENT 代理商
	// DIRECT 直客
	// PARTNER 合作方
	// SELF_SERVICE 自助客户
	// SVIP_CUSTOMER VIP大型客户
	// VIRTUAL_CUS 虚客
	CustomerCategory []enum.CustomerCategory `json:"customer_category,omitempty"`
}

type MainWalletGetRequest

type MainWalletGetRequest struct {
	// AccountID 账户ID，对于巨量AD、千川、本地推是广告主ID，对于代理商是代理商ID
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType enum.AccountType `json:"account_type,omitempty"`
	// MainWalletID 共享钱包ID即大钱包ID
	MainWalletID uint64 `json:"main_wallet_id,omitempty"`
}

MainWalletGetRequest 资金共享-共享钱包信息查询 API Request

func (MainWalletGetRequest) Encode

func (r MainWalletGetRequest) Encode() string

Encode implments GetRequest interface

type MainWalletGetResponse

type MainWalletGetResponse struct {
	model.BaseResponse
	// Data 资金共享大钱包信息
	Data *MainWalletInfo `json:"data,omitempty"`
}

MainWalletGetResponse 资金共享-共享钱包信息查询 API Response

type MainWalletInfo

type MainWalletInfo struct {
	// MainWalletID 大钱包ID
	MainWalletID uint64 `json:"main_wallet_id,omitempty"`
	CommonWalletInfo
	// TotalBalance 钱包总余额(单位元)
	TotalBalance float64 `json:"total_balance,omitempty"`
	// UnallocatedBalance 钱包待分配余额(单位元)
	UnallocatedBalance *UnallocatedBalance `json:"unallocated_balance,omitempty"`
	// AllocatedBalance 钱包已分配余额(单位元)
	AllocatedBalance *AllocatedBalance `json:"allocated_balance,omitempty"`
}

MainWalletInfo 资金共享大钱包信息

type PayeeTransferAmountDetail

type PayeeTransferAmountDetail struct {
	// PayeeWalletID 加款钱包id
	PayeeWalletID uint64 `json:"payee_wallet_id,omitempty"`
	// NonBrandMinTransferBalance 加款钱包非品牌资金最小转入金额（单位：分）
	NonBrandMinTransferBalance int64 `json:"non_brand_min_transfer_balance,omitempty"`
	// CapitalDetailList 加款钱包可转资金列表
	CapitalDetailList []CapitalDetail `json:"capital_detail_list,omitempty"`
}

PayeeTransferAmountDetail 加款钱包可转余额信息

type RemitterCapitalDetail

type RemitterCapitalDetail struct {
	// Platform 业务线 可选值:
	// AD 广告
	// AD_ALL 广告通用
	// BENDITUI 本地推
	// QIANCHUAN 千川
	// STAR 星图
	Platform string `json:"platform,omitempty"`
	// CapitalType 资金类型 可选值:
	// CREDIT_BIDDING 授信竞价
	// CREDIT_BRAND 授信品牌
	// CREDIT_GENERAL 授信通用
	// PREPAY_BIDDING 预付竞价
	// PREPAY_BRAND 预付品牌
	// PREPAY_GENERAL 预付通用
	CapitalType enum.CapitalType `json:"capital_type,omitempty"`
}

RemitterCapitalDetail 减款钱包可转资金

type SharedMainWalletInfo

type SharedMainWalletInfo struct {
	// CompanyID 公司ID
	CompanyID uint64 `json:"company_id,omitempty"`
	// MainSharedRange 大钱包共享范围
	MainSharedRange *MainSharedRange `json:"main_shared_range,omitempty"`
}

SharedMainWalletInfo 共享钱包(大钱包)信息

type SubSharedRange

type SubSharedRange struct {
	// AccountPlatformList 账户业务线范围
	AccountPlatformList []string `json:"account_platform_list,omitempty"`
}

SubSharedRange 小钱包共享范围

type SubWalletInfo

type SubWalletInfo struct {
	// MainWalletID 所属大钱包ID
	MainWalletID uint64 `json:"main_wallet_id,omitempty"`
	// AdvCnt 钱包下的 adv 数量
	AdvCnt int64 `json:"adv_cnt,omitempty"`
	// SubSharedRange 小钱包共享范围
	SubSharedRange *SubSharedRange `json:"sub_shared_range,omitempty"`
}

SubWalletInfo 投放钱包(小钱包)信息

type TargetWalletDetail

type TargetWalletDetail struct {
	// SubWallletID 申请转账的小钱包id
	SubWalletID uint64 `json:"sub_wallet_id,omitempty"`
	// TransferCapitalDetailList 申请转账资金列表
	TransferCapitalDetailList []CapitalDetail `json:"transfer_capital_detail_list,omitempty"`
}

TargetWalletDetail 申请转账的小钱包

type TransactionDetail

type TransactionDetail struct {
	// BusinessTime 交易时间,精确到秒
	BusinessTime string `json:"business_time,omitempty"`
	// TransactionSeq 交易流水id
	TransactionSeq uint64 `json:"transaction_seq,omitempty"`
	// BizType 流水类型(充值、退款等) 可选值:
	// ADJUST_DECREASE 调差减款
	// ADJUST_FREEZE 调差冻结/解冻
	// ADJUST_INCREASE 调差加款
	// CREDIT_RECHARGE 信控充值
	// CREDIT_REFUND 信控减款
	// INIT 钱包初始化
	// ORDER_PAY 订单支付
	// ORDER_WITHDRAW 订单还款
	// REFUND_FREEZE 冻结冻结/解冻
	// SHARED_CANCEL_RECHARGE 共享钱包充值撤销
	// SHARED_FROZEN_REFUND 共享钱包退款
	// SHARED_RECHARGE 共享钱包充值
	// TRANSFER 转账
	// TRANSFER_IN 转入
	// TRANSFER_OUT 转出
	BizType enum.TransactionBizType `json:"biz_type,omitempty"`
	// Payee 收款钱包ID
	Payee uint64 `json:"payee,omitempty"`
	// PayeeName 收款钱包名称
	PayeeName string `json:"payee_name,omitempty"`
	// Remitter 付款钱包ID
	Remitter uint64 `json:"remitter,omitempty"`
	// RemitterName 付款钱包名称
	RemitterName string `json:"remitter_name,omitempty"`
	// Amount 总金额(单位元)
	Amount float64 `json:"amount,omitempty"`
	// PrepayAmount 预付金额(单位元)
	PrepayAmount float64 `json:"prepay_amount,omitempty"`
	// CreditAmount 授信金额(单位元)
	CreditAmount float64 `json:"credit_amount,omitempty"`
}

TransactionDetail 流水明细

type TransactionDetailGetRequest

type TransactionDetailGetRequest struct {
	// AccountID 账户ID，对于巨量AD、千川、本地推是广告主ID，对于代理商是代理商ID
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType enum.AccountType `json:"account_type,omitempty"`
	// SharedWalletID 共享钱包ID
	SharedWalletID uint64 `json:"shared_wallet_id,omitempty"`
	// StartDate 开始时间，格式YYYY-MM-DD
	StartDate string `json:"start_date,omitempty"`
	// EndDate 结束时间，格式YYYY-MM-DD
	EndDate string `json:"end_date,omitempty"`
	// Page 页码；默认为1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小；默认为10; 注意：page*page_size不可大于10000
	PageSize int `json:"page_size,omitempty"`
}

TransactionDetailGetRequest 资金共享-查询共享钱包流水明细 API Request

func (TransactionDetailGetRequest) Encode

func (r TransactionDetailGetRequest) Encode() string

Encode implements GetRequest interface

type TransactionDetailGetResponse

type TransactionDetailGetResponse struct {
	model.BaseResponse
	Data *TransactionDetailGetResult `json:"data,omitempty"`
}

TransactionDetailGetResponse 资金共享-查询共享钱包流水明细 API Response

type TransactionDetailGetResult

type TransactionDetailGetResult struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// Results 流水明细结果
	Results []TransactionDetail `json:"results,omitempty"`
}

type TransferCapitalRecord

type TransferCapitalRecord struct {
	// CapitalType 转账资金类型 可选值:
	// CREDIT_BIDDING 授信竞价
	// CREDIT_BRAND 授信品牌
	// CREDIT_GENERAL 授信通用
	// PREPAY_BIDDING 预付竞价
	// PREPAY_BRAND 预付品牌
	// PREPAY_GENERAL 预付通用
	CapitalType enum.CapitalType `json:"capital_type,omitempty"`
	// TransferAmount 转账资金金额(单位：分)
	TransferAmount int64 `json:"transfer_amount,omitempty"`
	// TransferStatus 转账资金状态 可选值:
	// NO_TRANSFER 未转账
	// TRANSFER_FAILED 转账失败(终态)
	// TRANSFER_ING 转账中
	// TRANSFER_PART 转账部分成功(终态)
	// TRANSFER_SUCCESS 转账成功(终态)
	TransferStatus enum.TransferStatus `json:"transfer_status,omitempty"`
	// FailReason 失败原因
	FailReason string `json:"fail_reason,omitempty"`
	// Platform 转账业务线 可选值:
	// AD 广告
	// AD_ALL 广告通用
	// BENDITUI 本地推
	// QIANCHUAN 千川
	// STAR 星图
	Platform string `json:"platform,omitempty"`
	// TransferTargetFinishTime 完成时间yyyy-MM-dd HH:mm:ss
	TransferTargetFinishTime string `json:"transfer_target_finish_time,omitempty"`
	// TransferTargetCreateTime 创建时间yyyy-MM-dd HH:mm:ss
	TransferTargetCreateTime string `json:"transfer_target_create_time,omitempty"`
	// Remark 转账备注
	Remark string `json:"remark,omitempty"`
}

TransferCapitalRecord 转账资金

type TransferCreateRequest

type TransferCreateRequest struct {
	// AccountID 鉴权账户
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 鉴权账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType string `json:"account_type,omitempty"`
	// MainWalletID 大钱包id
	MainWalletID uint64 `json:"main_wallet_id,omitempty"`
	// TransferDirection 转账方向，以小钱包视角确定 可选值:
	// TRANSFER_IN 转入
	// TRANSFER_OUT 转出
	TransferDirection enum.TransferDirection `json:"transfer_direction,omitempty"`
	// TargetWalletDetailList 申请转账的小钱包列表
	TargetWalletDetailList []TargetWalletDetail `json:"target_wallet_detail_list,omitempty"`
}

TransferCreateRequest 资金共享-发起转账 API Request

func (TransferCreateRequest) Encode

func (r TransferCreateRequest) Encode() []byte

Encode implements PostRequest interface

type TransferCreateResponse

type TransferCreateResponse struct {
	model.BaseResponse
	Data struct {
		// TransferSerial 转账单编号
		TransfrSerial string `json:"transfer_serial,omitempty"`
	} `json:"data,omitempty"`
}

TransferCreateResponse 资金共享-发起转账 API Response

type TransferDetail

type TransferDetail struct {
	// TransferSerial 转账单号
	TransferSerial string `json:"transfer_serial,omitempty"`
	// BizRequestNo 幂等id
	BizRequestNo string `json:"biz_request_no,omitempty"`
	// TransferDirection 转账方向(以目标账户视角确定) 可选值:
	// TRANSFER_IN 转入
	// TRANSFER_OUT 转出
	TransferDirection enum.TransferDirection `json:"transfer_direction,omitempty"`
	// TransferAmount 转账总金额(单位：分)
	TransferAmount int64 `json:"transfer_amount,omitempty"`
	// TransferStatus 转账总状态 可选值:
	// NO_TRANSFER 未转账
	// TRANSFER_FAILED 转账失败(终态)
	// TRANSFER_ING 转账中
	// TRANSFER_PART 转账部分成功(终态)
	// TRANSFER_SUCCESS 转账成功(终态)
	TransferStatus enum.TransferStatus `json:"transfer_status,omitempty"`
	// TransferFinishTime 转账完成时间 yyyy-MM-dd HH:mm:ss
	TransferFinishTime string `json:"transfer_finish_time,omitempty"`
	// TransferCreateTime 转账创建时间yyyy-MM-dd HH:mm:ss
	TransferCreateTime string `json:"transfer_create_time,omitempty"`
}

TransferDetail 转账单信息

type TransferDetailRequest

type TransferDetailRequest struct {
	// AccountID 鉴权账户
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 鉴权账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType string `json:"account_type,omitempty"`
	// BizRequestNo 请求id，推荐uuid，方便请求链路对齐
	BizRequestNo string `json:"biz_request_no,omitempty"`
	// TransferBizRequestNo 发起转账的幂等id
	TransferBizRequestNo string `json:"transfer_biz_request_no,omitempty"`
	// TransferSerial 转账单号，与transfer_biz_request_no两者传其一即可
	TransferSerial string `json:"transfer_serial,omitempty"`
}

TransferDetailRequest 资金共享-查询转账单信息 API Request

func (TransferDetailRequest) Encode

func (r TransferDetailRequest) Encode() string

Encode implements GetRequest interface

type TransferDetailResponse

type TransferDetailResponse struct {
	model.BaseResponse
	// Data 转账单信息
	Data *TransferDetail `json:"data,omitempty"`
}

TransferDetailResponse 资金共享-查询转账单信息 API Response

type TransferListRequest

type TransferListRequest struct {
	// AccountID 鉴权账户
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 鉴权账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType string `json:"account_type,omitempty"`
	// BizRequestNo 请求id，推荐uuid，方便请求链路对齐
	BizRequestNo string `json:"biz_request_no,omitempty"`
	// QueryBeginTime 查询开始时间(转账创建时间) yyyy-MM-dd HH:mm:ss
	QueryBeginTime string `json:"query_begin_time,omitempty"`
	// QueryEndTime 查询结束时间(转账创建时间) yyyy-MM-dd HH:mm:ss
	QueryEndTime string `json:"query_end_time,omitempty"`
	// QueryWalletIDList 需要查询的大小钱包id，加款方与减款方都需要包含在内
	QueryWalletIDList []uint64 `json:"query_wallet_id_list,omitempty"`
	// PayeeID 加款方id，可选，需要包含在query_wallet_id_list
	PayeeID uint64 `json:"payee_id,omitempty"`
	// RemitterID 减款方id，可选，需要包含在query_wallet_id_list
	RemitterID uint64 `json:"remitter_id,omitempty"`
	// PageInfo 分页信息
	PageInfo struct {
		// PageNum 页码，从1开始，仅支持page_size * page_num < 1w的深度分页
		PageNum int `json:"page_num,omitempty"`
		// PageSize 分页大小，范围：1-100
		PageSize int `json:"page_size,omitempty"`
	} `json:"page_info,omitempty"`
}

TransferListRequest 资金共享-查询转账列表 API Request

func (TransferListRequest) Encode

func (r TransferListRequest) Encode() string

Encode implements GetRequest interface

type TransferListResponse

type TransferListResponse struct {
	model.BaseResponse
	Data struct {
		// RecordList 转账记录列表
		RecordList []TransferRecord `json:"record_list,omitempty"`
	} `json:"data,omitempty"`
}

TransferListResponse 资金共享-查询转账列表 API Response

type TransferRecord

type TransferRecord struct {
	// TransferOrderSerial 转账单编号
	TransferOrderSerial string `json:"transfer_order_serial,omitempty"`
	// BizRequestNo 转账申请幂等id
	BizRequestNo string `json:"biz_request_no,omitempty"`
	// RemitterID 减款方id
	RemitterID uint64 `json:"remitter_id,omitempty"`
	// RemitterCategory 减款方类别 可选值:
	// ACCOUNT 账户
	// WALLET 钱包
	RemitterCategory string `json:"remitter_category,omitempty"`
	// PayeeID 加款方id
	PayeeID uint64 `json:"payee_id,omitempty"`
	// PayeeCategory 加款方类别 可选值:
	// ACCOUNT 账户
	// WALLET 钱包
	PayeeCategory string `json:"payee_category,omitempty"`
	// TransferTargetAmount 加款方-减款方间转账金额(单位：分)
	TransferTargetAmount int64 `json:"transfer_target_amount,omitempty"`
	// TransferTargetStatus 加款方-减款方间转账状态 可选值:
	// NO_TRANSFER 未转账
	// TRANSFER_FAILED 转账失败(终态)
	// TRANSFER_ING 转账中
	// TRANSFER_PART 转账部分成功(终态)
	// TRANSFER_SUCCESS 转账成功(终态)
	TransferTargetStatus enum.TransferStatus `json:"transfer_target_status,omitempty"`
	// TransferCapitalRecordList 转账资金列表
	TransferCapitalRecordList []TransferCapitalRecord `json:"transfer_capital_record_list,omitempty"`
}

TransferRecord 转账记录

type TransferWalletRecord

type TransferWalletRecord struct {
	// MainWalletID 大钱包id
	MainWalletID uint64 `json:"main_wallet_id,omitempty"`
	// SubWalletID 小钱包id
	SubWalletID uint64 `json:"sub_wallet_id,omitempty"`
	// TransferAmount 转账金额(单位：分)
	TransferAmount int64 `json:"transfer_amount,omitempty"`
	// TransferStatus 转账总状态 可选值:
	// NO_TRANSFER 未转账
	// TRANSFER_FAILED 转账失败(终态)
	// TRANSFER_ING 转账中
	// TRANSFER_PART 转账部分成功(终态)
	// TRANSFER_SUCCESS 转账成功(终态)
	TransferStatus enum.TransferStatus `json:"transfer_status,omitempty"`
	// TransferCapitalRecordList 转账资金类型列表
	TransferCapitalRecordList []TransferCapitalRecord `json:"transfer_capital_record_list,omitempty"`
}

TrnsferWalletRecord 账户信息 a

type UnallocatedBalance

type UnallocatedBalance struct {
	// AdOnlyUnallocatedBalance 巨量广告业务线待分配余额(单位元)
	AdOnlyUnallocatedBalance *WalletBasicBalanceInfo `json:"ad_only_unallocated_balance,omitempty"`
	// EcpOnlyUnallocatedBalance 巨量千川业务线待分配余额(单位元)
	EcpOnlyUnallocatedBalance *WalletBasicBalanceInfo `json:"ecp_only_unallocated_balance,omitempty"`
	// LocalOnlyUnallocatedBalance 巨量本地推业务线待分配余额(单位元)
	LocalOnlyUnallocatedBalance *WalletBasicBalanceInfo `json:"local_only_unallocated_balance,omitempty"`
	// AdSharedUnallocatedBalance 巨量广告/千川/本地推业务线待分配余额(单位元)
	AdSharedUnallocatedBalance *WalletBasicBalanceInfo `json:"ad_shared_unallocated_balance,omitempty"`
}

UnallocatedBalance 钱包待分配余额(单位元)

type WalletBalanceFilter

type WalletBalanceFilter struct {
	// AccountPlatformType 业务线：AD/千川/本地推;不填默认不过滤 可选值:
	// NO_LIMIT 不过滤
	// ONLY_AD 仅巨量AD专用
	// ONLY_AD_SHARED 仅巨量AD/千川/本地推专用
	// ONLY_ECP 仅巨量千川专用
	// ONLY_LOCAL 仅巨量本地推专用
	//  默认值: NO_LIMIT
	AccountPlatformType enum.AccountPlatformType `json:"account_platform_type,omitempty"`
	// CapitalType 资金类型包括 预付、授信; 不填默认不过滤资金类型 可选值:
	// CREDIT 授信
	// NO_LIMIT 不限
	// PREPAY 预付
	//  默认值: NO_LIMIT
	CapitalType CapitalType `json:"capital_type,omitempty"`
	// DeliveryType 投放类型：竞价、品牌、通用
	// BIDDING 竞价
	// BRAND 品牌
	// GENERAL 通用
	// NO_LIMIT 不过滤
	//  默认值: NO_LIMIT
	DeliveryType DeliveryType `json:"delivery_type,omitempty"`
}

type WalletBalanceGetRequest

type WalletBalanceGetRequest struct {
	// AccountID 账户ID，对于巨量AD、千川、本地推是广告主ID，对于代理商是代理商ID
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType enum.AccountType `json:"account_type,omitempty"`
	// WalletIDList 资金共享钱包id列表，注意：传入的列表长度不可大于200
	WalletIDList []uint64 `json:"wallet_id_list,omitempty"`
	// WalletBalanceFilters 余额过滤条件
	WalletBalanceFilters *WalletBalanceFilter `json:"wallet_balance_filters,omitempty"`
}

WalletBalanceGetRequest 资金共享-批量查询钱包余额 API Request

func (WalletBalanceGetRequest) Encode

func (r WalletBalanceGetRequest) Encode() string

Encode implements GetRequest interface

type WalletBalanceGetResponse

type WalletBalanceGetResponse struct {
	model.BaseResponse
	Data *WalletBalanceInfo `json:"data,omitempty"`
}

WalletBalanceGetResponse 资金共享-批量查询钱包余额 API Response

type WalletBalanceInfo

type WalletBalanceInfo struct {
	// WalletID 共享钱包ID
	WalletID uint64 `json:"wallet_id,omitempty"`
	// BasicBalanceInfo 常用余额信息
	BasicBalanceInfo *BasicBalanceInfo `json:"basic_balance_info,omitempty"`
	// GeneralBalanceInfo 通用余额信息
	GeneralBalanceInfo *GeneralBalanceInfo `json:"general_balance_info,omitempty"`
}

WalletBalanceInfo 共享钱包余额信息

type WalletBasicBalanceInfo

type WalletBasicBalanceInfo struct {
	// AvailableBalance 可用余额(单位元)
	AvailableBalance *BasicBalanceInfo
	// UnavailableBalance 不可用余额(单位元)
	UnavailableBalance *BasicBalanceInfo
}

type WalletInfo

type WalletInfo struct {
	// WalletID 共享钱包ID
	WalletID uint64 `json:"wallet_id,omitempty"`
	// WalletType 共享钱包类型 可选值:
	// MAIN_WALLET 共享钱包 即大钱包
	// SUB_CONSUME_WALLET 投放子钱包，可以挂多个广告主，可以投放
	// SUB_MANAGE_WALLET 管理子钱包，只能挂一个广告主（如代理商），不能投放
	WalletType enum.SharedWalletType `json:"wallet_type,omitempty"`
	// CommonWalletInfo 通用钱包信息
	CommonWalletInfo *CommonWalletInfo `json:"common_wallet_info,omitempty"`
	// MainWalletInfo 共享钱包(大钱包)信息
	MainWalletInfo *SharedMainWalletInfo `json:"main_wallet_info,omitempty"`
	// SubWalletInfo 投放钱包(小钱包)信息
	SubWalletInfo *SubWalletInfo `json:"sub_wallet_info,omitempty"`
}

WalletInfo 钱包信息

type WalletInfoGetRequest

type WalletInfoGetRequest struct {
	// AccountID 账户ID，对于巨量AD、千川、本地推是广告主ID，对于代理商是代理商ID
	AccountID uint64 `json:"account_id,omitempty"`
	// AccountType 账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType enum.AccountType `json:"account_type,omitempty"`
	// WalletIDList 资金共享钱包id列表，注意：传入的列表长度不可大于200
	WalletIDList []uint64 `json:"wallet_id_list,omitempty"`
}

WalletInfoGetRequest 资金共享-批量查询钱包信息 API Request

func (WalletInfoGetRequest) Encode

func (r WalletInfoGetRequest) Encode() string

Encode implments GetRequest interface

type WalletInfoGetResponse

type WalletInfoGetResponse struct {
	model.BaseResponse
	Data struct {
		// WalletInfo 钱包信息列表
		WalletInfo []WalletInfo `json:"wallet_info,omitempty"`
	} `json:"data,omitempty"`
}

WalletInfoGetResponse 资金共享-批量查询钱包信息 API Response

type WalletRelation

type WalletRelation struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// SharedWalletID 共享钱包ID
	SharedWalletID uint64 `json:"shared_wallet_id,omitempty"`
}

WalletRelation 共享钱包关系

type WalletRelationGetRequest

type WalletRelationGetRequest struct {
	// AccountID 账户ID，对于巨量AD、千川、本地推是广告主ID，对于代理商是代理商ID
	AccountID uint64 `json:"account_id,omitempty"`
	// SharedWalletID 共享钱包ID
	SharedWalletID uint64 `json:"shared_wallet_id,omitempty"`
	// AccountType 账户类型 可选值:
	// AD 巨量广告主
	// AGENT 代理
	// LOCAL 本地推广告主
	AccountType string `json:"account_type,omitempty"`
	// Page 页码；默认为1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小；默认为10
	PageSize int `json:"page_size,omitempty"`
}

WalletRelationGetRequest 资金共享-查询子钱包下绑定的adv列表 API Request

func (WalletRelationGetRequest) Encode

func (r WalletRelationGetRequest) Encode() string

Encode implements GetRequest interface

type WalletRelationGetResponse

type WalletRelationGetResponse struct {
	model.BaseResponse
	Data *WalletRelationGetResult `json:"data,omitempty"`
}

WalletRelationGetResponse 资金共享-查询子钱包下绑定的adv列表 API Response

type WalletRelationGetResult

type WalletRelationGetResult struct {
	// PageInfo 翻页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// Results 共享钱包关系
	Results []WalletRelation `json:"results,omitempty"`
	// SharedWalletID 共享钱包ID
	SharedWalletID uint64 `json:"shared_wallet_id,omitempty"`
}