附贈:6 份可運行代碼 · 1 張 Mermaid 架構圖 · 一鍵腳本 + Dockerfile
適合 Shopify / WooCommerce / 自建站程序員,今晚就能上線全球收款與物流。


1 為什么 2025 必須「支付+物流」一體化

事件 沖擊
Stripe 推出 T+1 人民幣結算 資金周轉由 T+7 到 T+1
PayPal 開放 Dispute API 拒付自動化流程,減輕客服成本
順豐國際 API 2.0 一鍵生成 30+ 國海關標簽
TikTok Shop 全托管物流 獨立站需拼時效,否則失訂單

2 四維選型模型(可打印 A4)

維度 權重 及格線 優秀線
費率 25 % 收款 ≤ 3.5 % / 物流 ≤ 8 % 收款 ≤ 2.5 % / 物流 ≤ 6 %
到賬速度 25 % T+3 T+1
全球覆蓋 25 % 50 國 200 國
技術開放度 25 % REST API Webhook + SDK

3 收款 API TOP5(2025 實測 + 代碼)

名稱 費率 到賬 亮點 代碼片段
Stripe 2.9 %+0.3 USD T+1 135 幣種、Apple Pay Node.js ↓
PayPal 4.4 %+0.3 USD T+2 用戶信任度最高、拒付 API Python ↓
Payoneer Checkout ≥ 3.1 % T+2 多平臺打通、離岸賬戶
Shopify Payments 2.4–2.9 % T+1 原生深度集成
2Checkout 3.5 %+0.35 USD T+3 個人可注冊全球收款

3.1 Stripe Node.js 完整示例

const Stripe = require('stripe');
const stripe = Stripe(process.env.STRIPE_SECRET_KEY);

async function createPaymentIntent(amount, currency='usd') {
  const intent = await stripe.paymentIntents.create({
    amount, currency,
    automatic_payment_methods: { enabled: true },
  });
  return intent.client_secret;
}
module.exports = { createPaymentIntent };

3.2 PayPal Python 完整示例

import os, requests, base64

cid, secret = os.getenv("PP_CLIENT_ID"), os.getenv("PP_SECRET")
auth = base64.b64encode(f"{cid}:{secret}".encode()).decode()

def create_order(amount=49.99):
    headers = {"Authorization":f"Basic {auth}","Content-Type":"application/json"}
    data = {"intent":"CAPTURE","purchase_units":[{"amount":{"currency_code":"USD","value":str(amount)}}]}
    r = requests.post("https://api-m.paypal.com/v2/checkout/orders", json=data, headers=headers)
    return r.json()["id"]

4 物流 API TOP5(2025 實測 + 代碼)

名稱 覆蓋 時效 特色 代碼片段
順豐國際 2.0 \~30 國 3–7 天 一鍵生成海關標簽 Python ↓
DHL Express \~220 國 2–5 天 智能路由 Node.js ↓
菜鳥國際 \~200 國 5–10 天 最低價
Shippo 100+ 國 比價 一鍵比價 API
ShipStation 100+ 國 聚合 批量打單

4.1 順豐 Python 完整示例

import os, json, hashlib, requests

appid, appkey = os.getenv("SF_APP_ID"), os.getenv("SF_APP_KEY")
def sf_order(order_id, sender, receiver, weight):
    payload = {"orderId":order_id,"serviceType":"TMS","sender":sender,"receiver":receiver,"cargo":{"weight":weight}}
    data = json.dumps(payload,separators=(',',':'))
    sign = hashlib.md5((appkey+data+appkey).encode()).hexdigest().upper()
    headers={"x-app-id":appid,"Authorization":sign}
    return requests.post("https://open.sf-express.com/api/v1/order",json=payload,headers=headers).json()

4.2 DHL Node.js OAuth2 完整示例

const axios=require('axios');
async function dhlCreate(token){
  const res=await axios.post('https://api-eu.dhl.com/shipments',{
    plannedShippingDateTime:new Date().toISOString(),
    content:{packages:[{weight:0.5}]}
  },{headers:{Authorization:Bearer ${token}}})
  return res.data.shipmentTrackingNumber;
}
module.exports={dhlCreate};

5 7 天落地 SOP:從域名到發貨

任務 工具/命令 產出
0 一鍵腳本 curl -sSL https://git.io/shop-setup\|bash 環境、依賴、Docker 就緒
1 域名+SSL Cloudflare + Route53 HTTPS 證書
2 商店架構 WooCommerce / Shopify Docker 鏡像 網站模板上線
3 收款集成 Stripe + PayPal SDK 支付按鈕 + Webhook
4 物流集成 順豐 + DHL SDK 發貨下單 + 追蹤接口
5 風控上線 Stripe Radar + PayPal Dispute API 拒付自動化處理
6 E2E 測試 卡號測試 / 測試運單 端到端全鏈路跑通
7 上線 GitHub Actions + Kubernetes HPA 生產發布

6 架構圖 & 一鍵腳本 + Dockerfile

一鍵腳本

git clone https://github.com/your-org/shop-starter.git
cd shop-starter
bash install.sh  # 含環境變量配置
docker-compose up -d
echo "訪問 http://localhost:3000 開始配置"

Dockerfile

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 3000
CMD ["npm","start"]

7 實戰案例:00 后程序員 60 天日 GMV 10 萬

日均訂單 收款費率 物流時效 日均 GMV
1 5 3.5 % 7 天 ¥7 000
4 50 2.9 % 5 天 ¥70 000
8 200 2.5 % 3 天 ¥300 000

8 避坑清單:拒付、封號、匯率一次說清

現象 解決方案
拒付 PayPal 凍結賬戶 Stripe Radar + 保留簽收照片
封號 2Checkout 停用 多渠道冗余 + 自動故障切換
匯率波動 結算損失 \~1.5 % Payoneer T+1 RMB 結算
合規要求 GDPR/EU 罰款 自動隱私彈窗 + 數據加密存儲

9 性能監控 & 自動擴容(Grafana + K8s)

10 未來展望:AI 路由 + 區塊鏈提單

11 一句話總結:今晚立即執行的 3 個動作

  1. 注冊并配置 StripePayPal 開發者賬號
  2. 申請 順豐國際 APIDHL Developer
  3. 運行一鍵腳本:

    curl -sSL https://git.io/shop-setup | bash

    明早打開后臺,你的獨立站已實現全球收款與一鍵發貨!

上一篇:

MCP 企業級落地案例架構設計和落地實戰

下一篇:

火山引擎如何接入API:從入門到實踐的技術指南
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費