概述
Alipay 直连场景仅支持以下支付: PC 扫码支付、小程序支付和 APP 支付。商户应根据实际支付场景设置 methods 参数,并按场景处理接口返回结果。
如需接入 Alipay 的全部支付场景,请参阅 Alipay 接入文档。
流程图
请求
商户服务器调用直连模式提交必要参数:
- PC 扫码支付
- 小程序
- APP
cURL -X POST 'https://test-secure.oceanpayment.com/gateway/directservice/pay'
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'account=995149' \
-d 'terminal=99514901' \
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b' \
-d 'backUrl=https://www.abc.com/back.php' \
-d 'noticeUrl=https://www.abc.com/notice.php' \
-d 'order_number=NO12345678' \
-d 'order_currency=HKD' \
-d 'order_amount=0.01' \
-d 'methods=Alipay_Web' \
-d 'order_notes=' \
-d 'billing_firstName=test' \
-d 'billing_lastName=test' \
-d 'billing_email=test@gmail.com' \
-d 'billing_phone=13800138000' \
-d 'billing_country=HK' \
-d 'billing_state=HK' \
-d 'billing_city=Washington D.C.' \
-d 'billing_address=705A big Road' \
-d 'billing_zip=529012' \
-d 'billing_ip=127.0.0.1' \
-d 'productNum=1' \
-d 'productName=Red Dress' \
-d 'productSku=#001' \
-d 'productPrice=0.01' \
| 场景 | 说明 | 支付方式 methods传值 |
|---|---|---|
| 小程序 | 用于微信小程序打开,完成支付 | Alipay_Wap |
cURL -X POST 'https://test-secure.oceanpayment.com/gateway/directservice/pay'
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'account=995149' \
-d 'terminal=99514901' \
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b' \
-d 'backUrl=https://www.abc.com/back.php' \
-d 'noticeUrl=https://www.abc.com/notice.php' \
-d 'order_number=NO12345678' \
-d 'order_currency=HKD' \
-d 'order_amount=0.01' \
-d 'methods=Alipay_Wap' \
-d 'order_notes=' \
-d 'billing_firstName=test' \
-d 'billing_lastName=test' \
-d 'billing_email=test@gmail.com' \
-d 'billing_phone=13800138000' \
-d 'billing_country=HK' \
-d 'billing_state=HK' \
-d 'billing_city=Washington D.C.' \
-d 'billing_address=705A big Road' \
-d 'billing_zip=529012' \
-d 'billing_ip=127.0.0.1' \
-d 'productNum=1' \
-d 'productName=Red Dress' \
-d 'productSku=#001' \
-d 'productPrice=0.01' \
| 场景 | 说明 | 支付方式 methods传值 |
|---|---|---|
| APP | 用于 APP 内打开,完成支付 | Alipay_APP |
cURL -X POST 'https://test-secure.oceanpayment.com/gateway/directservice/pay'
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'account=995149' \
-d 'terminal=99514901' \
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b' \
-d 'backUrl=https://www.abc.com/back.php' \
-d 'noticeUrl=https://www.abc.com/notice.php' \
-d 'order_number=NO12345678' \
-d 'order_currency=HKD' \
-d 'order_amount=0.01' \
-d 'methods=Alipay_APP' \
-d 'order_notes=' \
-d 'billing_firstName=test' \
-d 'billing_lastName=test' \
-d 'billing_email=test@gmail.com' \
-d 'billing_phone=13800138000' \
-d 'billing_country=HK' \
-d 'billing_state=HK' \
-d 'billing_city=Washington D.C.' \
-d 'billing_address=705A big Road' \
-d 'billing_zip=529012' \
-d 'billing_ip=127.0.0.1' \
-d 'productNum=1' \
-d 'productName=Red Dress' \
-d 'productSku=#001' \
-d 'productPrice=0.01' \
响应
查看完整的响应参数。
- PC 扫码支付
- 小程序
- APP
<?xml version="1.0" encoding="UTF-8"?>
<response>
<notice_type>transaction</notice_type>
<push_dateTime>2026-11-12 07:25:57</push_dateTime>
<account>995149</account>
<terminal>99514901</terminal>
<signValue>41FE077BA389DB90DEF5EEC70AB2C401D7027D6940F1203700FBAE3CB116BB42</signValue>
<methods>Alipay_Web</methods>
<order_number>NO12345678</order_number>
<card_country></card_country>
<order_currency>HKD</order_currency>
<order_amount>0.01</order_amount>
<order_notes></order_notes>
<card_number></card_number>
<card_type></card_type>
<payment_country>HK</payment_country>
<payment_id>231219095247018026021</payment_id>
<payment_authType>0</payment_authType>
<payment_status>-1</payment_status>
<payment_details>80700:Transaction was not finished</payment_details>
<payment_solutions></payment_solutions>
<payment_risk></payment_risk>
<payment_amount></payment_amount>
<payment_exchangeRate></payment_exchangeRate>
<pay_barCode>https://mapi-hk.alipay.com/gateway.do?secondary_merchant_industry=5309&payment_inst=ALIPAYHK&_input_charset=UTF-8&subject=TEST&sign=51ddde190361185f9958089f040b18d3¬ify_url=https%3A%2F%2Fsecure.oceanpayment.com%3A443%2Fgateway%2FnoticeBank%2F33030%2F1&body=OCEANPAYMENT+CO+LIMITED&product_code=NEW_WAP_OVERSEAS_SELLER&qr_pay_mode=4&qrcode_width=200&secondary_merchant_id=202694&out_trade_no=240227163114106010589&partner=2088331369492145&service=create_forex_trade&total_fee=1.0&secondary_merchant_name=OCEANPAYMENT+CO+LIMITED&return_url=https%3A%2F%2Fsecure.oceanpayment.com%3A443%2Fgateway%2FreceiveBank%3Fbank_code%3D33030¤cy=HKD&sign_type=MD5</pay_barCode>
<pay_userId></pay_userId>
<payment_transactionNetworkId></payment_transactionNetworkId>
<payment_transactionLinkId></payment_transactionLinkId>
</response>
- 订单状态:当
payment_status= -1 时,表示订单处于待处理状态。商户需获取支付宝二维码参数pay_barCode,并在付款页面将其生成二维码供用户扫码支付。 - 将
pay_barCode值放入您付款页的 iframe 中,让支付宝返回的页面展示二维码:
<iframe
src="https://mapi-hk.alipay.com/gateway.do?secondary_merchant_industry=5309&payment_inst=ALIPAYHK&_input_charset=UTF-8&subject=TEST&sign=51ddde190361185f9958089f040b18d3¬ify_url=https%3A%2F%2Fsecure.oceanpayment.com%3A443%2Fgateway%2FnoticeBank%2F33030%2F1&body=OCEANPAYMENT+CO+LIMITED&product_code=NEW_WAP_OVERSEAS_SELLER&qr_pay_mode=4&qrcode_width=200&secondary_merchant_id=202694&out_trade_no=240227163114106010589&partner=2088331369492145&service=create_forex_trade&total_fee=1.0&secondary_merchant_name=OCEANPAYMENT+CO+LIMITED&return_url=https%3A%2F%2Fsecure.oceanpayment.com%3A443%2Fgateway%2FreceiveBank%3Fbank_code%3D33030¤cy=HKD&sign_type=MD5"
width="100%"
height="400"
frameborder="0">
</iframe>
<?xml version="1.0" encoding="UTF-8"?>
<response>
<notice_type>transaction</notice_type>
<push_dateTime>2026-11-12 16:18:07</push_dateTime>
<response_type>1</response_type>
<account>995149</account>
<terminal>99514901</terminal>
<signValue>37439C92DCB47DE826AE32A7388B038F017D8709DB4D2750658C9AF937F0FFB4</signValue>
<methods>Alipay_Wap</methods>
<order_number>NO12345678</order_number>
<card_country></card_country>
<order_currency>HKD</order_currency>
<order_amount>0.01</order_amount>
<order_notes></order_notes>
<card_number></card_number>
<card_type></card_type>
<payment_country>HK</payment_country>
<payment_id>231219095247018026022</payment_id>
<payment_authType>0</payment_authType>
<payment_status>-1</payment_status>
<payment_details>80700:Transaction was not finished</payment_details>
<payment_solutions></payment_solutions>
<payment_risk></payment_risk>
<payment_amount></payment_amount>
<payment_exchangeRate></payment_exchangeRate>
<pay_barCode>260715211946554054007</pay_barCode>
<pay_userId></pay_userId>
<payment_transactionNetworkId></payment_transactionNetworkId>
<payment_transactionLinkId></payment_transactionLinkId>
</response>
- 订单状态:商户发起支付请求后,订单状态同步返回
payment_status= -1,表示待处理。用户完成支付后,系统将实时返回支付结果。 - 支付参数:
pay_barCode中包含调用支付宝小程序my.crossPay方法所需的tradeNO参数。具体调用方式请参阅支付宝官方文档。
- 小程序唤起支付示例
const pay_barCode = '260715211946554054007';
my.crossPay({
tradeNO: pay_barCode,
success(res) {
console.log(res);
my.alert({
content: JSON.stringify(res)
});
},
fail(err) {
console.log(err);
my.alert({
content: JSON.stringify(err)
});
}
});
<?xml version="1.0" encoding="UTF-8"?>
<response>
<notice_type>transaction</notice_type>
<push_dateTime>2026-11-12 16:18:07</push_dateTime>
<response_type>1</response_type>
<account>995149</account>
<terminal>99514901</terminal>
<signValue>37439C92DCB47DE826AE32A7388B038F017D8709DB4D2750658C9AF937F0FFB4</signValue>
<methods>Alipay_APP</methods>
<order_number>NO12345678</order_number>
<card_country></card_country>
<order_currency>HKD</order_currency>
<order_amount>0.01</order_amount>
<order_notes></order_notes>
<card_number></card_number>
<card_type></card_type>
<payment_country>HK</payment_country>
<payment_id>231219095247018026022</payment_id>
<payment_authType>0</payment_authType>
<payment_status>-1</payment_status>
<payment_details>80700:Transaction was not finished</payment_details>
<payment_solutions></payment_solutions>
<payment_risk></payment_risk>
<payment_amount></payment_amount>
<payment_exchangeRate></payment_exchangeRate>
<pay_barCode></pay_barCode>
<pay_userId></pay_userId>
<payment_transactionNetworkId></payment_transactionNetworkId>
<payment_transactionLinkId></payment_transactionLinkId>
<payment_bankInfo>cGFydG5lcj0iMTI1ODYyNDg5NjI1MjE3IiZzZWxsZXJfaWQ9IjEyNTg2MjQ4OTYyNTIxNyImb3V0X3RyYWRlX25vPSIyNjExMTMwOTM4MTE1MDg5MDMwMjciJnN1YmplY3Q9IlRFU1QiJmJvZHk9IlRFU1QiJnRvdGFsX2ZlZT0iMC4xIiZub3RpZnlfdXJsPSJodHRwczovL3NlY3VyZS5vY2VhbnBheW1lbnQuY29tOjQ0My9nYXRld2F5L25vdGljZUJhbmsvODAwNzcvMSImc2VydmljZT0ibW9iaWxlLnNlY3VyaXR5cGF5LnBheSImcGF5bWVudF90eXBlPSIxIiZfaW5wdXRfY2hhcnNldD0iVVRGLTgiJml0X2JfcGF5PSIzMG0iJnJldHVybl91cmw9Imh0dHBzOi8vc2VjdXJlLm9jZWFucGF5bWVudC5jb206NDQzL2dhdGV3YXkvcmVjZWl2ZUJhbms/YmFua19jb2RlPTgwMDc3IiZwYXltZW50X2luc3Q9IkFMSVBBWUhLIiZjdXJyZW5jeT0iSEtEIiZwcm9kdWN0X2NvZGU9Ik5FV19XQVBfT1ZFUlNFQVNfU0VMTEVSIiZmb3JleF9iaXo9IkZQIiZzZWNvbmRhcnlfbWVyY2hhbnRfaW5kdXN0cnk9IjcyOTgiJnNlY29uZGFyeV9tZXJjaGFudF9uYW1lPSJISyImc2Vjb25kYXJ5X21lcmNoYW50X2lkPSIyNTg0NzEzNjg1MjMiJnNpZ249ImxHMUh1OE9VYTFHMnJGU292amR2b21wd3V0OEZlbW9uWkRUb1VyaTlpSlpMZ2I5dzNJV0NWU05ET0o2RWFrMjZWQVAlMkZSRVFCMmo1dnZyTEFWVSUyRlpjb21jS3Y1ZjlmSmV6TUZkY21kQnIlMkJ0NGFpbXpzRmJCcUp1bVN2WXN6WVptQnk0M3lTRWd5dFliQXk0eGlRJTJGbGd2ZlQ5bU1pNTZjZlFmZVElMkYwdmN1RzglM0QiJnNpZ25fdHlwZT0iUlNBIg==</payment_bankInfo>
</response>
- 订单状态:商户发起支付请求后,订单状态同步返回
payment_status= -1,表示待处理。用户完成支付后,系统将实时返回支付结果。 - 支付返回
payment_bankInfo是 Base64 编码字符串。商户需先进行 Base64 解码,解码后将完整订单参数传给支付宝 APP 支付 SDK。具体调用方式请参阅微信支付官方文档。
注意
Base64 只是编码,不是加密。请通过 HTTPS 传输参数,并避免将完整的 payment_bankInfo 或解码后的支付参数写入日志。字段顺序应以 Oceanpayment 返回参数定义为准。
- 使用项目已集成的支付宝 Android SDK。在非 UI 线程调用 payV2
//java
#import <AlipaySDK/AlipaySDK.h>
NSString *encoded = payBarCode; // Oceanpayment 返回的 Base64 字符串
NSData *decodedData = [[NSData alloc]
initWithBase64EncodedString:encoded
options:NSDataBase64DecodingIgnoreUnknownCharacters];
NSString *orderInfo = [[NSString alloc]
initWithData:decodedData
encoding:NSUTF8StringEncoding];
if (orderInfo == nil) {
// Base64 解码或 UTF-8 转换失败
return;
}
[[AlipaySDK defaultService] payOrder:orderInfo
fromScheme:@"yourAppScheme"
callback:^(NSDictionary *resultDic) {
// 根据回调更新页面状态;
// 最终支付状态仍应由商户服务器确认。
}];
- 使用项目已集成的支付宝 iOS SDK。先解码,再调用 payOrder;
appScheme替换为商户 APP 配置的 Scheme:
//objective-c
#import <AlipaySDK/AlipaySDK.h>
NSString *encoded = payBarCode; // Oceanpayment 返回的 Base64 字符串
NSData *decodedData = [[NSData alloc]
initWithBase64EncodedString:encoded
options:NSDataBase64DecodingIgnoreUnknownCharacters];
NSString *orderInfo = [[NSString alloc]
initWithData:decodedData
encoding:NSUTF8StringEncoding];
if (orderInfo == nil) {
// Base64 解码或 UTF-8 转换失败
return;
}
[[AlipaySDK defaultService] payOrder:orderInfo
fromScheme:@"yourAppScheme"
callback:^(NSDictionary *resultDic) {
// 根据回调更新页面状态;
// 最终支付状态仍应由商户服务器确认。
}];
付款状态
查看详细的付款状态说明。
异步通知
您还需要通过noticeUrl接收交易的异步通知。
签名
查看详细的签名和验签功能。