v0.0.11

jpay-direct-proto

transaction/transaction.proto

CheckFreeDiamondReq

Field	Type	Label	Description
access_token	string
get_it_right_now	bool		false -> 單純查, true -> 我要領

CheckFreeDiamondRes

Field	Type	Description
diamond_amount	int64	餘額
cooldown_seconds	int64	-1 為不用倒數
free_diamond_amount	int64	此次領取到的數量

CompleteTransactionReq

Field	Type	Description
transaction_token	string
diamond_param	PaymentParamsOfDiamond
creditcard_param	PaymentParamsOfCreditCard
ecpay_inpay_param	PaymentParamsOfEcpayInpay	站內付
happy_pay_param	PaymentParamsOfHappypay	Happypay oversea
tap_pay_param	PaymentParamsOfTapPay
jpoint_pay_param	google.protobuf.Empty
cash_param	google.protobuf.Empty

CompleteTransactionRes

Field	Type	Label	Description
three_d_url	string		optional

CreateTransactionTokenReq

Field	Type	Label	Description
app_id	string
order_id	string
product_name	string
money	Money
check_code	string
callback_url	string
redirect_url	string
access_token	string
jpoint_discount	int64
payment_channels	PaymentChannel	repeated	optional 指定訂單付款方式
require_apea_twid	bool

CreateTransactionTokenRes

Field	Type	Label	Description
transaction_token	string
transc_id	string

CreditCard

Field	Type	Description
card_id	string
last_four_num	string
issuing_network	string	發卡機構
last_used	bool

CreditCard.Status

DiamondPackage

Field	Type	Description
id	int64
name	string
usd	double
twd	int64
diamond_amount	int64
img	string
description	string
can_buy	bool
type	DiamondPackageType
ribbon_url	string
bonus_amount	int64	bonus期間才會有數值 (bonus_start_at, bonus_end_at)

DiamondRecord

Field	Type	Label	Description
trade_id	string
product_name	string
amount_before	int64
amount_after	int64
created_at	google.protobuf.Timestamp
memo	string

DiscountTransactionReq

Field	Type	Label	Description
transaction_token	string
jpoint_discount	int64

DiscountTransactionRes

FormData

Field	Type	Label
key	string
value	string
options	FormDataOptions	repeated

FormDataOptions

Field	Type	Label	Description
value	string
text	string

GetBonusAmountReq

Field	Type	Label	Description
access_token	string

GetBonusAmountRes

Field	Type	Label	Description
amount	int64		可用數量

GetDiamondAmountReq

Field	Type	Label	Description
access_token	string

GetDiamondAmountRes

Field	Type	Label	Description
diamond_amount	int64

GetDiamondPackagesReq

Field	Type	Label	Description
filter_type	DiamondPackageType
access_token	string

GetDiamondPackagesRes

Field	Type	Label	Description
packages	DiamondPackage	repeated

GetDiamondRecordReq

Field	Type	Label	Description
access_token	string
page	int64
limit	int64
start_at	google.protobuf.Timestamp
end_at	google.protobuf.Timestamp
type	DiamondRecordType

GetDiamondRecordRes

Field	Type	Label	Description
records	DiamondRecord	repeated
total	int64

GetExchangeRateReq

GetExchangeRateRes

Field	Type	Label	Description
usd_to_twd	int64

GetFreeDiamondAmountReq

Field	Type	Label	Description
access_token	string

GetFreeDiamondAmountRes

Field	Type	Label	Description
amount	int64		可用數量

GetFreeDiamondEarnTimesReq

Field	Type	Label	Description
access_token	string

GetFreeDiamondEarnTimesRes

Field	Type	Label	Description
earn_times	int64		獲得次數

GetPaymentInfoReq

Field	Type	Label	Description
transaction_token	string		tranasaction token
jpoint_discount	int64		optional

GetPaymentInfoRes

Field	Type	Label	Description
payment_methods	PaymentMethod	repeated
invoice_setting	InvoiceSetting

GetPurchaseRecordReq

Field	Type	Description
access_token	string
page	int64
limit	int64
start_completed_at	google.protobuf.Timestamp
end_completed_at	google.protobuf.Timestamp
currency	Currency
app_id	string	optional

GetPurchaseRecordRes

Field	Type	Label	Description
records	PurchaseRecord	repeated
total	int64

GetTransactionTokenReq

Field	Type	Label	Description
app_id	string
transc_id	string
check_code	string

GetTransactionTokenRes

Field	Type	Label	Description
transaction_token	string

InvoiceSetting

Field	Type	Label	Description
email	string
phone_carrier	string
id_carrier	string
donate_code	string
last_used	InvoiceType

Money

Field	Type	Label	Description
currency	Currency
price	int64
display_currency	Currency
display_price	int64

PaymentMethod

Field	Type	Label	Description
payment_method_id	string
type	PaymentType		method creditcard, diamond
payment_channel	PaymentChannel
bound_credit_card	CreditCard	repeated	only response data on channel = creditcard
is_allow_new_credit_card	bool
is_form_post	bool		是否為 form post
form_post_url	string
form_post_data	FormData	repeated
ecpay_inpay_token	string
last_used	bool
invoice_status	InvoiceStatus
upstream_app_id	string
upstream_app_key	string

PaymentParamsOfCreditCard

Field	Type	Label	Description
creditcard_id	string

PaymentParamsOfDiamond

PaymentParamsOfEcpayInpay

Field	Type	Label	Description
pay_token	string

PaymentParamsOfHappypay

Field	Type	Label	Description
creditcard_id	string

PaymentParamsOfTapPay

Field	Type	Label	Description
creditcard_id	string
prime_token	string
remember_card	bool

PurchaseDiamondReq

Field	Type	Description
access_token	string
diamond_package_id	int64
redirect_url	string
ga4_client_id	string	for ga4
ga4_page_title	string
ga4_page_path	string
ga4_session_id	string

PurchaseRecord

Field	Type	Label	Description
trade_id	string
product_name	string
received_amount	int64
currency	Currency
completed_at	google.protobuf.Timestamp
received_jpoint	int64
application_name	string

QueryTransactionReq

Field	Type	Description
app_id	string
transc_id	string	trade_id
check_code	string

QueryTransactionRes

Field	Type	Description
transc_id	string
order_id	string
product_name	string
currency	Currency
price	int64	總價
received_amount	int64	實收金額
received_jpoint	int64	實收 JPoints
created_at	google.protobuf.Timestamp
completed_at	google.protobuf.Timestamp
status	TransactionStatus
pay_at	google.protobuf.Timestamp

RefundTransactionReq

Field	Type	Description
app_id	string
transc_id	string	trade_id
check_code	string
refund_fee	double	退款金額
refund_reason	string	退款原因

RefundTransactionRes

Field	Type	Label	Description
status	RefundTransactionStatus

SetPaymentMethodReq

Field	Type	Label	Description
payment_method_id	string
transaction_token	string

SetPaymentMethodRes

SetTransactionInvoiceReq

Field	Type	Description
transaction_token	string
invoice_type	InvoiceType
invoice_data	string
reference_trade_id	string	optional, 可以將此筆訂設定為某筆訂單的開發票方式

SetTransactionInvoiceRes

TotalDepositAmountsReq

Field	Type	Label	Description
access_token	string

TotalDepositAmountsRes

Field	Type	Label	Description
twd	int64
diamond_amount	int64

TransactionTokenInfoReq

Field	Type	Label	Description
transaction_token	string

TransactionTokenInfoRes

Field	Type	Label	Description
product_name	string
money	Money
jpoint_discount	int64
jpoint_description	string
platform	string
required_apea_twid	bool

UseBonusDiamondReq

Field	Type	Label	Description
access_token	string

UseBonusDiamondRes

Field	Type	Description
diamond_amount	int64	餘額
available_amount	int64	可用數量
free_diamond_amount	int64	此次領取到的數量

WSMessage

Field	Type	Label	Description
type	WSMessageType
message	string
to_object_id	string

CreditCard.Status.Value

Name	Number	Description
None	0
Temporary	1

Currency

Name	Number	Description
None	0
TWD	1
USD	2
DIAMOND	3
USDCENTS	4

DiamondPackageType

Name	Number	Description
DPT_ONCE	0
DPT_DAILY	1
DPT_MONTHLY	2
DPT_LIFETIME	3
DPT_ALL	999

DiamondRecordType

Name	Number	Description
DRT_ALL	0
DRT_CREATE	1
DRT_PAYMENT	2

ErrCTCode

Name	Number	Description
ErrCTCNotSet	0
ErrCTCCardExpired	11001	the creditcard is expired
ErrCTCPaymentFailed	11002	failed to pay via the gateway
ErrCTCCardInfoIncorrect	11003	the creditcard number does not exist
ErrCTCCardInsufficientBalance	11004	the balance of the creditcard is insufficient
ErrCTCCardBankDeclined	11005	the creditcard was declined by the bank, please contact the bank
ErrCTCRetryLater	11006	please retry the payment later
ErrCTCCardExistsWithToken	11007	the creditcard has been bound with the user with the card token
ErrCTCCard3DFailed	11008	the creditcard did not pass 3D verification
ErrCTCContactTicketCenter	11009	please contact our customer service or submit a ticket

InvoiceStatus

Name	Number	Description
Invoice	0
Receipt	1
ReceiptPdf	2

InvoiceType

Name	Number	Description
NotSet	0
Email	1
Phone	2
ID	3
Donate	4
Pdf	5

PaymentChannel

Name	Number	Description
Creditcard	0	通用-信用卡-串接模式
Diamond	3	鑽石購買
ECPAY_INPAY	4	綠界-INPAY
ATM	5	ATM
CVS	6	便利商店
HAPPYPAY_OVERSEAS	7	HappyPay-信用卡-串接模式
CreditcardTapPay	8	TapPay-信用卡-串接模式
NOT_SET	9
Jpoint	10	JPoints 全額折抵
Cash	11	現金

PaymentType

Name	Number	Description
Domestic_Type	0
Foreign_Type	1
Diamond_Type	2
ATM_Type	3
CSV_Type	4
NOT_SET_Type	5
Jpoint_Type	6
Cash_Type	7

RefundTransactionStatus

Name	Number	Description
RTS_FAILED	0	取消訂單失敗
RTS_REFUNDED_WITHOUT_WITHDRAWAL	1	取消訂單成功，金流未退款
RTS_REFUNDED	2	取消訂單成功，金流已退款

TransactionStatus

Name	Number	Description
TS_NOTSET	0	狀態異常
TS_REFUNDED	1	已退款
TS_FAILED	2	訂單失敗, 逾期未付
TS_CREATED	3	尚未付款
TS_SUCCEEDED	4	訂單成功
TS_REFUNDED_WITHOUT_WITHDRAWAL	5	訂單已取消，金流未退款

WSMessageType

Name	Number	Description
WST_DIAMONDCHANGE	0
WST_ANNOUNCEMENT	1

TransactionService

Method Name	Request Type	Response Type	Description
CreateTransactionToken	CreateTransactionTokenReq	CreateTransactionTokenRes	後端呼叫生成一個可以付款的 transaction token
GetTransactionToken	GetTransactionTokenReq	GetTransactionTokenRes	使用trade_id 產生 transaction token
QueryTransaction	QueryTransactionReq	QueryTransactionRes	查詢訂單狀態
RefundTransaction	RefundTransactionReq	RefundTransactionRes	訂單退款
TransactionTokenInfo	TransactionTokenInfoReq	TransactionTokenInfoRes	取得交易資訊
DiscountTransaction	DiscountTransactionReq	DiscountTransactionRes	用戶使用jpoint 折抵
GetPaymentInfo	GetPaymentInfoReq	GetPaymentInfoRes	取得 transaction token 的付款資訊
SetPaymentMethod	SetPaymentMethodReq	SetPaymentMethodRes	設定訂單付費方式，前端於付費FORM POST前呼叫，記錄訂單付費方式，若在金流端發生異常沒有返回，要查單時才知去哪家金流查
CompleteTransaction	CompleteTransactionReq	CompleteTransactionRes	完成 transaction token 付款
SetTransactionInvoice	SetTransactionInvoiceReq	SetTransactionInvoiceRes	設定訂單的發票資訊
GetPurchaseRecord	GetPurchaseRecordReq	GetPurchaseRecordRes	取得購買紀錄
GetExchangeRate	GetExchangeRateReq	GetExchangeRateRes	other
GetDiamondAmount	GetDiamondAmountReq	GetDiamondAmountRes	jkf red diamond 以下api移到donate/diamond.proto 取得鑽石數量
PurchaseDiamond	PurchaseDiamondReq	CreateTransactionTokenRes	購買鑽石
GetDiamondPackages	GetDiamondPackagesReq	GetDiamondPackagesRes	取得可以購買的鑽石方案
GetFreeDiamondAmount	GetFreeDiamondAmountReq	GetFreeDiamondAmountRes	取得超值方案總量
CheckFreeDiamond	CheckFreeDiamondReq	CheckFreeDiamondRes	查詢/領取免費鑽石
GetBonusAmount	GetBonusAmountReq	GetBonusAmountRes	取得超值方案總量
UseBonusDiamond	UseBonusDiamondReq	UseBonusDiamondRes	使用超值方案
GetFreeDiamondEarnTimes	GetFreeDiamondEarnTimesReq	GetFreeDiamondEarnTimesRes	取得免費鑽石獲得次數
GetDiamondRecord	GetDiamondRecordReq	GetDiamondRecordRes	取得鑽石異動紀錄
TotalDepositAmounts	TotalDepositAmountsReq	TotalDepositAmountsRes	取得儲值鑽石總額

****************************************** |

model/data_config.proto

model/model.proto

AdminAppPsg

group by app_id, type

Field	Type	Label	Description
id	int64
app_id	string
psg_id	string
psg_method_id	string
type	transaction.PaymentType
status	PsgMethodStatus
priority	int64

Ga4Parameter

Ga4Parameter : Ga4參數

Field	Type	Label	Description
ga4_client_id	string
ga4_page_title	string
ga4_page_path	string
ga4_session_id	string
ga4_engagement_time_msec	string

Psg

Field	Type	Label	Description
id	string
name	string
provider	string
merchant_id	string
data_config	string
status	int64
invoice_status	int64
create_at	google.protobuf.Timestamp

PsgMethod

Field	Type	Description
id	string
name	string
psg	Psg
channel	transaction.PaymentChannel
type	transaction.PaymentType	oneof data_config
status	PsgMethodStatus

PsgMethodStatus

Name	Number	Description
Close	0
Open	1

activity/activity.proto

AchievementItem

Field	Type	Label	Description
item_id	int64
name	string
item_type	string
img_url	string
completed	bool

Activity

ActivityData

Field	Type	Description
activity_id	int64
name	string
icon_link	string	此欄位會先回傳空值
activity_link_url	string
start_at	google.protobuf.Timestamp
end_at	google.protobuf.Timestamp

ActivityIDRes

Field	Type	Label	Description
activity_id	int64

ActivityInfo

struct

Field	Type	Label	Description
gift_name	string
gift_image_url	string
amount	int64
lady_rank	string
top_fan_name	string
top_fan_avatar	string
activity_link_url	string
activity_type	int64
start_at	google.protobuf.Timestamp
end_at	google.protobuf.Timestamp

ActivityInfoRes

Field	Type	Label
activity_id	int64
name	string
free_item	Item
paid_item	Item
gift	GiftItem	repeated
start_at	google.protobuf.Timestamp
end_at	google.protobuf.Timestamp
main_type	Activity.MainType
use_level_title	bool
use_level_color	bool
lady_level_type	Activity.LadyLevelType

ActivityPackage

Field	Type	Description
name	string
diamond_price	int64
img_url	string
package_id	int64
description	string
can_buy	bool
cooldown_seconds	int64	-1 為不用倒數
type	ActivityPackage.ActivityPackageType

ActivityTopLady

struct

Field	Type	Label	Description
name	string
avatar	string
points	int64
top_fan_name	string
uid	int64

BackpackItem

Field	Type	Label	Description
item_id	int64
name	string
img_url	string
target_mode	int64
amount	int64
jkfuid	int64

BackpackTargetItem

Field	Type	Label	Description
item_id	int64
name	string
item_type	string
img_url	string
amount	int64
target_id	int64
target_title	string
jkfuid	int64

BannerInfo

struct

Field	Type	Label	Description
name	string
image_url	string
link_url	string

BuyPackageReq

Field	Type	Description
access_token	string
package_id	int64
ga4_client_id	string	Deprecated.
ga4_page_title	string	Deprecated.
ga4_page_path	string	Deprecated.
ga4_session_id	string	Deprecated.
ga4_parameter	model.Ga4Parameter

EmptyReq

EmptyRes

EquipItemReq

Field	Type	Label	Description
access_token	string
item_id	int64

EquipItemV2Req

Field	Type	Label	Description
access_token	string
item_id	int64
target_id	int64

Fan

Field	Type	Label	Description
object_id	string
points	int64

FanDetail

Field	Type	Label	Description
name	string
points	int64
avatar	string

GetActivityBannerListReq

Field	Type	Label	Description
activity_id	int64

GetActivityBannerListRes

Field	Type	Label	Description
banner_info	BannerInfo	repeated

GetActivityItemAmountReq

Field	Type	Description
access_token	string	女郎token
uuid	int64	女郎uuid
activity_id	int64	活動編號

GetActivityItemAmountRes

Field	Type	Label	Description
activity_item_amounts	LadyActivityItemAmount	repeated

GetActivityListByLadyReq

Field	Type	Label	Description
object_id	string		女郎 object_id(uuid)
uid	int64		女郎 uid

GetActivityListByLadyRes

Field	Type	Label	Description
data	ActivityData	repeated

GetActivityListReq

Field	Type	Label	Description
object_id	string		女郎 object_id(uuid)
uid	int64		女郎 uid

GetActivityListRes

Field	Type	Label	Description
info	ActivityInfo	repeated

GetActivitySpecialTopFansReq

GetActivitySpecialTopFansRes

Field	Type	Label	Description
fans	FanDetail	repeated

GetActivityTopFansReq

Field	Type	Label	Description
activity_id	int64
item_id	ActivityItemId		optional

GetActivityTopFansRes

Field	Type	Label	Description
fans	FanDetail	repeated

GetActivityTopLadyReq

Field	Type	Label	Description
activity_id	int64

GetActivityTopLadyRes

Field	Type	Label	Description
ladies	ActivityTopLady	repeated

GetInfoByIDReq

Field	Type	Label	Description
activity_id	int64

GetItemInfoReq

Field	Type	Label	Description
access_token	string
activity_id	int64

GetLadyActivityBonusThresholdReq

Field	Type	Label	Description
access_token	string		女郎 token
activity_id	int64		活動編號

GetLadyActivityBonusThresholdRes

Field	Type	Label	Description
Current	int64
Reward	int64
Next	int64

GetLadyActivityReq

Field	Type	Label	Description
object_id	string		女郎 UUID
activity_id	int64		活動編號

GetLadyActivityRes

Field	Type	Label	Description
current_level	int64
current_point	int64
next_level_point	int64
max_level	int64
main_part	LadyActivityPart
part1	LadyActivityPart
part2	LadyActivityPart
part3	LadyActivityPart
part4	LadyActivityPart
part5	LadyActivityPart

GetLadyActivityV2Res

Field	Type	Label	Description
lady	LevelInfo
targets	TargetLevelInfo	repeated
lady_rank	RankInfo
max_level	int64
main	TargetActivityPart	repeated	repeated TargetActivityPart sub = 12;

GetLadyTopFansReq

Field	Type	Label	Description
object_id	string
activity_id	int64

GetLadyTopFansRes

Field	Type	Label	Description
fans	Fan	repeated

GetMainGiftReq

Field	Type	Label	Description
activity_id	int64

GetMainGiftRes

Field	Type	Label	Description
gift_url	string
gift_name	string

GetMemberRankReq

Field	Type	Label	Description
access_token	string
activity_id	int64

GetMemberRankRes

Field	Type	Label	Description
user_rank	int64
avatar	string

GetMyBackpackItemListReq

Field	Type	Label	Description
access_token	string
activity_id	int64

GetMyBackpackItemListRes

Field	Type	Label
my_items	BackpackItem	repeated
equipable_items	BackpackItem	repeated
achievement_items	AchievementItem	repeated

GetMyBackpackItemListV2Res

Field	Type	Label
my_items	BackpackItem	repeated
equipable_items	BackpackTargetItem	repeated
achievement_items	AchievementItem	repeated

GetNotificationReq

Field	Type	Label	Description
access_token	string

GetNotificationRes

Field	Type	Label	Description
message	string
img_url	string
notify_at	google.protobuf.Timestamp
title	string
unread_count	int64
amount	int64

GetPackageInfoReq

Field	Type	Label	Description
activity_id	int64
accessToken	string

GetPackageInfoRes

Field	Type	Label	Description
packages	ActivityPackage	repeated

GetProgressOfBonusSkinReq

Field	Type	Label	Description
access_token	string
activity_id	int64

GetProgressOfBonusSkinRes

Field	Type	Label	Description
progresses	ProgressOfBonusSkin	repeated

GetSpecialMemberRankReq

Field	Type	Label	Description
access_token	string

GetSpecialMemberRankRes

Field	Type	Label	Description
user_rank	int64
avatar	string

GiftInfo

Field	Type	Label	Description
name	string
amount	int64
image_url	string

GiftItem

Field	Type	Label	Description
item_id	int64
gift_id	int64
item	Item

Item

Field	Type	Label	Description
name	string
img_url	string
point_type	Item.PointType
target_mode	Item.TargetMode

ItemActivityPart

Field	Type	Label	Description
item_id	int64
name	string
item_type	string
skin_name	string
amount	int64

LadyActivityItemAmount

Field	Type	Label	Description
activity_id	int64
activity_name	string
activity_type	ActivityType
gift	GiftInfo	repeated	禮物列表
start_at	google.protobuf.Timestamp
end_at	google.protobuf.Timestamp

LadyActivityPart

Field	Type	Label	Description
skin_name	string
amount	int64

LadyReceivedRecord

Field	Type	Label	Description
fan_object_id	string
item_type	string
item_name	string
amount	int64
img_url	string
received_at	google.protobuf.Timestamp

LadyReceivedRecordsReq

Field	Type	Label	Description
activity_id	int64
lady_object_id	string
received_before	google.protobuf.Timestamp
limit	int64

LadyReceivedRecordsRes

Field	Type	Label	Description
records	LadyReceivedRecord	repeated

LevelInfo

Field	Type	Label	Description
current_level	int64
current_point	int64
next_level_point	int64
decorations	string	repeated	only equipped Place title skin_name or color code

MyFreeItemRes

Field	Type	Description
amount	int64
next_cooldown_seconds	int64	下個獲得道具的時間, 如果已經滿的話則回傳 -1
receive_point	int64	本次獲得的隨機點數

MyPaidItemRes

Field	Type	Label	Description
amount	int64

ProgressOfBonusSkin

Field	Type	Description
item_id	int64
current_amount	int64
threshold_amount	int64	if can't receive bonus return -1

RankInfo

Field	Type	Label	Description
point	int64		總積分
level	int64		積分排行榜名次

RedeemCodeReq

Field	Type	Label	Description
access_token	string
code	string

SendItemReq

Field	Type	Label	Description
access_token	string
item_id	int64
object_id	string
amount	int64
ga4_client_id	string

SendItemRes

Field	Type	Label	Description
amount	int64
receive_point	int64		本次獲得的隨機點數

SendItemV2Req

Field	Type	Label	Description
access_token	string
item_id	int64
object_id	string
amount	int64
target_id	int64

TargetActivityPart

Only equipped

Field	Type	Label
target_id	int64
target_name	string
items	ItemActivityPart	repeated

TargetLevelInfo

Field	Type	Label	Description
target_id	int64
target_name	string
level_info	LevelInfo

TransactionRes

Field	Type	Label	Description
transaction_token	string

UseItemReq

Field	Type	Label	Description
access_token	string
activity_id	int64
object_id	string
amount	int64

UseItemV2Req

Field	Type	Label	Description
access_token	string
activity_id	int64
object_id	string
amount	int64
target_id	int64

UsePaidItemRes

Field	Type	Label	Description
amount	int64
receive_point	int64		本次獲得的隨機點數

Activity.LadyLevelType

Name	Number	Description
ItemLog	0
TargetsMin	1

Activity.MainType

Name	Number	Description
DecorateLayout	0
BetGame	1
EducationDolls	2

ActivityItemId

Name	Number	Description
AII_ALL	0
AII_BET_AMOUNT	21
AII_PAYOUT	22

ActivityPackage.ActivityPackageType

Name	Number	Description
Normal	0
Limited	1

ActivityType

Name	Number	Description
DEFAULT	0
FACE	1
LIVE	2

Item.PointType

Name	Number	Description
Static	0
BetRecord	1
Random	2

Item.TargetMode

Name	Number	Description
NoOne	0
SingleOne	1
ShareByRate	2

RedeemCodeReq.RedeemErr

Name	Number	Description
NotErr	0
TryLater	1001
Redeemed	1002
NotExist	1003

ActivityService

Method Name	Request Type	Response Type	Description
GetCurrent	EmptyReq	ActivityIDRes	活動取得現在進行中的活動資訊 ( status = 1 )
GetFeedsCurrent	EmptyReq	ActivityIDRes
GetInfoByID	GetInfoByIDReq	ActivityInfoRes	取得活動資訊 ( status = 1 )
GetLadyActivity	GetLadyActivityReq	GetLadyActivityRes	女郎活動裝飾列表： [OLD] decorate_layout ( main + part 1 ~ 4，範例：聖誕樹 ) [OLD] bet_game ( 範例：拉霸機 )
GetLadyActivityV2	GetLadyActivityReq	GetLadyActivityV2Res	k = count( activity_target ) n = count( activity_item, item_type = skin, position = main ) m = count( activity_item, item_type = skin, position = part ) o = ( activity use_point_level ) && count( activity_item, item_type = title, position = title ) [NEW] education_dolls ( main[k][n] + part[k][m] + title[o]，範例：美蛇雙姬 )
GetLadyReceivedRecords	LadyReceivedRecordsReq	LadyReceivedRecordsRes	取得某女郎的接受道具記錄
GetLadyTopFans	GetLadyTopFansReq	GetLadyTopFansRes	取得某個女郎的前十大粉絲
GetMyFreeItem	GetItemInfoReq	MyFreeItemRes	道具取得免費活動道具資訊
UseFreeItem	UseItemReq	MyFreeItemRes	使用免費活動道具
UseFreeItemV2	UseItemV2Req	MyFreeItemRes
GetMyPaidItem	GetItemInfoReq	MyPaidItemRes	取得付費活動道具資訊
UsePaidItem	UseItemReq	UsePaidItemRes	使用付費活動道具
UsePaidItemV2	UseItemV2Req	UsePaidItemRes
SendItem	SendItemReq	SendItemRes	使用道具
SendItemV2	SendItemV2Req	SendItemRes
EquipItem	EquipItemReq	EmptyRes	女郎裝備道具
EquipItemV2	EquipItemV2Req	EmptyRes
GetMyBackpackItemList	GetMyBackpackItemListReq	GetMyBackpackItemListRes	我的背包 - 道具列表
GetMyBackpackItemListV2	GetMyBackpackItemListReq	GetMyBackpackItemListV2Res
RedeemCode	RedeemCodeReq	EmptyRes	兌換碼換造型
GetPackageInfo	GetPackageInfoReq	GetPackageInfoRes	訂單取得付費道具購買資訊
BuyPackage	BuyPackageReq	TransactionRes	購買付費道具
GetNotification	GetNotificationReq	GetNotificationRes	獲得免費道具事件(like unread )
GetProgressOfBonusSkin	GetProgressOfBonusSkinReq	GetProgressOfBonusSkinRes	差多少可以獲得的skin
GetActivityTopFans	GetActivityTopFansReq	GetActivityTopFansRes	LandingPage 找尋排名前10的粉絲
GetActivityTopLady	GetActivityTopLadyReq	GetActivityTopLadyRes	找尋排名前N的女郎
GetLadyActivityBonusThreshold	GetLadyActivityBonusThresholdReq	GetLadyActivityBonusThresholdRes	取得女郎活動額外獎勵資訊
GetActivityList	GetActivityListReq	GetActivityListRes	取得活動資訊清單
GetActivityBannerList	GetActivityBannerListReq	GetActivityBannerListRes	取得活動banner清單
GetActivityItemAmount	GetActivityItemAmountReq	GetActivityItemAmountRes	取得活動當中禮物收集數量
GetActivityListByLady	GetActivityListByLadyReq	GetActivityListByLadyRes	GetActivityListByLady : 取得女郎參加的活動列表，由新到舊排序
GetMainGift	GetMainGiftReq	GetMainGiftRes	GetMainGift 取得活動主要禮物
GetMemberRank	GetMemberRankReq	GetMemberRankRes	GetMemberRank 取得會員活動名次
GetActivitySpecialTopFans	GetActivitySpecialTopFansReq	GetActivitySpecialTopFansRes	特規騎士榜 GetActivitySpecialTopFans 取得粉絲排名
GetSpecialMemberRank	GetSpecialMemberRankReq	GetSpecialMemberRankRes	GetMemberRank 取得會員活動名次

activity_game/activity_game.proto

GameRecord

Field	Type	Description
lady_uuid	string	女郎 uuid string 36
user_id	string	uuid account string
bet_id	string	注單編號 string
bet_amount	int64	注單金額
payout	int64	派彩金額
win_loss	int64	輸贏

GetGameRecordsReq

Field	Type	Label	Description
game_id	string
min_id	int64
limit	int64

GetGameRecordsRes

Field	Type	Label	Description
game_records	GameRecord	repeated
max_id	int64

ActivityGameService

Method Name	Request Type	Response Type	Description
GetGameRecords	GetGameRecordsReq	GetGameRecordsRes	取得押注記錄 ACTIVITY後端呼叫

donate-enums/enum.proto

ConsumeSourceType

ConsumeSourceType：商品分類

Name	Number	Description
CONSUME_SOURCE_TYPE_UNSPECIFIED	0
CONSUME_SOURCE_TYPE_GIFT	1	donate 禮物
CONSUME_SOURCE_TYPE_DIAMOND_PACKAGE	2	donate 紅鑽禮包
CONSUME_SOURCE_TYPE_ACTIVITY_PACKAGE	3	donate 遊戲機禮包
CONSUME_SOURCE_TYPE_TICKET	4	board 預約門票
CONSUME_SOURCE_TYPE_CARD	5	board 紀念卡
CONSUME_SOURCE_TYPE_FREE_DIAMOND	6	donate 免費鑽石
CONSUME_SOURCE_TYPE_COIN_PACKAGE	7	donate Face券禮包
CONSUME_SOURCE_TYPE_COIN	8	donate Face券

CurrencyType

CurrencyType：幣別分類

Name	Number	Description
CURRENCY_TYPE_UNSPECIFIED	0
CURRENCY_TYPE_TWD	1
CURRENCY_TYPE_DIAMOND	2
CURRENCY_TYPE_COIN	3

OrderStatus

OrderStatus : 訂單狀態

Name	Number	Description
ORDER_STATUS_CREATED	0
ORDER_STATUS_COMPLETED	1
ORDER_STATUS_FAILED	-1
ORDER_STATUS_REFUND	-2

ProfitType

ProfitType : 分潤類別

Name	Number	Description
PROFIT_TYPE_UNSPECIFIED	0
PROFIT_TYPE_SIX	1
PROFIT_TYPE_SEVEN	2

RechargePackageType

RechargePackageType：鑽石/Face券禮包分類

Name	Number	Description
RPT_DIAMOND_ONCE	0
RPT_DIAMOND_DAILY	1
RPT_DIAMOND_MONTHLY	2
RPT_DIAMOND_LIFETIME	3
RPT_COIN_ONCE	4
RPT_COIN_LIFETIME	5
RPT_ALL	999

TradeStatus

TradeStatus：訂單狀態

Name	Number	Description
TRADE_STATUS_UNSPECIFIED	0
TRADE_STATUS_REFUND	-2	已退單
TRADE_STATUS_FAILED	-1	交易失敗
TRADE_STATUS_CREATE_ORDER	1	創立訂單
TRADE_STATUS_ADD_AMOUNT_SUCCESS	2	儲值成功
TRADE_STATUS_SUB_AMOUNT_SUCCESS	3	交易完成

donate-direct/diamond.proto

ConsumeDiamondReq

Field	Type	Label	Description
token	string
member_object_id	string
transc_id	string
diamond_amount	int64
product_name	string
source	donateenums.ConsumeSourceType
is_voucher	bool
voucher_id	int64
platform	string
amount	int64
source_id	int64

ConsumeDiamondRes

RefundDiamondReq

Field	Type	Description
token	string
transc_id	string
diamond_amount	int64	需要退款的總額舉例: 商品100元要抽10%手續費的話要回傳90
source	donateenums.ConsumeSourceType
memo	string

RefundDiamondRes

DiamondDirectService

Method Name	Request Type	Response Type	Description
ConsumeDiamond	ConsumeDiamondReq	ConsumeDiamondRes	消費鑽石
RefundDiamond	RefundDiamondReq	RefundDiamondRes	退鑽石

donate/coin.proto

CoinPackage

Field	Type	Label	Description
id	int64
name	string
usd	double
twd	int64
amount	int64
can_buy	bool
type	donateenums.RechargePackageType
ribbon_url	string
description	string

GetCoinAmountReq

Field	Type	Label	Description
access_token	string

GetCoinAmountRes

Field	Type	Label	Description
amount	int64

GetCoinPackagesReq

Field	Type	Label	Description
access_token	string

GetCoinPackagesRes

Field	Type	Label	Description
packages	CoinPackage	repeated

PurchaseCoinReq

Field	Type	Label	Description
access_token	string
package_id	int64
redirect_url	string
ga4_client_id	string
ga4_page_title	string
ga4_page_path	string
ga4_session_id	string

PurchaseCoinRes

Field	Type	Label	Description
transaction_token	string
transaction_id	string

CoinService

Method Name	Request Type	Response Type	Description
GetCoinAmount	GetCoinAmountReq	GetCoinAmountRes	取得Face券數量
GetCoinPackages	GetCoinPackagesReq	GetCoinPackagesRes	取得可以購買的Face券方案 [已搬移到face]
PurchaseCoin	PurchaseCoinReq	PurchaseCoinRes	購買Face券 [已搬移到face]

donate/diamond.proto

CheckFreeDiamondReq

Field	Type	Label	Description
access_token	string
get_it_right_now	bool		false -> 單純查, true -> 我要領

CheckFreeDiamondRes

Field	Type	Description
diamond_amount	int64	餘額
cooldown_seconds	int64	-1 為不用倒數
free_diamond_amount	int64	此次領取到的數量

DiamondPackage

Field	Type	Description
id	int64
name	string
usd	double
twd	int64
diamond_amount	int64
img	string
description	string
can_buy	bool
type	DiamondPackageType	棄用
ribbon_url	string
bonus_amount	int64	bonus期間才會有數值 (bonus_start_at, bonus_end_at)
package_type	donateenums.RechargePackageType

DiamondRecord

Field	Type	Label	Description
trade_id	string
product_name	string
amount_before	int64
amount_after	int64
created_at	google.protobuf.Timestamp
memo	string

GetBonusAmountReq

Field	Type	Label	Description
access_token	string

GetBonusAmountRes

Field	Type	Label	Description
amount	int64		可用數量

GetDiamondAmountReq

Field	Type	Label	Description
access_token	string

GetDiamondAmountRes

Field	Type	Label	Description
diamond_amount	int64

GetDiamondPackagesReq

Field	Type	Description
filter_type	DiamondPackageType	棄用
access_token	string
package_type	donateenums.RechargePackageType

GetDiamondPackagesRes

Field	Type	Label	Description
packages	DiamondPackage	repeated

GetDiamondRecordReq

Field	Type	Label	Description
access_token	string
page	int64
limit	int64
start_at	google.protobuf.Timestamp
end_at	google.protobuf.Timestamp
type	DiamondRecordType

GetDiamondRecordRes

Field	Type	Label	Description
records	DiamondRecord	repeated
total	int64

GetFreeDiamondAmountReq

Field	Type	Label	Description
access_token	string

GetFreeDiamondAmountRes

Field	Type	Label	Description
amount	int64		可用數量

GetFreeDiamondEarnTimesReq

Field	Type	Label	Description
access_token	string

GetFreeDiamondEarnTimesRes

Field	Type	Label	Description
earn_times	int64		獲得次數

PurchaseDiamondReq

Field	Type	Label	Description
access_token	string
diamond_package_id	int64
redirect_url	string
ga4_client_id	string
ga4_page_title	string
ga4_page_path	string
ga4_session_id	string

PurchaseDiamondRes

Field	Type	Label	Description
transaction_token	string
transaction_id	string

UseBonusDiamondReq

Field	Type	Label	Description
access_token	string

UseBonusDiamondRes

Field	Type	Description
diamond_amount	int64	餘額
available_amount	int64	可用數量
free_diamond_amount	int64	此次領取到的數量

DiamondPackageType

棄用

Name	Number	Description
DPT_ONCE	0
DPT_DAILY	1
DPT_MONTHLY	2
DPT_LIFETIME	3
DPT_ALL	999

DiamondRecordType

Name	Number	Description
DRT_ALL	0
DRT_CREATE	1
DRT_PAYMENT	2

DiamondService

Method Name	Request Type	Response Type	Description
GetDiamondAmount	GetDiamondAmountReq	GetDiamondAmountRes	取得鑽石數量
PurchaseDiamond	PurchaseDiamondReq	PurchaseDiamondRes	購買鑽石 [已搬移到face]
GetDiamondPackages	GetDiamondPackagesReq	GetDiamondPackagesRes	取得可以購買的鑽石方案 [已搬移到face]
CheckFreeDiamond	CheckFreeDiamondReq	CheckFreeDiamondRes	查詢/領取免費鑽石
GetBonusAmount	GetBonusAmountReq	GetBonusAmountRes	取得超值方案總量
UseBonusDiamond	UseBonusDiamondReq	UseBonusDiamondRes	使用超值方案
GetFreeDiamondEarnTimes	GetFreeDiamondEarnTimesReq	GetFreeDiamondEarnTimesRes	取得免費鑽石獲得次數
GetFreeDiamondAmount	GetFreeDiamondAmountReq	GetFreeDiamondAmountRes	取得超值方案總量
GetDiamondRecord	GetDiamondRecordReq	GetDiamondRecordRes	取得鑽石異動紀錄

donate/donate.proto

BadgeInfos

Field	Type	Label	Description
title	string
icon	string
link	string
order	int64
achieve_at	google.protobuf.Timestamp

BuyGiftReq

Field	Type	Description
access_token	string
gift_id	int64
message	string
to_object_id	string
amount	int64
ga4_client_id	string	Deprecated.
ga4_page_title	string	Deprecated.
ga4_page_path	string	Deprecated.
ga4_session_id	string	Deprecated.
ga4_parameter	model.Ga4Parameter

BuyGiftRes

Field	Type	Label	Description
transaction_token	string
order_id	string

DonateRecord

Field	Type	Label	Description
order_no	string
product_name	string
product_amount	int64
object_id	string
completed_at	google.protobuf.Timestamp

GetDonateRecordReq

Field	Type	Label	Description
access_token	string
page	int64
limit	int64
start_completed_at	google.protobuf.Timestamp
end_completed_at	google.protobuf.Timestamp
lady_object_id	string

GetDonateRecordRes

Field	Type	Label	Description
records	DonateRecord	repeated
total	int64

GetGiftHistoryReq

Field	Type	Description
access_token	string	optional
object_id	string	取得誰的
year	int64
month	int64
page	int64
limit	int64
time_zone	int64	必填, -12 ~ 12, 錯誤格式回傳 +8 時區資料

GetGiftHistoryRes

Field	Type	Label	Description
gift_history	GiftHistory	repeated
total	int64

GetGiftPackagesReq

Field	Type	Label	Description
star_object_id	string

GetGiftPackagesRes

Field	Type	Label	Description
gift_packages	GiftPackage	repeated

GetMyUnreadGiftReq

Field	Type	Label	Description
access_token	string

GetMyUnreadGiftRes

Field	Type	Label	Description
gift_history	GiftHistory
count	int64

GetRewardDetailInfo

Field	Type	Description
order_no	string	訂單編號
gift_info	GetRewardDetailInfo.GiftInfo	禮物資訊
amount	int64	送禮數量
completed_at	google.protobuf.Timestamp	贊助完成時間
member_info	GetRewardDetailInfo.MemberInfo	會員資訊
usd	double	分潤金額

GetRewardDetailInfo.GiftInfo

Field	Type	Label	Description
name	string		禮物名稱

GetRewardDetailInfo.MemberInfo

Field	Type	Label	Description
object_id	string		會員 object_id

GetRewardDetailV2Req

Field	Type	Description
access_token	string	[必填] token
year	int64	[必填] 資料年份
month	int64	[必填] 資料月份
page	int64	[必填] 分頁頁數
limit	int64	[必填] 分頁筆數
donator	string	donate 用戶姓名
time_zone	int64	[必填], -12 ~ 12, 錯誤格式回傳 +8 時區資料

GetRewardDetailV2Res

Field	Type	Label	Description
reward_detail_data	GetRewardDetailInfo	repeated
total	int64		查詢時間段的總數量

GetRewardHistoryV2Req

Field	Type	Label	Description
access_token	string

GetRewardHistoryV2Res

Field	Type	Description
current_period_amount	double
previous_period_amount	double
unpaid_amount	double
total_amount	double	總收益
gift_scale	GetRewardHistoryV2Res.GiftScale	禮物比例

GetRewardHistoryV2Res.GiftScale

Field	Type	Label	Description
event_gift_percent	int64		應援比例
live_gift_percent	int64		直播比例

GetUserBadgesReq

Field	Type	Label	Description
object_id	string		取得誰的

GetUserBadgesRes

Field	Type	Label	Description
badge_infos	BadgeInfos	repeated

GetUserDetailReq

Field	Type	Label	Description
access_token	string		[必填] token

GetUserDetailRes

Field	Type	Label	Description
diamond_amount	int64
coin_amount	int64
level	int64

GiftHistory

Field	Type	Label	Description
object_id	string
gift_package	GiftPackage
message	string
created_at	google.protobuf.Timestamp
amount	int64

GiftPackage

Field	Type	Label	Description
id	int64
name	string
diamond_price	int64
img	string
animation	string
gift_type	string

DonateService

Method Name	Request Type	Response Type	Description
GetGiftPackages	GetGiftPackagesReq	GetGiftPackagesRes	送禮方案項目
BuyGift	BuyGiftReq	BuyGiftRes	贈送禮物
GetGiftHistory	GetGiftHistoryReq	GetGiftHistoryRes	讀取女郎收到的禮物與留言x
GetMyUnreadGift	GetMyUnreadGiftReq	GetMyUnreadGiftRes	我未讀的禮物
GetUserBadges	GetUserBadgesReq	GetUserBadgesRes	讀取用戶的勳章
GetDonateRecord	GetDonateRecordReq	GetDonateRecordRes	取得應援紀錄
GetRewardHistoryV2	GetRewardHistoryV2Req	GetRewardHistoryV2Res	女郎收益V2 (含總收益，禮物比例)
GetRewardDetailV2	GetRewardDetailV2Req	GetRewardDetailV2Res	女郎收益詳細記錄
GetUserDetail	GetUserDetailReq	GetUserDetailRes	GetUserDetail 紅鑽/Face券/等級

donateadmin/v2/admin.proto

CoinRecord

Field	Type	Label	Description
id	int64
order_no	string
user_object_id	string
user_name	string
scanner_object_id	string
scanner_name	string
amount	int64
status	donateenums.OrderStatus
update_at	google.protobuf.Timestamp

CoinRecordListReq

Field	Type	Description
access_token	string
user_object_id	string	optional
scanner_object_id	string	optional
start_at	google.protobuf.Timestamp	optional
end_at	google.protobuf.Timestamp	optional
page	int64
limit	int64
trade_id	string	optional

CoinRecordListRes

Field	Type	Label	Description
record	CoinRecord	repeated
total	int64

DiamondSubscribe

Field	Type	Label	Description
id	int64
object_id	string
phone	string
diamond_package_name	string
status	SubscribeStatus
invoice_type	string
invoice_data	string
created_at	google.protobuf.Timestamp

GetCoinRecordDetailReq

Field	Type	Label	Description
access_token	string
id	int64

GetCoinRecordDetailRes

Field	Type	Description
id	int64
order_no	string
user_object_id	string
user_name	string
scanner_object_id	string
scanner_name	string
group_name	string
amount	int64
profit	donateenums.ProfitType	分潤類別
status	donateenums.OrderStatus
created_at	google.protobuf.Timestamp
update_at	google.protobuf.Timestamp
receiver_object_id	string	接收者 objectID
receiver_name	string	接收者名稱

GetDiamondSubscribeListReq

Field	Type	Description
access_token	string
page	int64
limit	int64
object_id	string	optional
status	SubscribeStatus	optional
phone	string

GetDiamondSubscribeListRes

Field	Type	Label	Description
subscribes	DiamondSubscribe	repeated
total	int64

GetPersonalDiamondListReq

Field	Type	Description
access_token	string
member_object_id	string	[必填]會員 objectID
source	donateenums.ConsumeSourceType	商品分類
page	int64
limit	int64

GetPersonalDiamondListRes

Field	Type	Label	Description
info	PersonalDiamondInfo	repeated
member_name	string		會員名稱
member_diamond_amount	int64		會員餘額
total	int64

GetRewardItemListReq

Field	Type	Label	Description
secret_key	string
activity_id	int64
start_at	google.protobuf.Timestamp
end_at	google.protobuf.Timestamp
status	int64

GetRewardItemListRes

Field	Type	Label	Description
items	RewardItem	repeated

GetSourceCoinDetailRes

Field	Type	Description
trade_id	string
source	donateenums.ConsumeSourceType	商品分類
product_name	string	商品名稱
amount	int64	數量
member_object_id	string	會員 objectID
scanner_object_id	string	掃描者 objectID
scanner_name	string	掃描者名稱
group_name	string	群組名稱
profit	donateenums.ProfitType	分潤
receiver_object_id	string	接收者 objectID
receiver_name	string	接收者名稱
member_name	string	會員名稱

GetSourceCoinPackageDetailRes

Field	Type	Description
trade_id	string
source	donateenums.ConsumeSourceType	商品分類
product_name	string	商品名稱
member_object_id	string	會員 objectID
twd_amount	int64	台幣支付金額
pay_order_no	string	pay 訂單號
member_name	string	會員名稱

GetSourceDetailReq

Field	Type	Label	Description
access_token	string
trade_id	string		[必填]服務訂單號

GetSourceDiamondPackageDetailRes

Field	Type	Description
trade_id	string
source	donateenums.ConsumeSourceType	商品分類
product_name	string	商品名稱
member_object_id	string	會員 objectID
twd_amount	int64	台幣支付金額
pay_order_no	string	pay 訂單號
member_name	string	會員名稱

GetSourceGiftDetailRes

Field	Type	Description
trade_id	string
source	donateenums.ConsumeSourceType	商品分類
product_name	string	商品名稱
member_object_id	string	會員 objectID
lady_object_id	string	女郎 objectID
lady_name	string	女郎名稱
member_name	string	會員名稱

GetTradeRecordListReq

Field	Type	Description
access_token	string
created_start_at	google.protobuf.Timestamp	建立時間-開始
created_end_at	google.protobuf.Timestamp	建立時間-結束
complete_start_at	google.protobuf.Timestamp	完成時間-開始
complete_end_at	google.protobuf.Timestamp	完成時間-結束
member_object_id	string	會員 objectID
member_phone	string	會員手機號碼
trade_id	string	訂單號碼
status	donateenums.TradeStatus	訂單狀態
source	donateenums.ConsumeSourceType	商品分類
page	int64
limit	int64
currency	donateenums.CurrencyType	幣別
pay_order_no	string	pay的訂單號碼

GetTradeRecordListRes

Field	Type	Label	Description
info	TradeRecordInfo	repeated
total	int64

Gift

Field	Type	Label	Description
id	int64
name	string
price	int64
image	string
start_at	google.protobuf.Timestamp
end_at	google.protobuf.Timestamp
created_at	google.protobuf.Timestamp
updated_at	google.protobuf.Timestamp

GiftOrder

Field	Type	Label	Description
id	int64
transaction_id	string
order_no	string
total_price	int64
status	int64
created_at	google.protobuf.Timestamp
updated_at	google.protobuf.Timestamp

GiftRecord

Field	Type	Description
id	int64
user_object_id	string
lady_object_id	string
gift	Gift
gift_amount	int64
gift_order	GiftOrder
status	int64	0:未完成，1：完成，-1：退款
created_at	google.protobuf.Timestamp

GiftRecordListReq

Field	Type	Description
access_token	string
page	int64
limit	List.Limit
user_object_id	string	optional
lady_object_id	string	optional
start_at	google.protobuf.Timestamp	optional
end_at	google.protobuf.Timestamp	optional

GiftRecordListRes

Field	Type	Label	Description
records	GiftRecord	repeated
total	int64

List

PersonalDiamondInfo

Field	Type	Description
id	int64	ID
trade_id	string	服務訂單號
source	donateenums.ConsumeSourceType	商品分類
before_diamond	int64	紅鑽異動前
after_diamond	int64	紅鑽異動後
diamond_amount	int64	紅鑽異動數
created_at	google.protobuf.Timestamp	建立時間
memo	string	備註

RefundDiamondReq

Field	Type	Label	Description
transc_id	string
order_no	string
sign	string

RefundDiamondRes

RefundReq

Field	Type	Description
access_token	string
trade_id	string	[必填]服務訂單號
source	donateenums.ConsumeSourceType	商品分類
need_refund_fee	bool	抽手續費

RefundRes

RewardItem

Field	Type	Label	Description
id	int64
name	string
price	int64
status	int64

TradeRecordInfo

Field	Type	Description
id	int64	ID
trade_id	string	服務訂單號
source	donateenums.ConsumeSourceType	商品分類
member_object_id	string	會員 objectID
member_name	string	會員名稱
product_name	string	商品名稱
diamond_amount	int64	鑽石數量 // 棄用
status	donateenums.TradeStatus	訂單狀態
created_at	google.protobuf.Timestamp	建立時間
complete_at	google.protobuf.Timestamp	完成時間
currency	donateenums.CurrencyType	幣別
amount	int64	數量
pay_order_no	string	pay的訂單號碼

UnsubscribeDiamondReq

Field	Type	Label	Description
access_token	string
object_id	string
subscribe_id	int64

UnsubscribeDiamondRes

List.Limit

Name	Number	Description
Size_0	0
Size_10	10
Size_25	25
Size_50	50
Size_100	100

SubscribeStatus

Name	Number	Description
SB_Default	0
SB_Unsubscribe	1
SB_Subscribe	2

AdminService

Method Name	Request Type	Response Type	Description
GiftRecordList	GiftRecordListReq	GiftRecordListRes	送禮紀錄
GetDiamondSubscribeList	GetDiamondSubscribeListReq	GetDiamondSubscribeListRes	月卡資訊
UnsubscribeDiamond	UnsubscribeDiamondReq	UnsubscribeDiamondRes	月卡退訂
RefundDiamond	RefundDiamondReq	RefundDiamondRes	RefundDiamond 退鑽沖銷流程
GetRewardItemList	GetRewardItemListReq	GetRewardItemListRes	GetRewardItemList 取得禮物列表
GetTradeRecordList	GetTradeRecordListReq	GetTradeRecordListRes	GetTradeRecordList 取得訂單紀錄
GetPersonalDiamondList	GetPersonalDiamondListReq	GetPersonalDiamondListRes	GetPersonalDiamondList 取得紅鑽個人紀錄
GetSourceGiftDetail	GetSourceDetailReq	GetSourceGiftDetailRes	GetSourceGiftDetail 取得紅鑽禮物詳細資料
GetSourceDiamondPackageDetail	GetSourceDetailReq	GetSourceDiamondPackageDetailRes	GetSourceDiamondPackageDetail 取得紅鑽禮包詳細資料
GetSourceCoinPackageDetail	GetSourceDetailReq	GetSourceCoinPackageDetailRes	GetSourceCoinPackageDetail 取得Face券禮包詳細資料
GetSourceCoinDetail	GetSourceDetailReq	GetSourceCoinDetailRes	GetSourceCoinDetail 取得花費Face券詳細資料
Refund	RefundReq	RefundRes	Refund 退單
CoinRecordList	CoinRecordListReq	CoinRecordListRes	CoinRecordList Face轉移紀錄
GetCoinRecordDetail	GetCoinRecordDetailReq	GetCoinRecordDetailRes	GetCoinRecordDetail Face轉移紀錄詳細資料

jkfpay/transaction_api/transaction_api.proto

CreateTransactionTokenReq

Field	Type	Label	Description
app_id	string
order_id	string
product_name	string
money	transaction.Money
callback_url	string
object_id	string
jpoint_discount	int64
check_code	string
redirect_url	string
require_apea_twid	bool
invoice_remark	string		invoice_remark: optional, 發票備註, 只能由產品端設定, 所以沒有在 SetTransactionInvoice 裡設定
payment_channels	transaction.PaymentChannel	repeated	payment_channels: optional, 指定訂單付款方式

CreateTransactionTokenRes

Field	Type	Label	Description
transaction_token	string
transc_id	string

TransactionApiService

Method Name	Request Type	Response Type	Description
CreateTransactionToken	CreateTransactionTokenReq	CreateTransactionTokenRes	生成 transaction token

jpay/direct/v1/base.proto

jpay/direct/v1/transaction.proto

MakeCashTransactionPayload

Field	Type	Label	Description
jpay_app_token	string		請使用 app_id, app_secret 產生 jpay_app_token
order_id	string		產品端自訂義的訂單編號
product_name	string		產品名稱
money	transaction.Money		交易金額
callback_url	string		產品端的交易結果回調網址，JPay 會在交易完成後呼叫此網址
member_uid	int64		用戶的 pan uid
jpoints_order_id	string	optional	JPoints platform order id
invoice_remark	string		invoice_remark: optional, 發票備註, 只能由產品端設定, 所以沒有在 SetTransactionInvoice 裡設定

MakeCashTransactionResult

Field	Type	Label	Description
transaction_id	string		JPay 系統訂單編號

MakeCashTransactionResult.Error

MakeCashTransactionResult.Error.Code

Name	Number	Description
None	0
InvalidJpayAppToken	1001
InvalidOrderId	1002
InvalidProductName	1003
InvalidMoney	1004
InvalidCallbackUrl	1005
InvalidMemberUid	1006
MemberPhoneNotFound	1007	用戶尚未綁定手機號碼，請在前端透過 cat 呼叫綁定手機號碼流程
OtherFailed	9999

TransactionCommand

Method Name	Request Type	Response Type	Description
MakeCashTransaction	MakeCashTransactionPayload	MakeCashTransactionResult	產品端現金交易，現場人員收得符合數額之現金後可以執行此 API，執行成功後 JPay 會開立發票並回傳 transaction_id

payadmin/admin.proto

AppListReq

Field	Type	Label	Description
admin_token	string

AppListRes

Field	Type	Label	Description
application	Application	repeated

Application

Field	Type	Label	Description
app_id	string
app_name	string
status	int64
jpoint_app_name	string
jpoint_app_secret_key	string

CheckTransactionReq

Field	Type	Label	Description
admin_token	string
trade_id	string

CheckTransactionRes

Field	Type	Label	Description
result	string

CreateAppPaymentReq

Field	Type	Label	Description
admin_token	string
app_psg	CreateAppPaymentReq.CreateAppPsg

CreateAppPaymentReq.CreateAppPsg

Field	Type	Label	Description
app_id	string
psg_id	string
psg_method_id	string

CreateAppPaymentRes

CreateAppReq

Field	Type	Label	Description
admin_token	string
status	int64
app_name	string
jpoint_app_name	string
jpoint_app_secret_key	string

CreateAppRes

Field	Type	Label	Description
app_id	string

CreatePaymentMethodReq

Field	Type	Label	Description
admin_token	string
psg_method	model.PsgMethod

CreatePaymentMethodRes

Field	Type	Label	Description
psg_method_id	string

CreatePaymentServiceGatewayReq

Field	Type	Label	Description
admin_token	string
psg	model.Psg

CreatePaymentServiceGatewayRes

CreditCard

Field	Type	Label	Description
id	string
phone_id	string
l4	string
created_at	google.protobuf.Timestamp
psg	model.Psg

DiamondLog

Field	Type	Label	Description
id	int64
user_object_id	string
trade_id	string
amount_before	int64
amount_after	int64
created_at	google.protobuf.Timestamp
memo	string

DiamondOrder

Field	Type	Label	Description
id	int64

DiamondSubscribe

Field	Type	Label	Description
id	int64
object_id	string
phone	string
diamond_package_name	string
status	SubscribeStatus
invoice_type	string
invoice_data	string
created_at	google.protobuf.Timestamp

GetAppPaymentsReq

app psg

Field	Type	Label	Description
admin_token	string
app_id	string

GetAppPaymentsRes

Field	Type	Label	Description
app_psg	model.AdminAppPsg	repeated

GetAppReq

Field	Type	Label	Description
admin_token	string
app_id	string

GetAppRes

Field	Type	Label	Description
application	Application

GetBindCreditcardListReq

Field	Type	Description
admin_token	string
page	int64
limit	int64
phone_id	string	optional

GetBindCreditcardListRes

Field	Type	Label	Description
creditcards	CreditCard	repeated
total	int64

GetChannelsReq

channel

Field	Type	Label	Description
admin_token	string
app_id	string

GetChannelsRes

Field	Type	Label	Description
channels	transaction.PaymentChannel	repeated

GetDiamondSubscribeListReq

Field	Type	Description
admin_token	string
page	int64
limit	int64
object_id	string	optional
status	SubscribeStatus	optional
phone	string

GetDiamondSubscribeListRes

Field	Type	Label	Description
subscribes	DiamondSubscribe	repeated
total	int64

GetMemberInfoReq

Field	Type	Label	Description
phone	string
user_object_id	string
secrect	string

GetMemberInfoRes

Field	Type	Label	Description
diamond_amount	int64
jr_vip_expired_at	google.protobuf.Timestamp

GetPaymentMethodListReq

Field	Type	Label	Description
admin_token	string

GetPaymentMethodListRes

Field	Type	Label	Description
psg_methods	model.PsgMethod	repeated

GetPaymentMethodReq

Field	Type	Label	Description
admin_token	string
psg_method_id	string

GetPaymentMethodRes

Field	Type	Label	Description
psg_method	model.PsgMethod

GetPaymentServiceGatewayReq

Field	Type	Label	Description
admin_token	string
psg_id	string

GetPaymentServiceGatewayRes

Field	Type	Label	Description
psg	model.Psg

GetPaymentServiceGatewaysReq

psg

Field	Type	Description
admin_token	string
app_id	string	optional
channels	transaction.PaymentChannel	optional

GetPaymentServiceGatewaysRes

Field	Type	Label	Description
psgs	model.Psg	repeated

GetTranscRecordListReq

Field	Type	Description
admin_token	string
page	int64
limit	int64
status	int32	optional
user_object_id	string	optional
trade_id	string	optional
upstream_trade_id	string	optional
downstream_trade_id	string	optional
start_at	google.protobuf.Timestamp	optional
end_at	google.protobuf.Timestamp	optional
start_completed_at	google.protobuf.Timestamp	optional
end_completed_at	google.protobuf.Timestamp	optional
phone_number	string	optional
currency	Currency	optional
app_id	string	optional

GetTranscRecordListRes

Field	Type	Label
records	TranscRecord	repeated
total	int64
totalAmount	int64

GetUserDiamondLogReq

Field	Type	Label	Description
admin_token	string
page	int64
limit	int64
user_object_id	string

GetUserDiamondLogRes

Field	Type	Label
diamond_logs	DiamondLog	repeated
total	int64
user_balance	int64

RevokeDiamondReq

Field	Type	Label	Description
admin_token	string
order_id	int64

RevokeDiamondRes

RevokeOrderReq

Field	Type	Label	Description
admin_token	string
trade_id	string

RevokeOrderRes

TranscRecord

Field	Type	Description
status	int32
user_object_id	string
trade_id	string
downstream_trade_id	string
upstream_trade_id	string
product_name	string
required_amount	int64
received_amount	int64
currency	string
created_at	google.protobuf.Timestamp
phone	string
redirect_url	string
diamond_order	DiamondOrder
completed_at	google.protobuf.Timestamp
ip	string
received_jpoint	int64
phone_id	string
application_name	string
psg_provider	string
psg_merchant_id	string
psg_method_channel	string	廢棄
paymentType	transaction.PaymentType
failed_message	string

UnbindCreditcardReq

Field	Type	Label	Description
admin_token	string
creditcard_id	string

UnbindCreditcardRes

UnsubscribeDiamondReq

Field	Type	Label	Description
admin_token	string
object_id	string
subscribe_id	int64

UnsubscribeDiamondRes

UpdateAppPaymentPriorityReq

Field	Type	Label	Description
admin_token	string
ids	int64	repeated

UpdateAppPaymentPriorityRes

UpdateAppPaymentStatusReq

Field	Type	Label	Description
admin_token	string
id	int64
status	model.PsgMethodStatus

UpdateAppPaymentStatusRes

UpdateAppReq

Field	Type	Label	Description
admin_token	string
app_id	string
app_name	string
status	int64
jpoint_app_name	string
jpoint_app_secret_key	string

UpdateAppRes

UpdateAppStatusReq

Field	Type	Label	Description
admin_token	string
app_id	string
status	int64

UpdateAppStatusRes

UpdatePaymentMethodReq

Field	Type	Label	Description
admin_token	string
psg_method	model.PsgMethod

UpdatePaymentMethodRes

UpdatePaymentMethodStatusReq

Field	Type	Label	Description
admin_token	string
psg_method_id	string
status	int64

UpdatePaymentMethodStatusRes

UpdatePaymentServiceGatewayReq

Field	Type	Label	Description
admin_token	string
psg	model.Psg

UpdatePaymentServiceGatewayRes

UpdatePaymentServiceGatewayStatusReq

Field	Type	Label	Description
admin_token	string
psg_id	string
status	int64

UpdatePaymentServiceGatewayStatusRes

WithdrawOrderReq

Field	Type	Label	Description
admin_token	string
trade_id	string

WithdrawOrderRes

Currency

Name	Number	Description
CURRENCY_NOT_SET	0
CURRENCY_TWD	1
CURRENCY_USD	2
CURRENCY_DIAMOND	3
CURRENCY_USD_CENTS	4

SubscribeStatus

Name	Number	Description
SB_Default	0
SB_Unsubscribe	1
SB_Subscribe	2

AdminService

Method Name	Request Type	Response Type	Description
CheckTransaction	CheckTransactionReq	CheckTransactionRes	查詢 transaction 結果
GetTranscRecordList	GetTranscRecordListReq	GetTranscRecordListRes
GetUserDiamondLog	GetUserDiamondLogReq	GetUserDiamondLogRes
AppList	AppListReq	AppListRes	application
CreateApp	CreateAppReq	CreateAppRes
GetApp	GetAppReq	GetAppRes
UpdateApp	UpdateAppReq	UpdateAppRes
RevokeDiamond	RevokeDiamondReq	RevokeDiamondRes
RevokeOrder	RevokeOrderReq	RevokeOrderRes	退款
WithdrawOrder	WithdrawOrderReq	WithdrawOrderRes	退單
GetBindCreditcardList	GetBindCreditcardListReq	GetBindCreditcardListRes	綁卡資訊
UnbindCreditcard	UnbindCreditcardReq	UnbindCreditcardRes
GetMemberInfo	GetMemberInfoReq	GetMemberInfoRes	for pan
GetDiamondSubscribeList	GetDiamondSubscribeListReq	GetDiamondSubscribeListRes	月卡資訊
UnsubscribeDiamond	UnsubscribeDiamondReq	UnsubscribeDiamondRes
GetPaymentServiceGateways	GetPaymentServiceGatewaysReq	GetPaymentServiceGatewaysRes	psg
CreatePaymentServiceGateway	CreatePaymentServiceGatewayReq	CreatePaymentServiceGatewayRes
GetPaymentServiceGateway	GetPaymentServiceGatewayReq	GetPaymentServiceGatewayRes
UpdatePaymentServiceGateway	UpdatePaymentServiceGatewayReq	UpdatePaymentServiceGatewayRes
GetAppPayments	GetAppPaymentsReq	GetAppPaymentsRes	app_psg (對應table app_psg_method, 舊版app_psg廢棄)
CreateAppPayment	CreateAppPaymentReq	CreateAppPaymentRes
UpdateAppPaymentStatus	UpdateAppPaymentStatusReq	UpdateAppPaymentStatusRes
UpdateAppPaymentPriority	UpdateAppPaymentPriorityReq	UpdateAppPaymentPriorityRes
CreatePaymentMethod	CreatePaymentMethodReq	CreatePaymentMethodRes	psg_method
GetPaymentMethod	GetPaymentMethodReq	GetPaymentMethodRes
GetPaymentMethodList	GetPaymentMethodListReq	GetPaymentMethodListRes
UpdatePaymentMethod	UpdatePaymentMethodReq	UpdatePaymentMethodRes

Scalar Value Types

.proto Type	Notes	C++	Java	Python	Go	C#	PHP	Ruby
double		double	double	float	float64	double	float	Float
float		float	float	float	float32	float	float	Float
int32	Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead.	int32	int	int	int32	int	integer	Bignum or Fixnum (as required)
int64	Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead.	int64	long	int/long	int64	long	integer/string	Bignum
uint32	Uses variable-length encoding.	uint32	int	int/long	uint32	uint	integer	Bignum or Fixnum (as required)
uint64	Uses variable-length encoding.	uint64	long	int/long	uint64	ulong	integer/string	Bignum or Fixnum (as required)
sint32	Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s.	int32	int	int	int32	int	integer	Bignum or Fixnum (as required)
sint64	Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s.	int64	long	int/long	int64	long	integer/string	Bignum
fixed32	Always four bytes. More efficient than uint32 if values are often greater than 2^28.	uint32	int	int	uint32	uint	integer	Bignum or Fixnum (as required)
fixed64	Always eight bytes. More efficient than uint64 if values are often greater than 2^56.	uint64	long	int/long	uint64	ulong	integer/string	Bignum
sfixed32	Always four bytes.	int32	int	int	int32	int	integer	Bignum or Fixnum (as required)
sfixed64	Always eight bytes.	int64	long	int/long	int64	long	integer/string	Bignum
bool		bool	boolean	boolean	bool	bool	boolean	TrueClass/FalseClass
string	A string must always contain UTF-8 encoded or 7-bit ASCII text.	string	String	str/unicode	string	string	string	String (UTF-8)
bytes	May contain any arbitrary sequence of bytes.	string	ByteString	str	[]byte	ByteString	string	String (ASCII-8BIT)

v0.0.11 ​

jpay-direct-proto ​

transaction/transaction.proto ​

CheckFreeDiamondReq ​

CheckFreeDiamondRes ​

CompleteTransactionReq ​

CompleteTransactionRes ​

CreateTransactionTokenReq ​

CreateTransactionTokenRes ​

CreditCard ​

CreditCard.Status ​

DiamondPackage ​

DiamondRecord ​

DiscountTransactionReq ​

DiscountTransactionRes ​

FormData ​

FormDataOptions ​

GetBonusAmountReq ​

GetBonusAmountRes ​

GetDiamondAmountReq ​

GetDiamondAmountRes ​

GetDiamondPackagesReq ​

GetDiamondPackagesRes ​

GetDiamondRecordReq ​

GetDiamondRecordRes ​

GetExchangeRateReq ​

GetExchangeRateRes ​

GetFreeDiamondAmountReq ​

GetFreeDiamondAmountRes ​

GetFreeDiamondEarnTimesReq ​

GetFreeDiamondEarnTimesRes ​

GetPaymentInfoReq ​

GetPaymentInfoRes ​

GetPurchaseRecordReq ​

GetPurchaseRecordRes ​

GetTransactionTokenReq ​

GetTransactionTokenRes ​

InvoiceSetting ​

Money ​

PaymentMethod ​

PaymentParamsOfCreditCard ​

PaymentParamsOfDiamond ​

PaymentParamsOfEcpayInpay ​

PaymentParamsOfHappypay ​

PaymentParamsOfTapPay ​

PurchaseDiamondReq ​

PurchaseRecord ​

QueryTransactionReq ​

QueryTransactionRes ​

RefundTransactionReq ​

RefundTransactionRes ​

SetPaymentMethodReq ​

SetPaymentMethodRes ​

SetTransactionInvoiceReq ​

SetTransactionInvoiceRes ​

TotalDepositAmountsReq ​

TotalDepositAmountsRes ​

TransactionTokenInfoReq ​

TransactionTokenInfoRes ​

UseBonusDiamondReq ​

UseBonusDiamondRes ​

WSMessage ​

CreditCard.Status.Value ​

Currency ​

DiamondPackageType ​

DiamondRecordType ​

ErrCTCode ​

InvoiceStatus ​

InvoiceType ​

PaymentChannel ​

PaymentType ​

RefundTransactionStatus ​

TransactionStatus ​

WSMessageType ​

TransactionService ​

model/data_config.proto ​

model/model.proto ​

AdminAppPsg ​

Ga4Parameter ​

Psg ​

v0.0.11

jpay-direct-proto

transaction/transaction.proto

CheckFreeDiamondReq

CheckFreeDiamondRes

CompleteTransactionReq

CompleteTransactionRes

CreateTransactionTokenReq

CreateTransactionTokenRes

CreditCard

CreditCard.Status

DiamondPackage

DiamondRecord

DiscountTransactionReq

DiscountTransactionRes

FormData

FormDataOptions

GetBonusAmountReq

GetBonusAmountRes

GetDiamondAmountReq

GetDiamondAmountRes

GetDiamondPackagesReq

GetDiamondPackagesRes

GetDiamondRecordReq

GetDiamondRecordRes

GetExchangeRateReq

GetExchangeRateRes

GetFreeDiamondAmountReq

GetFreeDiamondAmountRes

GetFreeDiamondEarnTimesReq

GetFreeDiamondEarnTimesRes

GetPaymentInfoReq

GetPaymentInfoRes

GetPurchaseRecordReq

GetPurchaseRecordRes

GetTransactionTokenReq

GetTransactionTokenRes

InvoiceSetting

Money

PaymentMethod

PaymentParamsOfCreditCard

PaymentParamsOfDiamond

PaymentParamsOfEcpayInpay

PaymentParamsOfHappypay

PaymentParamsOfTapPay

PurchaseDiamondReq

PurchaseRecord

QueryTransactionReq

QueryTransactionRes

RefundTransactionReq

RefundTransactionRes

SetPaymentMethodReq

SetPaymentMethodRes

SetTransactionInvoiceReq

SetTransactionInvoiceRes

TotalDepositAmountsReq

TotalDepositAmountsRes

TransactionTokenInfoReq

TransactionTokenInfoRes

UseBonusDiamondReq

UseBonusDiamondRes

WSMessage

CreditCard.Status.Value

Currency

DiamondPackageType

DiamondRecordType

ErrCTCode

InvoiceStatus

InvoiceType

PaymentChannel

PaymentType

RefundTransactionStatus

TransactionStatus

WSMessageType

TransactionService

model/data_config.proto

model/model.proto

AdminAppPsg

Ga4Parameter

Psg