沙箱不需要審核。註冊後在「開發者 → API 密鑰」簽發 kuko_test_ 密鑰即可開始聯調,先把接入跑通再走審核,是推薦的順序。
正式收款需要通過資質審核。提交資質前需要先驗證登錄郵箱:註冊後會收到一封帶驗證鏈接的歡迎郵件,沒收到可以在後台頂部的提示條裏重新發送。審核結果、拒付、提現等通知都會發到這個郵箱。
主體類型
按你用來通過審核的證件選擇主體類型。類型決定要準備哪些材料,不代表業務是否跨境:境內公司做出海生意,選「企業法人」。
| 類型 | 適用 | 核驗依據 |
|---|---|---|
| 企業法人 | 在中國大陸註冊的公司 | 營業執照與法定代表人證件 |
| 個體工商戶 | 持營業執照的個體經營者 | 營業執照與經營者證件 |
| 境外主體 | 在中國大陸以外註冊的公司 | 註冊證書與董事證件 |
| 個人 | 沒有營業執照的自然人 | 本人證件與手持證件照 |
需要準備的材料
企業法人、個體工商戶、境外主體
| 材料 | 説明 |
|---|---|
| 公司名稱與營業執照號 | 與執照完全一致 |
| 營業執照掃描件 | 清晰、在有效期內 |
| 法人姓名與證件號 | 與證件一致 |
| 法人證件正反面 | 清晰可辨 |
| 聯繫郵箱與電話 | 審核結果與風控通知會發到這裏 |
| 經營網站地址 | 需可正常訪問,且經營內容與申請類目一致 |
| 經營類目 | 決定適用費率與風控策略 |
| 預計月流水 | 用於額度評估 |
| 結算銀行賬戶 | 提現到賬賬戶,需與公司主體一致 |
個人
個人須年滿 18 週歲。
| 材料 | 説明 |
|---|---|
| 真實姓名 | 與證件上的姓名完全一致 |
| 證件類型與號碼 | 中國居民身份證、護照、港澳居民來往內地通行證或台灣居民來往大陸通行證 |
| 證件有效期 | 須在有效期內;只有居民身份證可以選擇「長期」 |
| 國籍/地區 | 使用居民身份證時固定為中國 |
| 證件照片 | 人像面;護照以外的證件還需要背面 |
| 手持證件照 | 本人手持證件正面,面部與證件信息都清晰可見 |
| 經營內容説明 | 賣什麼、賣給誰、怎麼交付,10 到 500 字 |
| 聯繫郵箱與經營網站 | 與企業相同 |
提交時需要單獨同意平台處理你的身份證件等敏感個人信息。證件號碼加密存儲,後台和接口只顯示脱敏後的號碼;平台審核人員查看完整號碼時必須説明原因,每次查看都有記錄。賬戶註銷後,身份資料按反洗錢要求保存 5 年後刪除。
同一證件只能開通一個個人商戶。
與企業相比,個人商戶還有以下限制:
- 不能選擇的類目:數字商品 / 虛擬內容、網絡遊戲。
- 支付方式:審核通過時默認只開通銀行卡。
- 提現:只能提現到本人名下的個人(對私)賬戶,開戶人姓名須與實名一致。綁卡和每次提現時都會校驗。
- 收款限額:見下文。
證件到期與更新
個人商戶的身份以證件為準,證件過期後需要更新:
- 到期前 30 天:郵件提醒,商戶入駐頁會顯示剩餘天數。
- 過期後:正式環境提現自動暫停,收款、退款和拒付應訴不受影響。
- 更新方式:在商戶入駐頁點擊「更新證件」,填寫新證件的有效期,上傳證件照片和手持證件照,提交後由平台人工審核。審核通過後證件信息更新;如果提現是因證件過期而暫停的,會自動恢復。
- 證件換發、號碼有變化時(例如新護照),在「更新證件」裏勾選「證件已換發,號碼有變化」,填寫新證件的類型、號碼和國籍/地區。新證件必須是本人的:姓名要與登記的一致,平台會人工核對;這個證件也不能已被其他個人商戶使用。審核通過後,新證件替換登記的證件。
- 姓名發生變化時,請聯繫平台處理。
收款限額
個人商戶的正式環境收款默認受以下限額約束,單位為各幣種的最小貨幣單位:
| 幣種 | 單筆上限 | 近 24 小時 | 近 30 天 |
|---|---|---|---|
| USD | 100,000($1,000) | 500,000($5,000) | 3,000,000($30,000) |
| HKD | 800,000(HK$8,000) | 4,000,000(HK$40,000) | 24,000,000(HK$240,000) |
| CNY | 700,000(¥7,000) | 3,500,000(¥35,000) | 20,000,000(¥200,000) |
- 統計口徑是滾動窗口,不按自然日或自然月:近 24 小時、近 30 天內創建的正式訂單中,已支付的(含之後退款的)和收銀台鏈接仍然有效的待支付訂單都會計入。已過期或已關閉的訂單不計入。
- 買家還沒有開始付款的待支付訂單,只在創建後 15 分鐘內佔用額度。這樣收款鏈接被反覆打開時,生成的空訂單不會把當天的額度佔滿。
- 超過任一限額的下單請求返回
400 payment_limit_exceeded,訂單不會創建。收款鏈接超出限額時,買家會看到「商家暫時無法收款」。 - 買家在收銀台開始付款時會再核對一次限額:如果這期間額度已經被其他訂單用完,收銀台會提示「商家暫時無法收取這筆款項」,不會扣款。
- 沙箱不受限額約束。
- 審核通過後可以在商戶入駐頁面查看自己的限額,以及近 24 小時、近 30 天已佔用的額度。需要提高請聯繫平台;個人商戶的限額可以提高,但不能取消。
- 正式環境創建收款鏈接時,金額超過單筆上限會直接返回
400 payment_limit_exceeded,不會生成一條買家付不了款的鏈接。 - 其他主體類型默認不設限額,平台也可以根據風控需要為其設置。
可接受使用政策
所有商戶都不得通過平台收取以下業務的款項:博彩與彩票、加密貨幣及虛擬資產交易、成人內容、藥品與醫療器械、武器彈藥、煙草與電子煙、金融投資與借貸、匯款及代收付、侵權假冒商品,以及任何違法或欺詐業務。提交資質時需要確認同意這項政策,違反者資金將被凍結並終止服務。
審核狀態
| 狀態 | 含義 |
|---|---|
pending | 已提交,等待審核 |
approved | 已通過,可以申請正式密鑰 |
rejected | 未通過,audit_reason 給出原因,修正後可重新提交 |
審核通過或駁回時,賬戶所有者、管理員和入駐聯繫郵箱都會收到郵件,駁回郵件附帶原因。
審核期間(pending)和被駁回後(rejected)都可以在後台修改資料並重新提交。審核通過(approved)後資料就鎖定了,後台不再提供修改入口,接口也會拒絕;如需變更主體信息,請聯繫平台運營處理。
資質申請只能由賬戶所有者提交,其他成員只能查看審核狀態,參見 團隊與角色。
審核通過前,用正式密鑰調用任何接口都會返回 403 merchant_not_approved。
這個限制是有意的:它讓測試環境的代碼在結構上不可能觸發真實扣款,而不是靠開發者自覺。
收款幣種
目前支持 USD、HKD 和 CNY。
- 沙箱:三種幣種都可以直接下單,用來在開通前測試。
- 正式環境:只能用平台在審核時為你開通的幣種創建訂單和收款鏈接。需要增加幣種時請聯繫平台。
每個幣種是一個獨立的錢包:訂單收到哪個幣種,就記入哪個幣種的餘額,提現也從對應幣種的餘額中發起,平台不做自動換匯。控制台的訂單、退款、拒付、錢包和提現頁面都可以按幣種切換查看。
支付方式
平台支持銀行卡、支付寶、微信支付、Apple Pay、Google Pay 和 PayPal。
- 沙箱:收銀台提供全部支付方式(你自行關閉的除外),無需申請。
- 正式環境:審核通過時平台會為你開通一組基礎支付方式並確定費率,收銀台只向買家展示已開通、且你沒有關閉的方式。
控制收銀台展示哪些方式
已開通的方式旁邊有一個開關,關閉後收銀台不再向買家展示它,隨時可以重新打開,無需平台審核。開關同時作用於沙箱和正式收銀台,方便你在沙箱預覽買家看到的效果。幾點説明:
- 收銀台至少要保留一種支付方式,最後一個展示中的方式不能關閉。
- 只影響此後新建的支付;買家已經打開的收銀台保持原有的方式。
- 關閉不影響費率和開通狀態,重新打開即可恢復。開關可由賬戶所有者或管理員操作。
申請開通更多方式
需要更多支付方式時,在控制台 設置 → 支付方式 中對未開通的方式點擊「申請開通」,説明業務場景後提交。每個方式單獨申請、單獨審核:
| 狀態 | 含義 |
|---|---|
| 已開通 | 可在正式收銀台使用,頁面顯示該方式的簽約結算費率和展示開關 |
| 審核中 | 已提交,等待平台複核;審核前可以撤回 |
| 未通過 | 頁面顯示駁回原因,補充説明後可以重新申請 |
| 未開通 | 尚未申請 |
未開通的方式顯示平台的基準費率,僅供參考。平台複核通過時會確定該方式的實際費率(可能與基準費率不同),從下一筆支付起生效。結果會通過郵件通知賬戶所有者、管理員和入駐聯繫郵箱。申請和撤回只能由賬戶所有者操作。
Apple Pay 和 Google Pay 經卡組織清算,與銀行卡共用同一檔費率;支付寶和微信支付共用一檔。開通其中一種時確定的費率適用於同檔的所有方式。
上線檢查清單
審核通過後,正式上線前請逐項確認:
申請正式密鑰
在正式環境的「開發者 → API 密鑰」為應用簽發 kuko_live_ 密鑰。切換環境只需要換密鑰,接口地址和請求參數完全不變。
配置 notify_url
正式訂單的 notify_url 必須是可公網訪問的 HTTPS 地址。平台會在下單時校驗,內網地址和 HTTP 會被拒絕。
配置 Webhook 端點並訂閲失敗事件
至少訂閲 payment.succeeded、payment.failed、refund.succeeded、dispute.created。只訂閲成功事件會讓你發現不了死單和拒付。見 Webhook。
核對驗簽代碼
確認你的驗簽實現能處理多個 v1=,否則密鑰輪換期間會全部驗簽失敗。
接上對賬
用 資金流水 做每日對賬,不要只依賴 Webhook。
配置 IP 白名單(可選)
如果你的服務端出口 IP 固定,在「開發者 → API 密鑰」頁面填上 IP 白名單能顯著降低密鑰泄漏後的風險。