USEEPAY
  1. Jsapi支付下单接口
USEEPAY
  • 全球收单
    • 域名说明
    • 集成流程说明
    • 生产账户启用
    • UseePay出口IP说明
    • 签名指导
      • 签名
      • 验签
      • demo
    • 沙盒测试资源
      • 测试卡号
      • 信用卡测试案例
      • 退款测试案例
      • 本地化测试案例
      • ApplePay&& Google Pay测试用例
    • 跳转式收银台接口
      • 跳转收银台paymentMethod参数说明
      • 支付/预授权
    • 内嵌式收银台接口
      • 0.0.1-只支持信用卡
        • 内嵌收银台快捷支付
        • 内嵌收银台新版本更新说明
        • 内嵌收银台对接说明
      • 新版-支持信用卡+AP+GP
        • 内嵌收银台2.0.0版本说明
      • create token 创建JSSDK所需的token
    • 订单通用接口
      • 退款Refund
      • 查询Query
      • 预授权撤销(Void)
      • 预授权完成(Capture)
    • 本地化支付
      • 本地化汇总
      • 本地化接口
        • 便利店支付
          • konbini
            • konbini 收银台模式
            • konbini api模式
          • payeasy
            • payeasy api 模式
            • payeasy 收银台模式
        • 分期付款Pay Later
          • Klarna产品介绍
          • Klarna direct
          • Klarna Redirect
        • 电子钱包
          • Alipay
            • Alipay Direct 文档
            • alipay_cn/alipay_hk direct 文档
          • Wechat-HK
            • 扫码支付
              • 扫码支付
              • direct
                • 扫码支付 Server To Server模式
              • redirect
                • 扫码支付收银台模式(wechat_native)
            • Jsapi支付下单接口
              • 小程序支付
              • 微信公众号支付
              • Jsapi支付下单接口
                POST
            • H5支付
              • H5支付
          • Google Pay
            • GoogePay Test card
            • Google Pay 对接可能遇到的问题
            • redirect
              • 跳转式GooglePay收银台
            • api
              • Google Pay API对接
              • Googlepay API 支付
          • applepay
            • ApplePay 扩展
            • ApplePay API
              • ApplePay API接入流程
              • ApplePay API接入流程备份
              • ApplePay Merchant Identifier
              • ApplePay支付
              • ApplePay商户Session
            • applepay cashier
              • applepay 跳转收银台
          • applepay&googlepay内嵌
            • 1.0.0 内嵌方式对接 (建议使用“内嵌方式对接2.0.0”版本)
            • 内嵌方式对接2.0.0
        • 银行转账
          • pix
          • Giropay
            • Giropay_Redirect
            • Giropay_Direct
          • sofort
            • sofort_Redirect
            • sofort_Direct
          • bancontact
            • bancontact_Redirect
          • Ideal
            • Ideal_Redirect
            • Ideal_Direct
          • boleto
            • boleto_Direct
        • 本地化Card
        • Cash(Ticket)现金支付
          • oxxo
          • boleto
          • Cash Common
      • 支付方式(国家/地区)
        • 荷兰
        • 巴西
        • 墨西哥
        • 中国香港
        • 日本
        • 德国
        • 奥地利
        • 西班牙
        • 波兰
        • 意大利
        • 哥伦比亚
        • 比利时
        • 瑞士
    • 通用对象参数和规范说明
      • 参数对象说明(过期)
      • 业务结果码(ResultCode)
      • 错误码(ErrorCode)
      • 金额和货币单位
      • 国家信息参考
      • 对象模型
        • userInfo
        • shippingAddress
        • goodsInfo
        • billingAddress
        • deviceInfo
        • transactionInfo
    • 通知接口说明
      • 交易通知
        • 同步通知
        • 异步 webhook版本升级
        • webhook
      • 拒付
        • 拒付webhook
    • 物流接口
      • 物流信息上送
        • 物流信息上传2.1
        • 物流信息上传(已废弃)
      • 物流信息查询
        • 物流信息查询2.1
        • 物流信息查询(已废弃)
    • 拒付接口
      • 拒付流程说明
      • 拒付查询
    • SFTP
      • SFTP
    • 常见问题
      • 支付和预授权的区别
    • demo
    • 插件安装指导
      • magento插件支付安装
        • Wechat/Alipay/UseePay Payments
    • 订阅
      • 订阅文档
  • 产品说明
    • 收银台
    • 内嵌式收银台
    • Server To Server 直连
  • FAQ
    • 集成和认证
    • 常见问题解答
    • ueeshop配置常见错误
    • ApplePay常见问题
  1. Jsapi支付下单接口

Jsapi支付下单接口

全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
POST
/api

Request 参数详细描述#

PayerInfo 付款人信息#

参数必选类型说明
paymentMethodYString目前固定为 wechat_jsapi
sub_appidYString公众号id
sub_openidYString消费者的openid

orderInfo 订单信息#

Text必选类型说明
subjectYString商品标题

Response#

字段描述是否必须
resultCode业务结果(详见 业务结果码)判断交易是否成功的依据 当前交易涉及的有: succeed,pending,failed, closedY
referenceUSEEPAY 订单号N
transactionType支付类型 payY
transactionId商户订单号Y
sign签名Y
echoParam回声参数,响应报文会原样返回N
errorMsg错误码消息描述Y
errorCode错误码(详见 错误码 errorCode)Y
currency3 位 ISO 大写字母货币代码(货币单位)Y
amount订单金额Y
redirectParam微信公众号支付需要的参数Json StringN
signType签名类型Y
{
    "amount": "100",
    "redirectUrl": "",
    "resultCode": "pending",
    "sign": "aPkk1Y735aop9iND6byVEACwrhmWHNIRP9Hd/a36wE9g9iYMB2jXklU8QzOrOI3fJefeDl3+JcAE\nUcJXDKI8fjYUGtlA/8VhJuOmyN1xoOWSwgDr1YAGK2B+beOeFTPuWXtSsqnCoO6ebhk1soBVeT3x\nJHmPS4wSoccGXrn/VAQ=\n",
    "errorCode": "3200",
    "transactionId": "1663122582326",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012209141029011519",
    "redirectMethod": "",
    "echoParam": "echoParam",
    "redirectParam": "{\"timeStamp\":\"1663122586556\",\"package\":\"prepay_id=wx1410294747107604126381be3c62a80000\",\"paySign\":\"qnYD6nuEZc3odQmXeGNvzD6ls65juKBuym6/rH7KClgbOuK9NXCyjC8B300eUEGRNMPlZCuAkiDDSeKj79yn2Vs/QXMwwJKlxuybrRHUw0vEb4oYkt2t0p9ugIQUYkbTzznfCcUKFhPS+lkYZXczBRLjGe+644zWRqnuUTy91h3GD250tbfwlybK+7y1hF6yp/JN9e8WsjXmbXu7Ah9NknMQ3aJtDk8GXD0MWPeylLlFfGo5J7DAIVcXmYrlMf6PKr+7vnwyrLZux24jscWayK6kHepfDQgh+PkZpCEp/hW4x8fltvfgecN3Yq22bsNmlweZWACnzleB8Gl/y6fr8A==\",\"appId\":\"wxbd881f2b1b6c426d\",\"signType\":\"RSA\",\"nonceStr\":\"1663122586556\"}",
    "signType": "RSA",
    "currency": "CNY",
    "merchantNo": "500000000007264"
}

redirectParam#

字段描述是否必须
timeStamp时间戳Y
package统一下单接口返回的prepay_id参数值,提交格式如:prepay_id=***Y
paySign微信签名Y
appId公众号名称,由商户传入Y
signType微信签名方式 固定诶RSAY
noceStr随机串Y
{
    "timeStamp": "1663122586556",
    "package": "prepay_id=wx1410294747107604126381be3c62a80000",
    "paySign": "qnYD6nuEZc3odQmXeGNvzD6ls65juKBuym6/rH7KClgbOuK9NXCyjC8B300eUEGRNMPlZCuAkiDDSeKj79yn2Vs/QXMwwJKlxuybrRHUw0vEb4oYkt2t0p9ugIQUYkbTzznfCcUKFhPS+lkYZXczBRLjGe+644zWRqnuUTy91h3GD250tbfwlybK+7y1hF6yp/JN9e8WsjXmbXu7Ah9NknMQ3aJtDk8GXD0MWPeylLlFfGo5J7DAIVcXmYrlMf6PKr+7vnwyrLZux24jscWayK6kHepfDQgh+PkZpCEp/hW4x8fltvfgecN3Yq22bsNmlweZWACnzleB8Gl/y6fr8A==",
    "appId": "wxbd881f2b1b6c426d",
    "signType": "RSA",
    "nonceStr": "1663122586556"
}

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/x-www-form-urlencoded
Body 参数application/x-www-form-urlencoded
transactionType
string 
必需
交易类型 : pay
示例值:
pay
version
string 
必需
目前固定为 1.0 (5)
示例值:
1.0
signType
string 
必需
商户生成签名字符串所使用的签名算法类型,目前支持:RSA/MD5
示例值:
MD5
merchantNo
string 
商户号(16)
必需
示例值:
500000000007362
transactionId
string 
商户订单号(64)
必需
示例值:
202212070142347
transactionExpirationTime
string 
可选
可选 范围1-120
示例值:
120
appId
string 
网站域名(128)
必需
示例值:
www.pay.com
amount
string 
必需
支付金额,单位为对应币种的最小货币单位(详见 ISO 4217)(12)
示例值:
123
currency
string 
必需
3 位 ISO 大写字母货币代码(详见 ISO 4217) 目前仅支持EUR(3)
示例值:
USD
notifyUrl
string 
异步通知(512)
必需
示例值:
https://gatewaytest.useepay.com/gateway-test/notifyV2u0
echoParam
string 
可选
回声参数,响应报文会原样返回(256)
示例值:
echoParam
payerInfo
string 
必需
Json格式的String 付款方信息, 请下方
示例值:
{ "paymentMethod": "wechat_jsapi", "sub_appid": "公众号id" , "sub_openid": "消费者的openid"}
orderInfo
string 
可选
json string, 订单信息, 请参考下方
示例值:
{ "subject": "订单标题"}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://pay-gateway1.uat.useepay.com/api' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'version=1.0' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'merchantNo=500000000007362' \
--data-urlencode 'transactionId=202212070142347' \
--data-urlencode 'transactionExpirationTime=120' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'amount=123' \
--data-urlencode 'currency=USD' \
--data-urlencode 'notifyUrl=https://gatewaytest.useepay.com/gateway-test/notifyV2u0' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'payerInfo={ "paymentMethod": "wechat_jsapi", "sub_appid": "公众号id" , "sub_openid": "消费者的openid"}' \
--data-urlencode 'orderInfo={  "subject": "订单标题"}'

返回响应

🟢200成功
application/json
Body
amount
string 
可选
max=12 交易金额 ISO 4217
redirectUrl
string 
可选
maxlength=512重定向请求的跳转地址
resultCode
enum<string> 
必需
max=32 业务结果(详见 业务结果码)
枚举值:
pendingsucceedfailed
sign
string 
必需
签名值,签名方法请参加《签名指导》章节
errorCode
string 
可选
max=4 错误码(详见 错误码 errorCode)
transactionId
string 
必需
商户订单号 (max 64)
errorMsg
string 
必需
max=256 错误码消息描述
transactionType
string 
必需
reference
string 
必需
redirectMethod
string 
可选
echoParam
string 
可选
maxlength:256 回声参数,Response 中将会原样返回
redirectParam
string 
可选
resultCode=pending 时返回,微信公众号支付需要的参数Json String
signType
string 
签名类型
必需
maxlength:4 签名类型(MD5/RSA)
currency
string 
币种
可选
货币单位
merchantNo
string 
商户号
必需
max=16 商户编号,由USEEPAY 分配
示例
{
  "amount": "100",
  "redirectUrl": "",
  "resultCode": "pending",
  "sign": "aPkk1Y735aop9iND6byVEACwrhmWHNIRP9Hd/a36wE9g9iYMB2jXklU8QzOrOI3fJefeDl3+JcAE\nUcJXDKI8fjYUGtlA/8VhJuOmyN1xoOWSwgDr1YAGK2B+beOeFTPuWXtSsqnCoO6ebhk1soBVeT3x\nJHmPS4wSoccGXrn/VAQ=\n",
  "errorCode": "3200",
  "transactionId": "1663122582326",
  "errorMsg": "Transaction is pending",
  "transactionType": "pay",
  "reference": "1012209141029011519",
  "redirectMethod": "",
  "echoParam": "echoParam",
  "redirectParam": "{\"timeStamp\":\"1663122586556\",\"package\":\"prepay_id=wx1410294747107604126381be3c62a80000\",\"paySign\":\"qnYD6nuEZc3odQmXeGNvzD6ls65juKBuym6/rH7KClgbOuK9NXCyjC8B300eUEGRNMPlZCuAkiDDSeKj79yn2Vs/QXMwwJKlxuybrRHUw0vEb4oYkt2t0p9ugIQUYkbTzznfCcUKFhPS+lkYZXczBRLjGe+644zWRqnuUTy91h3GD250tbfwlybK+7y1hF6yp/JN9e8WsjXmbXu7Ah9NknMQ3aJtDk8GXD0MWPeylLlFfGo5J7DAIVcXmYrlMf6PKr+7vnwyrLZux24jscWayK6kHepfDQgh+PkZpCEp/hW4x8fltvfgecN3Yq22bsNmlweZWACnzleB8Gl/y6fr8A==\",\"appId\":\"wxbd881f2b1b6c426d\",\"signType\":\"RSA\",\"nonceStr\":\"1663122586556\"}",
  "signType": "RSA",
  "currency": "CNY",
  "merchantNo": "500000000007264"
}
上一页
微信公众号支付
下一页
H5支付
Built with