在 iOS 應用中接入支付寶的 App 支付,主要圍繞「訂單信息構建」與「訂單簽名」兩大環節展開。本文梳理了整個流程的關鍵代碼與注意事項,幫助你快速理解支付接入的骨架。
首先需要創建商品實例,並填入收銀台需要展示的基礎信息,例如商品標題、描述與價格:
/*
*點擊獲取 product 實例並初始化訂單信息
*/
Product *product = [[Product alloc] init];
product.subject = @"機票";
product.body = @"乘客機票";
product.price = 0.01f;
接著配置商戶的身份憑證。簽約完成後,支付寶會為每個商戶分配一組唯一的 partner 與 seller,此外還需要用到商戶的私鑰用於簽名:
/*======================= 需要填寫商戶 app 申請的 ===================================*/
NSString *partner = alipayPartner;
NSString *seller = alipaySeller;
NSString *privateKey = alipayPrivateKey;
// partner 和 seller 獲取失敗時給出提示
if ([partner length] == 0 || [seller length] == 0)
{
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"提示"
message:@"缺少 partner 或者 seller。"
delegate:self
cancelButtonTitle:@"確定"
otherButtonTitles:nil];
[alert show];
return;
}
把商品信息逐一賦值到訂單對象上。這裡有幾個字段值得留意:productName 是這筆交易的名稱,不僅會在收銀台清晰展示,也會出現在支付寶賬戶的交易明細列表首列,因此在財務對賬與交易查詢篩選上都扮演重要角色。
// 將商品信息賦予 Order 的成員變量
Order *aliOrder = [[Order alloc] init];
aliOrder.partner = partner;
aliOrder.seller = seller;
aliOrder.tradeNO = [self generateTradeNO]; // 訂單 ID(由商家自行制定)
aliOrder.productName = product.subject; // 商品標題
aliOrder.productDescription = product.body; // 訂單描述
aliOrder.amount = [NSString stringWithFormat:@"%.2f", product.price]; // 商品價格
aliOrder.notifyURL = @"https://www.xxx.com"; // 回調 URL
aliOrder.service = @"mobile.securitypay.pay"; // 服務名稱
aliOrder.paymentType = @"1"; // 支付類型,1 代表商品購買
aliOrder.inputCharset = @"utf-8"; // 編碼類型
aliOrder.itBPay = @"30m";
aliOrder.showUrl = @"m.alipay.com"; // 展示地址
// 應用註冊 scheme,在 -Info.plist 定義 URL types
NSString *appScheme = @"alipayForSpringAirlines";
// 將商品信息拼接成字符串
NSString *orderSpec = [aliOrder description];
NSLog(@"orderSpec = %@", orderSpec);
// 獲取私鑰並對商戶信息簽名,遵循 RSA 簽名規範,並將簽名字符串 base64 編碼與 UrlEncode
id signer = CreateRSADataSigner(privateKey);
NSString *signedString = [signer signString:orderSpec];
// 將簽名成功字符串格式化為訂單字符串,請嚴格按照該格式
NSString *orderString = nil;
if (signedString != nil) {
orderString = [NSString stringWithFormat:@"%@&sign=\"%@\"&sign_type=\"%@\"",
orderSpec, signedString, @"RSA"];
[[AlipaySDK defaultService] payOrder:orderString fromScheme:appScheme callback:^(NSDictionary *resultDic) {
NSLog(@"result = %@", resultDic);
}];
}
訂單號需要保證唯一性,下面的方法通過隨機字符拼接生成:
- (NSString *)generateTradeNO
{
static int kNumber = 15;
NSString *sourceStr = @"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
NSMutableString *resultStr = [[NSMutableString alloc] init];
srand(time(0));
for (int i = 0; i < kNumber; i++)
{
unsigned index = rand() % [sourceStr length];
NSString *oneStr = [sourceStr substringWithRange:NSMakeRange(index, 1)];
[resultStr appendString:oneStr];
}
return resultStr;
}
完成以上步驟,即實現了從商品信息構建、訂單簽名到拉起支付寶收銀台的完整流程。