7Pay 聚合支付接入指南

{
  "code": 1,
  "msg": "成功",
  "trade_no": "202601011234567890",
  "qrcode": "https://xxx.cn/pay/wxpay/xxx/",
  "img": "https://zpayz.cn/qrcode/123.jpg",
  "payurl": "https://xxx.cn/pay/wxpay/xxx/"
}

// React 示例
function PaymentQRCode({ imgUrl }: { imgUrl: string }) {
  return (
    <div className="payment-qrcode">
      <img src={imgUrl} alt="扫码支付" />
      <p>请使用支付宝/微信扫码支付</p>
    </div>
  );
}

async function pollPaymentStatus(
  orderId: string,
  maxAttempts = 60,
  interval = 3000
): Promise<boolean> {
  for (let i = 0; i < maxAttempts; i++) {
    const res = await fetch(
      `https://zpayz.cn/api.php?act=order&pid=${PID}&key=${KEY}&out_trade_no=${orderId}`
    );
    const data = await res.json();

    if (data.code === 1 && data.status === 1) {
      return true; // 支付成功
    }

    await new Promise(r => setTimeout(r, interval));
  }
  return false; // 超时
}

// 伪代码示例
async function handlePaymentNotify(params: Record<string, string>) {
  // 1. 验证签名
  if (!verifySign(params)) {
    return 'fail';
  }

  // 2. 检查订单状态
  if (params.trade_status !== 'TRADE_SUCCESS') {
    return 'fail';
  }

  // 3. 验证金额（重要！防止金额篡改）
  const order = await getOrderFromDB(params.out_trade_no);
  if (order.money !== params.money) {
    return 'fail';
  }

  // 4. 处理业务逻辑（注意幂等性）
  if (order.status !== 'paid') {
    await updateOrderStatus(params.out_trade_no, 'paid');
    // 其他业务逻辑...
  }

  // 5. 返回 success 告知平台已收到
  return 'success';
}

import { createHash } from 'crypto';

function generateSign(params: Record<string, string>, key: string): string {
  // 过滤并排序
  const sorted = Object.keys(params)
    .filter(k => k !== 'sign' && k !== 'sign_type' && params[k] !== '')
    .sort()
    .map(k => `${k}=${params[k]}`)
    .join('&');

  // 拼接密钥并 MD5
  return createHash('md5')
    .update(sorted + key)
    .digest('hex');
}

function verifySign(params: Record<string, string>, key: string): boolean {
  const sign = params.sign;
  const calculated = generateSign(params, key);
  return sign === calculated;
}

{
  "code": 1,
  "msg": "退款成功"
}

1. 用户下单 → 前端调用后端创建订单接口
2. 后端调用 mapi.php → 获取 qrcode/img
3. 前端展示二维码 → 开始轮询订单状态
4. 用户扫码支付 → 平台回调 notify_url
5. 后端验签处理 → 返回 success
6. 前端轮询发现已支付 → 跳转成功页