支付宝电脑网站支付

Feature: ali-pay-web

支付宝电脑网站支付，商户在电脑网页展示商品或服务，用户确认后跳转支付宝收银台完成付款。纯 Rust 实现，RSA2 签名。

📖 官方文档：https://opendocs.alipay.com/open/270/105899

配置

[ali_pay]
app_id = "2014072300007148"              # 支付宝应用 ID
private_key = """
-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----
"""                                        # 应用私钥 (PKCS#8 PEM 格式)
alipay_public_key = """
-----BEGIN PUBLIC KEY-----
...
-----END PUBLIC KEY-----
"""                                        # 支付宝公钥 (用于验签)
notify_url = "https://example.com/ali/pay/notify"  # 异步通知回调 URL
# return_url = "https://example.com/ali/pay/return" # 同步跳转 URL (可选)
# gateway = "https://openapi.alipay.com/gateway.do" # API 网关 (默认值)
# callback_path = "ali/pay/notify"                   # 回调路由路径 (默认值)

API

AliPay

PagePayRequest

#![allow(unused)]
fn main() {
pub struct PagePayRequest {
    pub out_trade_no: String,          // 商户订单号 (64 字符以内)
    pub total_amount: String,          // 订单总金额 (元，精确到小数点后两位)
    pub subject: String,               // 订单标题
    pub product_code: Option<String>,  // 产品码，默认 FAST_INSTANT_TRADE_PAY
    pub qr_pay_mode: Option<String>,   // 扫码方式: 0/1/2/3/4
    pub qrcode_width: Option<u64>,     // 二维码宽度 (qr_pay_mode=4)
    pub time_expire: Option<String>,   // 绝对超时时间 yyyy-MM-dd HH:mm:ss
    pub integration_type: Option<String>, // PCWEB / ALIAPP
}
}

TradeQueryData

交易状态

使用示例

use afaster::AFaster;
use afaster::ali_pay::{AliPay, PagePayRequest};

#[tokio::main]
async fn main() {
    AFaster::new("config.toml".to_string()).await
        .unwrap()
        .with_ali_pay(|a| {
            a.with_pay_success_callback(|(state, notify)| {
                async move {
                    println!("支付宝支付成功: {} - {}", notify.out_trade_no, notify.total_amount);
                    Ok(afaster::ali_pay::AliPayNotifyResult::success())
                }
            })
        })
        .run()
        .await;
}

生成支付页面

#![allow(unused)]
fn main() {
let html = state.ali_pay.page_pay(&PagePayRequest {
    out_trade_no: "ORDER_20240101_001".to_string(),
    total_amount: "88.88".to_string(),
    subject: "测试商品".to_string(),
    product_code: Some("FAST_INSTANT_TRADE_PAY".to_string()),
    qr_pay_mode: None,
    qrcode_width: None,
    time_expire: None,
    integration_type: None,
})?;
// 返回 HTML 表单，浏览器渲染后自动跳转到支付宝收银台
}

查询交易

#![allow(unused)]
fn main() {
let result = state.ali_pay.query_trade(Some("ORDER_20240101_001"), None).await?;
if result.code == "10000" {
    if let Some(data) = &result.data {
        println!("交易状态: {:?}", data.trade_status);
    }
}
}

退款

#![allow(unused)]
fn main() {
let result = state.ali_pay.refund(
    "10.00",
    Some("ORDER_20240101_001"),
    None,
    Some("用户申请退款"),
    Some("REFUND_001"),
).await?;
}

回调系统

开启 ali-pay-web feature 后，回调路由自动注册为 POST 端点，无需手动注册 handler。 路由路径由配置中的 callback_path 决定，默认 ali/pay/notify。

注册回调

#![allow(unused)]
fn main() {
AFaster::new("config.toml".to_string()).await
    .unwrap()
    .with_ali_pay(|a| {
        a.with_pay_success_callback(|(state, notify)| {
            async move {
                // notify: AliPayTradeNotify
                // 处理支付成功逻辑
                Ok(afaster::ali_pay::AliPayNotifyResult::success())
            }
        })
        .with_refund_callback(|(state, notify)| {
            async move {
                // notify: AliPayRefundNotify
                // 处理退款通知
                Ok(afaster::ali_pay::AliPayNotifyResult::success())
            }
        })
    })
    .run()
    .await;
}

注意：未注册的回调会被静默丢弃并返回 success（避免支付宝重试），开启 log feature 会打印 debug 日志。

错误码

参考文档

• 电脑网站支付产品介绍
• 统一收单下单并支付页面接口
• 统一收单交易查询
• 统一收单交易关闭
• 统一收单交易退款
• 退款查询
• 账单下载