在移动应用开发中，支付模块几乎是所有电商、会员、虚拟商品类产品的核心环节。支付宝和微信支付合计覆盖了国内移动支付市场九成以上的份额，因此大多数APP需要同时支持这两种支付方式。虽然两者都提供官方SDK和统一下单接口，但在参数格式、签名算法和客户端调用方式上并不完全一致。下面从服务端和客户端两个维度展开，详细说明APP端接入支付宝支付与微信支付的关键步骤。
一、接入前的账号与配置准备
支付宝开放平台和微信支付商户平台是两个独立的体系。接入前需要分别完成企业认证、申请支付产品、获取应用标识和密钥。支付宝侧需要在开放平台创建应用，添加APP支付功能，并配置RSA2公钥或证书。微信侧需要在商户平台申请APP支付权限，拿到商户号、API密钥，并且设置APIv3密钥或证书。两边都需要填写Android包名和iOS Bundle ID，这些信息会作为客户端唤起支付的校验依据。
配置阶段有一个容易混淆的地方是支付宝的应用公钥和支付宝公钥。简单来说，应用公钥是上传给支付宝的，支付宝公钥是支付宝返回给开发者用于验签的，两者的存储位置和用途不同。微信支付则要注意APIv2和APIv3的差异，新版建议使用APIv3，涉及平台证书和敏感信息加密。无论选择哪一套，都建议在服务端统一维护密钥，客户端只负责接收服务端返回的订单参数并拉起支付，避免在APP内硬编码敏感信息。
二、支付宝APP支付服务端与客户端流程
支付宝APP支付的典型流程是：客户端先请求自家服务端创建订单；服务端调用支付宝的 alipay.trade.app.pay 接口生成订单字符串；客户端拿到字符串后通过支付宝SDK唤起支付；用户支付完成后支付宝异步通知服务端，服务端验签后更新订单状态。这个过程中，订单字符串是核心，它由业务参数、公共参数和签名三部分组成。
服务端生成订单字符串的代码可以这样实现（以Java为例）：
// 构建请求参数
AlipayTradeAppPayRequest request = new AlipayTradeAppPayRequest();
AlipayTradeAppPayModel model = new AlipayTradeAppPayModel();
model.setOutTradeNo(orderNo);
model.setTotalAmount("0.01");
model.setSubject("测试商品");
model.setProductCode("QUICK_MSECURITY_PAY");
request.setBizModel(model);
request.setNotifyUrl("https://api.ipipp.com/pay/alipay/notify");
// 执行请求并获取订单字符串
AlipayTradeAppPayResponse response = alipayClient.sdkExecute(request);
String orderString = response.getBody();
上面的代码中，sdkExecute方法会返回一个形如 app_id=xxx&biz_content=xxx&charset=utf-8&...&sign=xxx 的字符串。客户端拿到这个字符串后，调用支付宝SDK的支付接口即可拉起收银台。需要注意的是，客户端不要自行拼接或修改订单字符串，否则会导致签名校验失败。在Android端通常使用 PayTask 的 payV2 方法，iOS端使用 AlipaySDK 的 payOrder 方法。
异步通知是支付成功的关键环节。支付宝会向开发者配置的 notify_url 发送POST请求，包含 trade_status、out_trade_no、total_amount 等字段。服务端必须验证 sign 字段，确认通知确实来自支付宝。验签使用支付宝公钥，而不是应用私钥。验证通过后再进行订单状态更新，并且要返回 success 字符串给支付宝，否则支付宝会重复通知。
三、微信APP支付服务端与客户端流程
微信APP支付的流程与支付宝类似，但参数格式和签名方式不同。微信支付采用XML格式（APIv2）或JSON格式（APIv3）组织参数，并且要求使用商户私钥或API密钥进行签名。服务端调用统一下单接口后，会得到 prepay_id，然后二次签名生成客户端需要的参数。客户端拿到参数后调用微信SDK的 sendReq 方法唤起微信。
以APIv2为例，服务端统一下单的主要参数包括 appid、mch_id、nonce_str、body、out_trade_no、total_fee、spbill_create_ip、notify_url、trade_type=APP。签名时将参数按照键名字典序排序，使用MD5或HMAC-SHA256生成sign，最后以XML格式发送请求。统一下单成功后，微信返回的XML中含有 prepay_id，客户端需要的参数则需要重新签名：
// 微信APP支付客户端参数生成（APIv2）
Map<String, String> params = new HashMap<>();
params.put("appid", appId);
params.put("partnerid", mchId);
params.put("prepayid", prepayId);
params.put("package", "Sign=WXPay");
params.put("noncestr", nonceStr);
params.put("timestamp", timestamp);
params.put("sign", generateSign(params, apiKey));
// 最终按字典序拼接后返回给APP
客户端在Android中会构造一个 PayReq 对象，设置 appId、partnerId、prepayId、packageValue、nonceStr、timeStamp 和 sign 字段，然后通过 WXAPIFactory.createWXAPI 获取的 IWXAPI 实例调用 sendReq 方法。iOS端使用 WXApiRequestHandler 或者直接的 WXApi sendReq。支付结果不会通过 sendReq 的返回值直接返回，而是通过微信的回调或者异步通知获取。服务端处理微信异步通知时，需要接收XML格式的消息，校验签名，并返回XML格式的应答。
微信支付有一个容易混淆的地方：package 参数的值是固定字符串 Sign=WXPay，而不是 prepay_id。很多开发者在二次签名时把package写成 prepay_id，导致唤起微信时报错。另一个细节是 timestamp 使用秒级时间戳，签名时也要把这个字符串加入排序，否则校验失败。
四、支付结果通知与订单状态一致性
无论是支付宝还是微信，都存在用户支付成功但客户端未能及时收到回调的情况。例如用户拉起支付后杀掉APP，或者网络波动导致异步通知延迟。因此服务端不能只依赖客户端的支付返回结果，必须把异步通知作为订单状态变更的唯一可信来源。客户端返回成功或者跳转回APP，只能作为触发查询订单接口的契机。
为了提升可靠性，可以在服务端设计一个主动查询机制。支付宝提供 alipay.trade.query 接口，微信提供订单查询接口。当异步通知超时未到达时，定时任务可以主动调用查询接口确认订单是否真的支付成功。查询结果与本地订单状态不一致时，以支付平台返回的状态为准，同时做好幂等处理，避免重复入账。
另外，两边的异步通知都可能重复发送。支付宝在收到 success 响应后停止重试，微信在收到成功应答后停止重试。服务端必须保证订单状态更新的幂等性，例如在数据库中使用唯一约束或者状态机判断，只有未支付状态才允许更新为已支付。否则重复通知会导致重复发货或重复添加权益。
五、常见错误与调试方法
接入过程中最常见的错误是签名失败。支付宝侧通常是因为应用私钥和支付宝公钥不匹配，或者参数编码不一致导致。调试时可以使用支付宝开放平台的签名工具核对签名是否正确。微信支付常见的错误是 total_fee 单位错误，微信金额单位是分，而支付宝单位是元，传错会导致支付金额异常。此外，Android的包名和iOS的Bundle ID必须与开放平台配置完全一致，否则唤起支付时会返回错误码。
另一个高频问题是客户端无法唤起支付。支付宝通常是因为订单字符串被截断或URL编码错误，微信则可能是APP未在微信开放平台通过审核、签名不匹配或者未安装微信。微信SDK要求手机上安装微信客户端，否则无法完成支付，而支付宝可以通过网页收银台兜底。调试时可以打印双方SDK返回的错误码，配合官方文档逐一排查。
建议在测试环境分别准备沙箱账号和测试商户号。支付宝提供沙箱环境，微信提供测试号或者小额真实支付。上线前务必完成全流程测试，包括取消支付、重复支付、异常回调、退款等场景。支付模块关系到资金安全和用户体验，充分测试比追求开发速度更重要。