跳到主要内容

手机网页支付

商户的应用程序是一个移动网页,需要在手机/平板电脑等手持终端上完成支付,请参阅本节提供的解决方案以访问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查询退款交易订单(消费取消/预授权取消/消费退款/预授权完成退款)的交易结果
交易结果通知交易完成后,通知商家,告知商家交易结果

注意事项

支付宝支付注意事项

  1. pay_method_id 只能传Alipay+, 而不能传Alipay, 当你只想展示Alipay不需要其他的A+钱包如Gcash、TNG、AlipayHK等时,你可以设置sub_pay_method_id = Alipay。

微信H5支付注意事项

  1. 我们默认不会为你开通H5支付,如果你需要,请单独告知我们的业务人员。H5支付申请微信需要更多的认证材料,请按照Newage的提示提交申请材料。

  2. 微信会验证的你的支付发起域名,也就是跳转到微信的页面之前你的网页域名,该域名需要到微信后台进行配置,配置界面如下,请将你需要申请的域名提交给Newage。如果你没有设置pay_method_idwechatpay_product_type参数的值,微信获取到的发起页域名是Newage,那么H5支付会失败。

微信支付H5域名配置
  1. pay_method_id请设置值等于WeChatPay, wechatpay_product_type参数,请设置值等于H5

  2. 传递以上参数和配置后,你可以请求我们的API,拿到返回参数 pay_url, 请跳转到该微信H5收银台页面,该页面会自动启动H5支付。

  3. 如果你得到以下错误,请检查是否已经按照以上步骤操作。

微信支付H5支付报错