USEEPAY V1.0
中文
  • 中文
  • English
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
中文
  • 中文
  • English
  1. googlepay
  • 全球收单
    • 产品说明
    • 集成模式
      • 跳转式收银台模式
      • 内嵌式收银台模式
      • Direct API模式
      • 插件模式
    • 集成之前
      • 开始之前(必读)📘
      • 在SandBox中集成接口
      • 在Prod中上线服务
      • 请求签名指南
        • 加签/验签Demo
        • 加签/验签机制
    • 开始集成
      • UseePay规范
        • 业务结果码(ResultCode)
        • 错误码(ErrorCode)
        • 货币单位和金额规范
        • 国家信息规范
      • 接口集成📗
        • 对象模型
        • 跳转式收银台接口
          • cashier 接口说明
          • paymentMethod参数说明
          • googlepay
            • GoogePay须知
            • googlepay
          • applepay
            • 判断当前设备是否支持applepay
            • applepay
          • wechat_native
            • 关于微信退款
            • wechat_native - 微信扫码支付
          • wechat_h5
            • 关于微信退款
            • wechat_h5 - H5支付
          • cashier 📌
          • credit_card
          • bancontact
          • boleto
          • giropay
          • Ideal
          • klarna
          • konbini
          • oxxo
          • payeasy
          • pix
          • sofort
        • 内嵌式收银台接口
          • 信用卡
            • 2.x 版本内嵌收银台
            • 内嵌订阅收银台
            • 版本更新说明
            • 1.x版本内嵌收银台
          • applepay & googlepay
            • 内嵌方式对接2.0.0
          • create token
        • Direct API接口
          • googlepay
            • GoogePay须知
            • googlepay
              POST
          • applepay
            • 判断当前设备是否支持applepay
            • ApplePay API接入流程
            • ApplePay API接入流程备份
            • ApplePay Merchant Identifier
            • applepay
            • ApplePay商户Session
          • wechat_native
            • 关于微信退款
            • wechat_native - 扫码支付
          • wechat_jsapi
            • 关于微信退款
            • 小程序支付
            • 微信公众号支付
            • wechat_jsapi - 微信原生支付
          • konbini
            POST
          • payeasy
            POST
          • klarna
            POST
          • alipay
            POST
          • alipay_cn/alipay_hk
            POST
          • giropay
            POST
          • sofort
            POST
          • Ideal
            POST
          • boleto
            POST
        • 订单相关接口
          • 订单通用接口
            • 订单查询Query
            • 订单退款Refund
            • 订单预授权完成(Capture)
            • 订单预授权撤销(Void)
          • 拒付接口
            • 拒付流程说明
            • 拒付查询
          • 通知接口
            • 交易通知
              • 同步/异步通知
              • webhook版本升级一览
              • webhook
            • 拒付通知
              • 拒付webhook
          • 物流接口
            • 物流信息上传 2.1版
            • 物流信息查询 2.1版
          • 订单数据拉取 - SFTP
            • SFTP
      • 测试资源-SandBox
        • UseePay测试卡💳
        • 信用卡测试案例
        • 本地化测试案例
        • ApplePay&& Google Pay测试用例
        • 退款测试案例
      • 插件集成
        • Shopify(直连内嵌收银台)
        • Shopify(跳转收银台 & Google pay & Apple pay)
        • Shopify(本地化 & Google pay & Apple pay)
        • Shoplazza店匠
        • Shopline
        • Shopline(Google pay & Apple pay)
        • AllValue有赞
        • Shopexpress微盟
        • Shopyy
        • Xshoppy
        • 2cshop
        • Meshop
        • UEESHOP
        • FPP
        • Shopbase(暂停使用)
        • Shoptop
        • Shopastro
        • Magento
        • Woocommerce/WordPress
        • OpenCart
        • PapPal支付绑定
        • Alipay支付绑定
        • 万全云
        • Fecify
        • magento - Wechat/Alipay/UseePay Payments
        • shopify其他
          • Afterpay分期付款组件展示
          • Googlepay&Applepay名称修改
          • 如何增加卡组织logo
          • UseePay商户订单号匹配Shopify店铺订单
    • MC收单平台操作手册
      • 商户号查找
      • Appld查找
      • 域名添加
      • 域名证明下载
      • Shopify-SecurityKey查找
      • 密钥查找
      • 交易订单查找
      • 订单失败原因查看
      • 退款查询
      • 退款处理
      • ARN查询方式
      • 银行账号添加
      • 提现操作
      • 黑名单添加
      • 白名单添加
      • 新增操作员设置
      • 添加邮箱提醒
      • 物流上传
      • 对账单下载&查询
      • 争议订单处理
      • 拒付处理
      • 拒付预警处理
      • 重置密码
    • 附录
      • 本地化汇总
      • FAQ
        • 常见问题解答
        • 集成和认证
        • ueeshop配置常见错误
        • ApplePay常见问题
        • 支付和预授权的区别
      • 过期文档
        • applepay&googlepay 内嵌1.0.0
        • 参数对象说明(过期)
  • 数据模型
    • 示例数据模型
      • Pet
      • OrderInfo
      • Category
      • Tag
  1. googlepay

googlepay

全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
POST
/googlepay/api
关于请求参数
1.payerInfo中的的paymentMethod需指定为”googlepay“
关于签名:
1.按照ASCII码顺序对请求的 payload 进行排序
2.按第一步获取的结果,进行key-value 遍历, 对 value trim 后不为空的 key-value 使用 URL 键值对的格式进行拼接(key1=value1&key2=value2...),
3.第2步取到字符串, 拼接上 &pkey=商户的MD5/RSA密钥, 然后对该字符串进行MD5/RSA, 得到的值即为签名值
关于响应处理:
1.根据resultCode判断交易状态。
2.redirectParam中包含的ApplePayPaymentAuthorizationResult字符串,为ApplePaySDK需要的参数,请解析之后使用
1.
GooglePay js SDK集成需要参考https://developers.google.com/pay/api/web/guides/tutorial?hl=zh-cn
注意点:
1.在第2部指定付款令牌,需要如下设置:
tokenizationSpecification: {
type: 'PAYMENT_GATEWAY',
parameters: {
gateway: 'useepay',
gatewayMerchantId: //在Useepay处的商户号//
}
}
2.第3步设置卡组时,需要结合自身业务与Useepay咨询可使用的卡组范围。否则不支持的卡组将无法进行交易。allowedCardAuthMethods必须如下设置,这会提供成功率和预防诈骗交易。
const allowedCardAuthMethods = ["PAN_ONLY", "CRYPTOGRAM_3DS"];
3.第8步设置merchantInfo时,需要注册并登录 Google Pay & Wallet Console.,获取开发者merchantId
image.png
4.在处理 onPaymentAuthorized 回调时,需要将提取付款令牌时获得的paymentToken作为Googlepay API需要的参数,在加签后请求交易。
5.第10,12,13步 Useepay目前暂不支持
6.Google Pay的交易处理中,可能会触发3d, 因此需要进行3d流程处理。参考s2s对接流程中的3d处理。

请求参数

Header 参数

Body 参数application/x-www-form-urlencoded

返回响应

🟢200成功
application/json
Body

🔴500服务器错误
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://pay-gateway1.uat.useepay.com/googlepay/api' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'version=1.0' \
--data-urlencode 'merchantNo=500000000007362' \
--data-urlencode 'transactionId=202212070142347' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'transactionExpirationTime=30' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'amount=1234' \
--data-urlencode 'currency=USD' \
--data-urlencode 'orderInfo={  "subject": "订单标题",  "goodsInfo": [    {      "id": "商品编号",      "name": "商品名称",      "body": "商品描述",      "category": "商品类目",      "categoryTree": "商品类目树,不同级别类目使用”|”分割",      "brand": "商品品牌",      "quantity": 1,      "price": 1234,      "url": "商品url",      "sku": "商品sku",      "image": "商品图片url"    }  ],  "deliveryMethod": "logistics",  "deliveryTime": "",  "shippingAddress": {    "email": "victor.yang@useepay.com",    "phoneNo": "+44 20 7734 9638",    "firstName": "Victor",    "lastName": "Yang",    "street": "Heathcoat House, 20 Savile Row",    "postalCode": "W1S 3PR",    "city": "London",    "state": "LND",    "country": "GB"  }}' \
--data-urlencode 'payerInfo={  "paymentMethod": "googlepay",  "authorizationMethod": "cvv",  "billingDescriptor": "",  "billingAddress": {    "houseNo": "El Gallo Giro(https://gallogiro.com/)",    "email": "victor.yang@useepay.com",    "phoneNo": "(323) 585-4433",    "firstName": "Victor",    "lastName": "Yang",    "street": "7148 Pacific Blvd, Huntington Park, CA 90255",    "postalCode": "90225",    "city": "Huntington Park",    "state": "CA",    "country": "US"  }}' \
--data-urlencode 'userInfo={  "userId": "victor007",  "ip": "103.25.65.178",  "email": "victor.yang@useepay.com",  "phoneNo": "(323) 585-4433",  "createTime": "20200520131400"}' \
--data-urlencode 'notifyUrl=webhook地址' \
--data-urlencode 'redirectUrl=USEEPAY 回跳商户地址' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'sign=decb3b9b728c7af4251acae23804939b' \
--data-urlencode 'referer=https://pinkx.com/' \
--data-urlencode 'googlePayToken='
响应示例响应示例
200 - 支付成功
{
    "merchantNo": "500000000007381",
    "transactionId": "202112011024047",
    "transactionType": "pay",
    "reference": "1012112011024652513",
    "amount": "1234",
    "currency": "USD",
    "resultCode": "succeed",
    "errorCode": "0000",
    "errorMsg": "Approved or completed successfully",
    "echoParam": "echoParam",
    "reserved": "ApplePayPaymentAuthorizationResult(status=0, errors=[])",
    "sign": "1aab1771d7846efb74edb801a0fd772d"
}
修改于 2025-08-22 03:28:24
上一页
GoogePay须知
下一页
判断当前设备是否支持applepay
Built with