Douyin Pay
Updated: 10/16/26, 9:52:44 AM
Channel Overview
Douyin Pay is ByteDance's payment service on Douyin. DaxPay integrates in direct mode (product douyin_pay), covering Douyin mini-program and APP scenarios, with wallet transfers and profit sharing supported.
Supported Payment Methods
| Method | Description | Prerequisite |
|---|---|---|
douyin_mini (mini-program) | Payment inside a Douyin mini-program | Requires openId; register a mini-program app |
douyin_app (APP) | Invokes Douyin Pay from the merchant app | — |
douyin_h5 (H5) | Cashier pulled up in a Douyin H5 page | — |
douyin_qr (QR code) | Returns a QR code scanned inside Douyin | — |
Configuration Structure
Keys are configured per channel merchant; app information is maintained separately:
- Create the channel merchant: Merchant Workbench → Channel Merchants → Create, pick the product and fill in merchant name + Douyin merchant ID (MCHID);
- Configure keys (Channel Merchant Detail → Key Configuration):
| Field | Notes |
|---|---|
| Merchant private key | Generated on the Douyin open platform; signs requests |
| Merchant public key certificate serial number | Matches the certificate uploaded to Douyin |
| API encryption key | AES-decrypts callback payloads; from the Douyin "encryption & signing" page |
- Register Douyin apps (the "Douyin Apps" page, platform apps / merchant apps): app name, app type (mini-program / mobile app / web app), AppId, and Client Secret; bind apps to payment capabilities.
Callback Handling
- Async notifications are encrypted payloads; the platform decrypts with the API encryption key and answers
{"code":"SUCCESS"}; - Callback URLs are generated by the platform; no per-app configuration in the Douyin console.
Notes
- Switch the environment before creating merchants: one set per environment;
- Only scenarios inside the Douyin ecosystem are supported;
- Mini-program payments require a registered Douyin mini-program and the buyer's openId;
- Transfer scenarios require a web app type app;
- Ensure the callback URL is publicly reachable.
Docs for AI Assistants
LLM-friendly document formats for ChatGPT, Claude, Cursor and other AI tools to read and understand DaxPay docs.
llms.txt — Site index, page list with summaries for quick lookup
llms-full.txt — Full docs merged, complete content in one file for bulk AI input
llms-full.txt — Full docs merged, complete content in one file for bulk AI input