Dougong
Channel Overview
Dougong (斗拱) is Huifu's aggregated payment product. DaxPay integrates Huifu's V2 Trade API in ISV mode (product dougong_pay); it shares the huifu channel with Huifu Adapay, distinguished by payment product.
Dougong is a commercial-edition extended channel; after purchasing the flagship edition the official team assists with onboarding and integration. See the channel overview.
Supported Payment Methods
| Underlying rail | Supported methods |
|---|---|
| QR code, JSAPI (Official Account), mini-program | |
| Alipay | QR code, JSAPI |
| UnionPay (QuickPass) | QR code |
WeChat JSAPI and mini-program payments require a bound WeChat app (AppId) in the channel configuration. Barcode, APP, and H5 methods are not available on Dougong.
Configuration Structure
Dougong keys are a product-level global configuration; the channel merchant only registers the Huifu merchant number:
- Configure the ISV keys (Dougong product → Key Configuration, one global set):
| Group | Field | Notes |
|---|---|---|
| ISV identity | Service-provider system ID | sysId assigned by Huifu |
| Product number | Dougong product identifier | |
| Keys | Dougong public key | PEM format, for verification |
| Merchant private key | PEM format (PKCS#8), for signing |
- Create the channel merchant: Merchant Workbench → Channel Merchants → Create, pick the Dougong product and fill in merchant name + Huifu merchant number (huifuId, obtained after onboarding; required on every trade).
Signature & Callback
- Request signing: RSA (handled inside the Huifu SDK) — merchant private key signs, Dougong public key verifies;
- Async notifications are verified by the platform; the callback URL must be configured in the Huifu merchant portal.
Notes
- Dougong and Adapay share the Huifu channel with a common merchant-number system, but keys and products are independent — do not mix them;
- Ensure the server egress IP is whitelisted by Huifu.