alipay-rs

支付宝api文档: https://opendocs.alipay.com/apis/

签名方法为 RSA2，采用支付宝提供的 RSA签名&验签工具生成秘钥时，秘钥的格式必须为 PKCS1（现如今生成的秘钥可能不是PKCS1，需要先通过秘钥工具转换一下），秘钥长度推荐 2048。所以在支付宝管理后台请注意配置 RSA2(SHA256)密钥。

这是一个简单的alipay SDK，只需要创建client，然后通过client的post方法请求Alipay api即可。

Usage

```toml

[dependencies] alipay-rs = "0.4" alipay_params = "0.1"

```

example

以单笔转账接口为例：

```rust

...

// 接口参数 // 参数调用需要使用AlipayParams宏

[derive(AlipayParams, Debug)]

struct Transfer { outbizno: String, transamount: String, productcode: String, bizscene: String, payeeinfo: PayeeInfo, }

[derive(AlipayParams, Debug)]

struct PayeeInfo { identity: String, identity_type: String, name: String, }

async fn fundtransfer() { let transfer = Transfer { outbizno: format!("{}", Local::now().timestamp()), transamount: String::from("0.1"), productcode: String::from("TRANSACCOUNTNOPWD"), bizscene: String::from("DIRECTTRANSFER"), payeeinfo: PayeeInfo { identity: String::from("343938938@qq.com"), identitytype: String::from("ALIPAYLOGONID"), name: String::from("陈怀远"), }, }; let client = alipayrs::Client::builder() .appid("20210xxxxxxxxxxx") .publickey(includestr!("../公钥.txt")) .privatekey(includestr!("../私钥.txt")) .appcertsn(includestr!("../appCertPublicKey20210xxxxxxxxxxx.crt")) .alipayrootcertsn(includestr!("../alipayRootCert.crt")) .finish(); let data:serdejson::Value = client .post("alipay.fund.trans.uni.transfer", transfer) .await.unwrap().intojson().unwrap(); println!("{:?}", data); } ```

支付宝的所有接口都可以使用client.post函数访问，如果接口没有参数，可以使用client.noparampost函数。默认的公共参数包含：appid，charset，signtype，format，version，method，timestamp，sign，如果想修改或添加参数值，可以通过client.setpublicparams函数设置。

```rust

...

// 可以通过AlipayParams宏来定义需要添加或修改的公共参数

[derive(AlipayParams)]

struct PublicParams { appid: String, charset: String, signtype: String, version: String, }

...

let publicparams = PublicParams { appid: "20210xxxxxxxxxxx".toowned(), charset: "utf-8".toowned(), signtype: "RSA2".toowned(), version: "1.0".to_owned(), };

// 也可以通过vec, hashmap, array, tuple来设置公共参数 let publicparams = ("appid", "20210xxxxxxxxxxx"); let publicparams = [("imagetype", "png"), ("imagename", "test")]; let publicparams = vec![("imagetype", "png"), ("imagename", "test")]; let publicparams = HashMap::from([("imagetype", "png"), ("image_name", "test")]);

let mut clientwithparams = client.setpublicparams(public_params);

...

```

alipay api有图片视频等资源上传的接口，可以通过post_file接口进行资源上传

```rust

[derive(AlipayParams)]

struct Image { imagetype: String, imagename: String, } let file = std::fs::read("./test.png").unwrap(); let image = Image { imagetype: "png".toowned(), imagename: "test".toowned(), }; let client = ...; let mut clientwithparams = client.setpublicparams(image); // postfile参数： // method 接口名称 // key 文件参数名 // filename 文件名 // filecontent 文件内容 let data:serdejson::Value = clientwithparams.postfile("alipay.offline.material.image.upload", "imagecontent", "test.png", file.asref()).await.unwrap().intojson().unwrap(); println!("{:?}", data); ```

mutlithreading example

```rust

......

async fn refquery(client: &alipayrs::Client) { let query = QueryParam { operation: "ITEMPAGEQUERY".toowned(), pagenum: 1, pagesize: 10, itemidlist: None, };

let data:serde_json::Value = client
    .post("alipay.open.mini.item.page.query", query)
    .await.unwrap().into_json().unwrap();
println!("{:?}", data);

}

async fn reffundtransfer(client: &alipayrs::Client) { let transfer = Transfer { outbizno: format!("{}", Local::now().timestamp()), transamount: String::from("0.1"), productcode: String::from("TRANSACCOUNTNOPWD"), bizscene: String::from("DIRECTTRANSFER"), payeeinfo: PayeeInfo { identity: String::from("343938938@qq.com"), identitytype: String::from("ALIPAYLOGONID"), name: String::from("陈怀远"), }, }; let data:serdejson::Value = client .post("alipay.fund.trans.uni.transfer", transfer) .await.unwrap().intojson().unwrap(); println!("{:?}", data); }

......

let client = alipayrs::Client::builder() .appid("20210xxxxxxxxxxx") .publickey(includestr!("../公钥.txt")) .privatekey(includestr!("../私钥.txt")) .appcertsn(includestr!("../appCertPublicKey20210xxxxxxxxxxx.crt")) .alipayrootcertsn(includestr!("../alipayRootCert.crt")) .finish();

let cli = Arc::new(client); let cliclone = cli.clone(); tokio::spawn(async move { refquery(&cliclone).await; }).await.unwrap(); tokio::spawn(async move { reffund_transfer(&cli.clone()).await; }).await.unwrap(); ```

pc支付示例

pc端支付功能需要多做几步处理，比如qrpaymode等于0,1,3,4。需要以iframe方式请求，而iframe所需要的form表单代码需要自行实现。可以先通过generateurldata来获取对应参数，如下：

rust let data = cli .generate_url_data("alipay.trade.page.pay", params) .unwrap();

然后通过数据拼接成form表单代码，下面是lua代码的实现：

lua local pay_with_params = pay:set_public_params({ notify_url = 'https://domain_name/v1/alipay/receive_notify' }) local data = { ['out_trade_no'] = generate_order_no(), ['total_amount'] = params.total_amount, ['subject'] = 'test', ['product_code'] = 'FAST_INSTANT_TRADE_PAY', ['qr_pay_mode'] = 4, ['qrcode_width'] = 120, } local url_data = pay_with_params:generate_url_data('alipay.trade.page.pay', data) local html = '<form name=\'submit_form\' method=\'post\' action=\'https://openapi.alipay.com/gateway.do?charset=utf-8\'>\n' for k, v in pairs(url_data) do html = html .. '<input type=\'hidden\' name=\'' html = html .. k html = html .. '\' value=\'' html = html .. v html = html .. '\'>\n' end html = html .. '<input type=\'submit\' value=\'立即支付\' style=\'display:none\' >\n' html = html .. '</form>\n' html = html .. '<script>document.forms[0].submit();</script>'

生成form代码如下：

html <form name='submit_form' method='post' action='https://openapi.alipay.com/gateway.do?charset=utf-8'>\n<input type='hidden' name='timestamp' value='2022-12-22 05:34:57'>\n<input type='hidden' name='charset' value='utf-8'>\n<input type='hidden' name='format' value='json'>\n<input type='hidden' name='app_id' value='2021003172653113'>\n<input type='hidden' name='sign_type' value='RSA2'>\n<input type='hidden' name='version' value='1.0'>\n<input type='hidden' name='biz_content' value='{\"out_trade_no\":\"2022122305347606\",\"product_code\":\"FAST_INSTANT_TRADE_PAY\",\"qr_pay_mode\":4,\"qrcode_width\":120,\"subject\":\"test\",\"total_amount\":\"0.01\"}'>\n<input type='hidden' name='sign' value='UkxpmPyJc1YPVL8sZmc0dX2MO5XCY2GTENSe6JectGjDGilZiWHmxr2ibdKGZwV1N0a1yhu9m8itQ9zVWXvx82ODiCM7A8srp6YoMjXqgO2W8BpdcU5zhBNWj5xiolyY72dYGUATCJVpcwUWpPyRiF71wyGMYJ+x5pS21+S39jGIHmObEO+19tiI0meCcEMFC4DubsAZAOaAkgNCJ7eNnCglPRMCwxl79KSEc6gCLjeZpPS+nQTX/Pxtk2d4y2xHPnQqvSoADxx138w/Uw79OE6EHoBhoDIT9fp/gIanLE32hoel7pum8jjsF3ebk/X7WQCkwWkF6PGmHIIHAWPW8A=='>\n<input type='hidden' name='notify_url' value='https://domain_name/v1/alipay/receive_notify'>\n<input type='hidden' name='method' value='alipay.trade.page.pay'>\n<input type='submit' value='立即支付' style='display:none' >\n</form>\n<script>document.forms[0].submit();</script>

再将生成的form代码放入iframe中，代码如下：

html  <iframe :srcdoc="html" frameborder="no" border="0" marginwidth="0" marginheight="0" scrolling="no" style="overflow: hidden" height="120" width="120" />