@reglow/reglow 0.12.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -31,7 +31,7 @@ const JWT_SECRET = str(env.JWT_SECRET, "change-me-in-production");
31
31
  const settings = {
32
32
  // Application
33
33
  APP_NAME: str(env.APP_NAME, "ReglowAdmin"),
34
- APP_VERSION: str(env.APP_VERSION, "0.12.0"),
34
+ APP_VERSION: str(env.APP_VERSION, "0.13.0"),
35
35
  APP_ENV: str(env.APP_ENV, "dev"),
36
36
  DEBUG: bool(env.DEBUG, false),
37
37
  PORT: int(env.PORT, 9520),
@@ -380,10 +380,75 @@ export interface PaymentOrder extends TimestampFields {
380
380
  trade_no?: string | null;
381
381
  qr_code?: string | null;
382
382
  paid_at?: AnyDate;
383
+ refunded_amount_cents?: number;
384
+ split_amount_cents?: number;
385
+ reconcile_checked_at?: AnyDate;
383
386
  biz_type?: string | null;
384
387
  biz_id?: string | null;
385
388
  remark?: string | null;
386
389
  }
390
+ export interface PaymentRefund extends TimestampFields {
391
+ id: number;
392
+ refund_no: string;
393
+ payment_order_id: number;
394
+ out_trade_no: string;
395
+ provider: string;
396
+ amount_cents: number;
397
+ total_amount_cents: number;
398
+ reason?: string | null;
399
+ source: string;
400
+ status: string;
401
+ channel_refund_no?: string | null;
402
+ error_msg?: string | null;
403
+ operator_id?: number | null;
404
+ retry_count?: number;
405
+ refunded_at?: AnyDate;
406
+ }
407
+ export interface PaymentSplit extends TimestampFields {
408
+ id: number;
409
+ split_no: string;
410
+ payment_order_id: number;
411
+ out_trade_no: string;
412
+ provider: string;
413
+ transaction_id?: string | null;
414
+ total_amount_cents: number;
415
+ split_amount_cents: number;
416
+ status: string;
417
+ channel_split_no?: string | null;
418
+ error_msg?: string | null;
419
+ source: string;
420
+ operator_id?: number | null;
421
+ remark?: string | null;
422
+ finished_at?: AnyDate;
423
+ }
424
+ export interface PaymentSplitReceiver extends TimestampFields {
425
+ id: number;
426
+ split_id: number;
427
+ receiver_type: string;
428
+ account: string;
429
+ name?: string | null;
430
+ amount_cents: number;
431
+ description?: string | null;
432
+ status: string;
433
+ channel_detail_id?: string | null;
434
+ error_msg?: string | null;
435
+ }
436
+ export interface PaymentSplitReturn extends TimestampFields {
437
+ id: number;
438
+ return_no: string;
439
+ split_id: number;
440
+ payment_order_id: number;
441
+ out_trade_no: string;
442
+ provider: string;
443
+ receiver_type: string;
444
+ receiver_account: string;
445
+ amount_cents: number;
446
+ reason?: string | null;
447
+ status: string;
448
+ channel_return_no?: string | null;
449
+ error_msg?: string | null;
450
+ operator_id?: number | null;
451
+ }
387
452
  export interface Region extends TimestampFields {
388
453
  id: number;
389
454
  name: string;
@@ -40,6 +40,10 @@ export declare const TableNames: {
40
40
  readonly VideoCategory: "cms_video_category";
41
41
  readonly VideoCollection: "cms_video_collection";
42
42
  readonly PaymentOrder: "payment_order";
43
+ readonly PaymentRefund: "payment_refund";
44
+ readonly PaymentSplit: "payment_split";
45
+ readonly PaymentSplitReceiver: "payment_split_receiver";
46
+ readonly PaymentSplitReturn: "payment_split_return";
43
47
  readonly Region: "biz_region";
44
48
  readonly CSConfig: "cs_config";
45
49
  readonly CSKnowledgeBase: "cs_knowledge_base";
@@ -98,6 +102,10 @@ export declare const ModelRegistry: {
98
102
  VideoCategory: "cms_video_category";
99
103
  VideoCollection: "cms_video_collection";
100
104
  PaymentOrder: "payment_order";
105
+ PaymentRefund: "payment_refund";
106
+ PaymentSplit: "payment_split";
107
+ PaymentSplitReceiver: "payment_split_receiver";
108
+ PaymentSplitReturn: "payment_split_return";
101
109
  Region: "biz_region";
102
110
  CSConfig: "cs_config";
103
111
  CSKnowledgeBase: "cs_knowledge_base";
@@ -40,6 +40,10 @@ export const TableNames = {
40
40
  VideoCategory: "cms_video_category",
41
41
  VideoCollection: "cms_video_collection",
42
42
  PaymentOrder: "payment_order",
43
+ PaymentRefund: "payment_refund",
44
+ PaymentSplit: "payment_split",
45
+ PaymentSplitReceiver: "payment_split_receiver",
46
+ PaymentSplitReturn: "payment_split_return",
43
47
  Region: "biz_region",
44
48
  CSConfig: "cs_config",
45
49
  CSKnowledgeBase: "cs_knowledge_base",
@@ -1 +1 @@
1
- {"version":3,"file":"models.js","sourceRoot":"","sources":["../../../reglow/core/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,cAAc;IACxB,YAAY,EAAE,mBAAmB;IACjC,YAAY,EAAE,mBAAmB;IACjC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,eAAe;IACzB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAEhB,SAAS,EAAE,YAAY;IACvB,UAAU,EAAE,aAAa;IACzB,YAAY,EAAE,mBAAmB;IACjC,QAAQ,EAAE,eAAe;IAEzB,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,gBAAgB;IAC3B,aAAa,EAAE,oBAAoB;IAEnC,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,eAAe;IAEzB,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,oBAAoB;IACnC,qBAAqB,EAAE,6BAA6B;IAEpD,OAAO,EAAE,aAAa;IACtB,eAAe,EAAE,sBAAsB;IACvC,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,iBAAiB;IAE7B,SAAS,EAAE,eAAe;IAC1B,gBAAgB,EAAE,uBAAuB;IAEzC,OAAO,EAAE,aAAa;IACtB,eAAe,EAAE,sBAAsB;IACvC,iBAAiB,EAAE,wBAAwB;IAE3C,KAAK,EAAE,WAAW;IAClB,UAAU,EAAE,iBAAiB;IAC7B,aAAa,EAAE,oBAAoB;IAEnC,KAAK,EAAE,WAAW;IAClB,aAAa,EAAE,oBAAoB;IACnC,eAAe,EAAE,sBAAsB;IAEvC,YAAY,EAAE,eAAe;IAE7B,MAAM,EAAE,YAAY;IAEpB,QAAQ,EAAE,WAAW;IACrB,eAAe,EAAE,mBAAmB;IACpC,gBAAgB,EAAE,oBAAoB;IACtC,UAAU,EAAE,cAAc;IAC1B,SAAS,EAAE,YAAY;IACvB,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,YAAY;IAEvB,gBAAgB,EAAE,oBAAoB;IAEtC,8CAA8C;IAC9C,KAAK,EAAE,cAAc;IACrB,UAAU,EAAE,aAAa;IACzB,cAAc,EAAE,iBAAiB;IACjC,SAAS,EAAE,YAAY;IACvB,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,YAAY;IACvB,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,iBAAiB;CACxB,CAAC;AAIX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,UAAU;IACb,GAAG,CAAC,IAA6B;QAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC"}
1
+ {"version":3,"file":"models.js","sourceRoot":"","sources":["../../../reglow/core/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,cAAc;IACxB,YAAY,EAAE,mBAAmB;IACjC,YAAY,EAAE,mBAAmB;IACjC,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,eAAe;IACzB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAEhB,SAAS,EAAE,YAAY;IACvB,UAAU,EAAE,aAAa;IACzB,YAAY,EAAE,mBAAmB;IACjC,QAAQ,EAAE,eAAe;IAEzB,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,gBAAgB;IAC3B,aAAa,EAAE,oBAAoB;IAEnC,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,eAAe;IAEzB,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,oBAAoB;IACnC,qBAAqB,EAAE,6BAA6B;IAEpD,OAAO,EAAE,aAAa;IACtB,eAAe,EAAE,sBAAsB;IACvC,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,iBAAiB;IAE7B,SAAS,EAAE,eAAe;IAC1B,gBAAgB,EAAE,uBAAuB;IAEzC,OAAO,EAAE,aAAa;IACtB,eAAe,EAAE,sBAAsB;IACvC,iBAAiB,EAAE,wBAAwB;IAE3C,KAAK,EAAE,WAAW;IAClB,UAAU,EAAE,iBAAiB;IAC7B,aAAa,EAAE,oBAAoB;IAEnC,KAAK,EAAE,WAAW;IAClB,aAAa,EAAE,oBAAoB;IACnC,eAAe,EAAE,sBAAsB;IAEvC,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,gBAAgB;IAC/B,YAAY,EAAE,eAAe;IAC7B,oBAAoB,EAAE,wBAAwB;IAC9C,kBAAkB,EAAE,sBAAsB;IAE1C,MAAM,EAAE,YAAY;IAEpB,QAAQ,EAAE,WAAW;IACrB,eAAe,EAAE,mBAAmB;IACpC,gBAAgB,EAAE,oBAAoB;IACtC,UAAU,EAAE,cAAc;IAC1B,SAAS,EAAE,YAAY;IACvB,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,YAAY;IAEvB,gBAAgB,EAAE,oBAAoB;IAEtC,8CAA8C;IAC9C,KAAK,EAAE,cAAc;IACrB,UAAU,EAAE,aAAa;IACzB,cAAc,EAAE,iBAAiB;IACjC,SAAS,EAAE,YAAY;IACvB,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,YAAY;IACvB,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,iBAAiB;CACxB,CAAC;AAIX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,UAAU;IACb,GAAG,CAAC,IAA6B;QAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC"}
@@ -15,23 +15,85 @@ export interface CallbackResult {
15
15
  amount: number;
16
16
  status: string;
17
17
  }
18
+ export interface RefundResult {
19
+ success: boolean;
20
+ msg: string;
21
+ /** 商户退款单号 */
22
+ refundNo: string;
23
+ /** 原商户订单号 */
24
+ outTradeNo: string;
25
+ /** 渠道退款单号 */
26
+ channelRefundNo: string;
27
+ /** success / processing / failed */
28
+ status: string;
29
+ raw: Record<string, unknown>;
30
+ }
31
+ export interface SplitReceiver {
32
+ /** 微信 MERCHANT_ID / PERSONAL_OPENID;支付宝 userId / loginName */
33
+ receiverType: string;
34
+ account: string;
35
+ amountCents: number;
36
+ description?: string;
37
+ /** 个人接收方姓名(微信必填) */
38
+ name?: string;
39
+ }
40
+ export interface SplitResult {
41
+ success: boolean;
42
+ msg: string;
43
+ splitNo: string;
44
+ outTradeNo: string;
45
+ channelSplitNo: string;
46
+ /** processing / success / failed / finished */
47
+ status: string;
48
+ receivers: Array<Record<string, unknown>>;
49
+ raw: Record<string, unknown>;
50
+ }
18
51
  export declare abstract class PaymentProvider {
19
52
  provider_name: string;
53
+ supportsRefund: boolean;
54
+ supportsSplit: boolean;
55
+ supportsClose: boolean;
56
+ supportedPlatforms: string[];
57
+ /** 渠道能力声明(业务按此渲染退款/分账/关单入口,避免硬编码渠道判断) */
58
+ capabilities(): Record<string, unknown>;
20
59
  abstract createTrade(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string): Promise<PaymentResult>;
21
60
  createTradeByPlatform(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string, _platform?: string, _openid?: string, _buyerId?: string, _payerIp?: string): Promise<PaymentResult>;
22
61
  abstract queryTrade(outTradeNo: string): Promise<PaymentResult>;
62
+ /**
63
+ * 发起退款(原路退回)。
64
+ * @param refundNo 商户退款单号(同一笔退款重试必须复用,渠道侧幂等)
65
+ * @param totalCents 原订单金额(分,微信退款必填)
66
+ */
67
+ refund(_outTradeNo: string, _refundNo: string, _amountCents: number, _totalCents: number, _reason?: string): Promise<RefundResult>;
68
+ closeTrade(_outTradeNo: string): Promise<PaymentResult>;
69
+ queryRefund(_outTradeNo: string, _refundNo: string): Promise<RefundResult>;
70
+ split(_outTradeNo: string, _splitNo: string, _receivers: SplitReceiver[], _reason?: string, _transactionId?: string): Promise<SplitResult>;
71
+ querySplit(_outTradeNo: string, _splitNo: string, _transactionId?: string): Promise<SplitResult>;
72
+ returnSplit(_outTradeNo: string, _splitNo: string, _returnNo: string, _amountCents: number, _receiverType: string, _receiverAccount: string, _reason?: string, _transactionId?: string): Promise<SplitResult>;
73
+ finishSplit(_outTradeNo: string, _splitNo: string, _transactionId?: string, _reason?: string): Promise<SplitResult>;
74
+ bindSplitReceiver(_receiverType: string, _account: string, _name?: string, _relationType?: string): Promise<SplitResult>;
23
75
  abstract verifyCallback(headers: Record<string, string>, body: Buffer): Promise<CallbackResult>;
24
76
  successResponse(): string;
25
77
  }
26
78
  export declare class MockPaymentProvider extends PaymentProvider {
27
79
  provider_name: string;
80
+ supportsSplit: boolean;
28
81
  createTrade(outTradeNo: string, amountCents: number, _subject: string, _notifyUrl: string): Promise<PaymentResult>;
29
82
  createTradeByPlatform(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string, platform?: string): Promise<PaymentResult>;
30
83
  queryTrade(outTradeNo: string): Promise<PaymentResult>;
84
+ refund(outTradeNo: string, refundNo: string, _amountCents: number, _totalCents: number, _reason?: string): Promise<RefundResult>;
85
+ closeTrade(outTradeNo: string): Promise<PaymentResult>;
86
+ queryRefund(outTradeNo: string, refundNo: string): Promise<RefundResult>;
87
+ split(outTradeNo: string, splitNo: string, receivers: SplitReceiver[], _reason?: string, _transactionId?: string): Promise<SplitResult>;
88
+ querySplit(outTradeNo: string, splitNo: string, _transactionId?: string): Promise<SplitResult>;
89
+ returnSplit(outTradeNo: string, splitNo: string, returnNo: string, _amountCents: number, _receiverType: string, _receiverAccount: string, _reason?: string, _transactionId?: string): Promise<SplitResult>;
90
+ finishSplit(outTradeNo: string, splitNo: string, _transactionId?: string, _reason?: string): Promise<SplitResult>;
91
+ bindSplitReceiver(receiverType: string, account: string, _name?: string, _relationType?: string): Promise<SplitResult>;
31
92
  verifyCallback(_headers: Record<string, string>, body: Buffer): Promise<CallbackResult>;
32
93
  }
33
94
  export declare class AlipayProvider extends PaymentProvider {
34
95
  provider_name: string;
96
+ supportsSplit: boolean;
35
97
  private appId;
36
98
  private appPrivateKey;
37
99
  private alipayPublicKey;
@@ -43,6 +105,9 @@ export declare class AlipayProvider extends PaymentProvider {
43
105
  private verifyParams;
44
106
  private alipayPost;
45
107
  private callAlipay;
108
+ private callAlipayOauth;
109
+ /** 支付宝小程序 JSAPI 支付前置:my.getAuthCode 的 auth_code 换 user_id(buyer_id) */
110
+ getUserIdByCode(authCode: string): Promise<string>;
46
111
  createTrade(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string): Promise<PaymentResult>;
47
112
  createTradeCreate(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string, buyerId: string): Promise<PaymentResult>;
48
113
  createAppTrade(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string): Promise<PaymentResult>;
@@ -50,10 +115,20 @@ export declare class AlipayProvider extends PaymentProvider {
50
115
  createWapTrade(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string, returnUrl?: string): Promise<PaymentResult>;
51
116
  createTradeByPlatform(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string, platform?: string, _openid?: string, buyerId?: string): Promise<PaymentResult>;
52
117
  queryTrade(outTradeNo: string): Promise<PaymentResult>;
118
+ refund(outTradeNo: string, refundNo: string, amountCents: number, _totalCents: number, reason?: string): Promise<RefundResult>;
119
+ closeTrade(outTradeNo: string): Promise<PaymentResult>;
120
+ queryRefund(outTradeNo: string, refundNo: string): Promise<RefundResult>;
121
+ bindSplitReceiver(receiverType: string, account: string, name?: string, relationType?: string): Promise<SplitResult>;
122
+ split(outTradeNo: string, splitNo: string, receivers: SplitReceiver[], reason?: string, transactionId?: string): Promise<SplitResult>;
123
+ querySplit(outTradeNo: string, splitNo: string, _transactionId?: string): Promise<SplitResult>;
124
+ returnSplit(outTradeNo: string, splitNo: string, returnNo: string, amountCents: number, receiverType: string, receiverAccount: string, reason?: string, _transactionId?: string): Promise<SplitResult>;
125
+ finishSplit(outTradeNo: string, splitNo: string, _transactionId?: string, _reason?: string): Promise<SplitResult>;
53
126
  verifyCallback(_headers: Record<string, string>, body: Buffer): Promise<CallbackResult>;
54
127
  }
55
128
  export declare class UnionPayProvider extends PaymentProvider {
56
129
  provider_name: string;
130
+ supportsSplit: boolean;
131
+ supportsClose: boolean;
57
132
  static TEST_GATEWAY: string;
58
133
  static PROD_GATEWAY: string;
59
134
  private merId;
@@ -69,11 +144,13 @@ export declare class UnionPayProvider extends PaymentProvider {
69
144
  createAppTrade(outTradeNo: string, amountCents: number, _subject: string, notifyUrl: string): Promise<PaymentResult>;
70
145
  createTradeByPlatform(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string, platform?: string): Promise<PaymentResult>;
71
146
  queryTrade(outTradeNo: string): Promise<PaymentResult>;
147
+ refund(outTradeNo: string, refundNo: string, amountCents: number, _totalCents: number, _reason?: string): Promise<RefundResult>;
72
148
  verifyCallback(_headers: Record<string, string>, body: Buffer): Promise<CallbackResult>;
73
149
  successResponse(): string;
74
150
  }
75
151
  export declare class WeChatPayProvider extends PaymentProvider {
76
152
  provider_name: string;
153
+ supportsSplit: boolean;
77
154
  static BASE_URL: string;
78
155
  private appid;
79
156
  private miniAppId;
@@ -114,9 +191,25 @@ export declare class WeChatPayProvider extends PaymentProvider {
114
191
  */
115
192
  createTradeByPlatform(outTradeNo: string, amountCents: number, subject: string, notifyUrl: string, platform?: string, openid?: string, _buyerId?: string, payerIp?: string): Promise<PaymentResult>;
116
193
  queryTrade(outTradeNo: string): Promise<PaymentResult>;
194
+ refund(outTradeNo: string, refundNo: string, amountCents: number, totalCents: number, reason?: string): Promise<RefundResult>;
195
+ closeTrade(outTradeNo: string): Promise<PaymentResult>;
196
+ private v3Get;
197
+ queryRefund(outTradeNo: string, refundNo: string): Promise<RefundResult>;
198
+ bindSplitReceiver(receiverType: string, account: string, name?: string, relationType?: string): Promise<SplitResult>;
199
+ private mapWechatReceivers;
200
+ split(outTradeNo: string, splitNo: string, receivers: SplitReceiver[], reason?: string, transactionId?: string): Promise<SplitResult>;
201
+ querySplit(outTradeNo: string, splitNo: string, transactionId?: string): Promise<SplitResult>;
202
+ returnSplit(outTradeNo: string, splitNo: string, returnNo: string, amountCents: number, receiverType: string, receiverAccount: string, reason?: string, transactionId?: string): Promise<SplitResult>;
203
+ finishSplit(outTradeNo: string, splitNo: string, transactionId?: string, reason?: string): Promise<SplitResult>;
117
204
  verifyCallback(_headers: Record<string, string>, body: Buffer): Promise<CallbackResult>;
118
205
  successResponse(): string;
119
206
  }
207
+ export type PaymentProviderFactory = (config: Record<string, string>) => PaymentProvider;
208
+ /** 注册/覆盖支付渠道;注册后通用回调 /payment/notify/{name} 自动生效 */
209
+ export declare function registerPaymentProvider(name: string, factory: PaymentProviderFactory): void;
210
+ export declare function unregisterPaymentProvider(name: string): void;
211
+ export declare function listPaymentProviders(): string[];
120
212
  export declare function createPaymentProvider(providerName: string, config: Record<string, string>): PaymentProvider;
213
+ export declare function getProviderCapabilities(providerName: string, config: Record<string, string>): Record<string, unknown>;
121
214
  export declare function getPaymentSettings(): Promise<Record<string, string>>;
122
215
  export declare function getActiveProvider(config: Record<string, string>): string;