#快速开始

顽兔支付是面向商户的收单服务。商户系统调用顽兔网关完成收款，支付宝、银商等渠道的 协议、签名、证书都由网关处理。资金不经过顽兔，用户付款后直接结算到商户自己的收款账户。

接入只有三件事：调接口下单、接收支付回调、幂等入账。默认走支付宝；开通银商渠道后， 下单多传一个 channel 参数就能出「微信/支付宝/云闪付一码通扫」的聚合码，微信内打开 的 H5 页面则用公众号支付（整页跳转唤起微信支付，无需自有公众号），均见发起支付。

#开通

1. 联系顽兔商务签约。需要企业支付宝账号，网站已完成 ICP 备案，开通支付宝 「电脑网站支付」产品（顽兔协助办理）
2. 在支付宝商家平台对顽兔完成授权。顽兔运营提供授权链接，一次性操作
3. 拿到接入凭据：

#安装与初始化

curl -O https://docs.wantutech.com/downloads/wantu-merchant-sdk-0.1.0.tgz
npm install ./wantu-merchant-sdk-0.1.0.tgz

import { createWantuPayClient } from 'wantu-merchant-sdk'

export const pay = createWantuPayClient({
  baseUrl: process.env.WANTU_PAY_BASE_URL!,
  merchantId: process.env.WANTU_MERCHANT_ID!,
  apiSecret: process.env.WANTU_API_SECRET!,
})

import os
from wantu_pay import WantuPayClient

pay = WantuPayClient(
    base_url=os.environ["WANTU_PAY_BASE_URL"],
    merchant_id=os.environ["WANTU_MERCHANT_ID"],
    api_secret=os.environ["WANTU_API_SECRET"],
)

#第一笔支付

const { orderId, payUrl } = await pay.orders.create({
  outTradeNo: 'R202608180001',   // 商户订单号，自己生成，保证唯一
  amount: '0.01',
  subject: '测试订单',
  payMode: 'qrcode',
})
// 把 payUrl 嵌入页面 iframe，用户扫码支付

order = pay.create_order(
    out_trade_no="R202608180001",   # 商户订单号，自己生成，保证唯一
    amount="0.01",
    subject="测试订单",
    pay_mode="qrcode",
)
# 把 order["pay_url"] 嵌入页面 iframe，用户扫码支付

支付结果通过回调送达，页面跳转不能作为入账依据。

#下一步

按你的技术栈选一条完整教程走完即可接入，其余页面作为字典备查：

• Node.js 接入：Express 从零到收款五步
• Python 接入：FastAPI 从零到收款五步

备查：发起支付（支付页形态与完整参数）、支付回调（入账的 正确写法）、联调与上线、常见问题排查