手机网页支付
商户的应用程序是 一个移动网页,需要在手机/平板电脑等手持终端上完成支付,请参阅本节提供的解决方案以访问PayCloud支付。
集成说明
移动网页支付是指商家在移动网页上显示商品或服务(通常在Chrome、Safari等移动浏览器或移动设备系统默认浏览器中打开,以及一些也可以显示网页的移动应用内置浏览器中打开)。当用户在商家页面上选择支付方式时,浏览器会自动重定向到PayCloud移动网页收银台以完成支付,并重定向到商家页面。
PayCloud移动网页收银台集成了大量银行/收单机构/第三方支付服务提供商的移动网页收银台,包括银行卡在线支付/手机钱包账户支付/移动钱包APP支付等。
用户完成支付后,商家可以收到PayCloud的支付通知,商家也可以主动调用查询订单接口获取支付结果。在获得付款结果后,同步并更新订单,以完成剩余的商品和服务流程。
下单时,如果未传入支付方式(pay_method_id
),用户将被重定向到 PayCloud 收银台的支付方式选择页面。虽然这种方式可以降低商户的开发工作量,但我们仍然建议您自行开发并托管收银台页面。这不仅能为用户提供一致的支付体验,还能降低因我们的域名被屏蔽而导致支付页面无法正常访问的风险。
使用微信支付,Alipay+的商户,请确保调用此接口时已经开通线上支付权限,并且是从手机默认的浏览器或第三方浏览器(不能在微信、支付宝内置的浏览器中打开)发起的支付请求,否则,用户将无法正常完成支付。我们通常所说的H5支付,即这个场景。
使用案例

开发指引
我们提供了一组REST API,请参阅下表,这些API提供了几种语言的SDK,请访问SDK章节。
API名称 | 说明 |
---|---|
手机网页支付下单 | 通过此api提交付款订单 |
取消订单 | 通过此api关闭未付款订单,如果已经付款,则向用户退款 |
提交退款申请 | 如果您通过此API提交退款请求,但退款没有立即到达,您可以调用退款查询API来获取退款的进度。 |
查询支付订单 | 通过该API查询正向交易订单的交易结果(消费/预授权/预授权完成) |
查询退款订单 | 通过此API查询退款交易订单(消费取消/预授权取消/消费退款/预授权完成退款)的交易结果 |
交易结果通知 | 交易完成后,通知商家,告知商家交易结果 |
注意事项
支付宝支付注意事项
pay_method_id
只能传Alipay+, 而不能传Alipay, 当你只想展示Alipay不需要其他的A+钱包如Gcash、TNG、AlipayHK等时,你可以设置sub_pay_method_id
= Alipay。
微信H5支付注意事项
-
我们默认不会为你开通H5支付,如果你需要,请单独告知我们的业务人员。H5支付申请微信需要更多的认证材料,请按照Newage的提示提交申请材料。
-
微信会验证的你的支付发起域名,也就是跳转到微信的页面之前你的网页域名,该域名需要到微信后台进行配置,配置界面如下,请将你需要申请的域名提交给Newage。如果你没有设置
pay_method_id
和wechatpay_product_type
参数的值,微信获取到的发起页域名是Newage,那么H5支付会失败。

-
pay_method_id
请设置值等于WeChatPay
,wechatpay_product_type
参数,请设置值等于H5
。 -
传递以上参数和配置后,你可以请求我们的API,拿到返回参数
pay_url
, 请跳转到该微信H5收银台页面,该页面会自动启动H5支付。 -
如果你得到以下错误,请检查是否已经按照以上步骤操作。
