USEEPAY
  1. direct
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模式
                  POST
              • redirect
                • 扫码支付收银台模式(wechat_native)
            • Jsapi支付下单接口
              • 小程序支付
              • 微信公众号支付
              • Jsapi支付下单接口
            • 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. direct

扫码支付 Server To Server模式

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

时序图#

请求参数对象说明#

payerInfo
参数类型说明是否必填
paymentMethodstring固定值 wechat_nativeY
authorizationMethodstring固定值 cvvY
billingAddressstring(string)账单地址N
orderInfo
参数类型说明是否必填
subjectString(128)订单标题,可以是商品名称。这个最终会提现在微信支付账单中Y
goodsInfostring(json array)商品详细新下N
shippingAddressstring(json)账单地址N
userInfo
userInfo

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/x-www-form-urlencoded
Body 参数application/x-www-form-urlencoded
amount
string 
必需
订单金额, 必须大于0. 参考金额和货币单位
示例值:
123
appId
string 
网站域名(128)
必需
示例值:
www.pay.com
currency
string 
必需
币种: 3 位 ISO 金额和货币单位
示例值:
USD
echoParam
string 
可选
回声参数,响应报文会原样返回(256)
示例值:
echoParam
merchantNo
string 
必需
商户号: (max=16)
示例值:
500000000007362
notifyUrl
string 
必需
异步通知地址(max=512)
示例值:
https://gatewaytest.useepay.com/gateway-test/notifyV2u0
orderInfo
string 
可选
json string, 订单信息, 请参考下方
示例值:
{\"shippingAddress\":{\"email\":\"amber.lei@useepay.com\",\"phoneNo\":\"123\",\"firstName\":\"amber\",\"lastName\":\"lei\",\"street\":\"118 trenton drive\",\"postalCode\":\"37830\",\"city\":\"city\",\"state\":\"Tennessee\",\"country\":\"US\"},\"subject\":\"订单标题\",\"goodsInfo\":[{\"id\":\"商品编号\",\"name\":\"商品名称\",\"body\":\"商品描述\",\"category\":\"商品类目\",\"categoryTree\":\"商品类目树,不同级别类目使用”|”分割\",\"brand\":\"商品品牌\",\"quantity\":1,\"price\":1234,\"url\":\"商品url\",\"sku\":\"商品sku\",\"image\":\"商品图片url\"}]}
payerInfo
string 
必需
Json格式的String 付款方信息, 请下方
示例值:
{\"paymentMethod\":\"wechat_native\",\"authorizationMethod\":\"cvv\",\"firstName\":\"amber\",\"lastName\":\"lei\",\"billingAddress\":{\"houseNo\":\"El Gallo Giro(https://gallogiro.com/)\",\"email\":\"amber.lei@useepay.com\",\"phoneNo\":\"1235854433\",\"firstName\":\"amber\",\"lastName\":\"Yang\",\"stlogreet\":\"7148 Pacific Blvd, Huntington Park, CA\",\"postalCode\":\"90225\",\"city\":\"Huntington Park\",\"state\":\"CA\",\"country\":\"MX\",\"street\":\"street\"}}
redirectUrl
string 
可选
同步通知地址(max=512)
示例值:
http://192.168.1.56:8003/redirectV2u0
signType
string 
必需
签名类型: MD5/RSA
示例值:
MD5
transactionExpirationTime
string 
可选
过期时间: 单位分钟 1-120
示例值:
120
transactionId
string 
必需
商户订单号: max(64)
示例值:
202212070142347
transactionType
string 
必需
交易类型 : pay
示例值:
pay
userInfo
string 
必需
json string, 消费者信息, 请参考消费者信息
示例值:
{\"ip\":\"127.0.0.1\",\"email\":\"amber.lei@useepay.com\"}
sign
string 
签名
必需
示例值:
6c17d0a6131a35229e8c05b8cff2aae1
version
string 
必需
目前固定为 1.0 (5)
示例值:
1.0

示例代码

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 'amount=123' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'currency=USD' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'merchantNo=500000000007362' \
--data-urlencode 'notifyUrl=https://gatewaytest.useepay.com/gateway-test/notifyV2u0' \
--data-urlencode 'orderInfo={\"shippingAddress\":{\"email\":\"amber.lei@useepay.com\",\"phoneNo\":\"123\",\"firstName\":\"amber\",\"lastName\":\"lei\",\"street\":\"118 trenton drive\",\"postalCode\":\"37830\",\"city\":\"city\",\"state\":\"Tennessee\",\"country\":\"US\"},\"subject\":\"订单标题\",\"goodsInfo\":[{\"id\":\"商品编号\",\"name\":\"商品名称\",\"body\":\"商品描述\",\"category\":\"商品类目\",\"categoryTree\":\"商品类目树,不同级别类目使用”|”分割\",\"brand\":\"商品品牌\",\"quantity\":1,\"price\":1234,\"url\":\"商品url\",\"sku\":\"商品sku\",\"image\":\"商品图片url\"}]}' \
--data-urlencode 'payerInfo={\"paymentMethod\":\"wechat_native\",\"authorizationMethod\":\"cvv\",\"firstName\":\"amber\",\"lastName\":\"lei\",\"billingAddress\":{\"houseNo\":\"El Gallo Giro(https://gallogiro.com/)\",\"email\":\"amber.lei@useepay.com\",\"phoneNo\":\"1235854433\",\"firstName\":\"amber\",\"lastName\":\"Yang\",\"stlogreet\":\"7148 Pacific Blvd, Huntington Park, CA\",\"postalCode\":\"90225\",\"city\":\"Huntington Park\",\"state\":\"CA\",\"country\":\"MX\",\"street\":\"street\"}}' \
--data-urlencode 'redirectUrl=http://192.168.1.56:8003/redirectV2u0' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'transactionExpirationTime=120' \
--data-urlencode 'transactionId=202212070142347' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'userInfo={\"ip\":\"127.0.0.1\",\"email\":\"amber.lei@useepay.com\"}' \
--data-urlencode 'sign=6c17d0a6131a35229e8c05b8cff2aae1' \
--data-urlencode 'version=1.0'

返回响应

🟢200成功
application/json
Body
codeUrl
string 
二维码链接
可选
需要转成二维码使用, resultCode = pending时返回
amount
string 
订单金额
必需
订单金额, 必须大于0. 参考金额和货币单位
redirectUrl
string 
同步通知地址
可选
异步通知地址 resultCode = pending 适合
resultCode
string 
业务结果码
必需
参考业务结果码
sign
string 
签名值
必需
errorCode
string 
错误码
可选
详见 错误码 errorCode
transactionId
string 
商户订单号
必需
max(64)
errorMsg
string 
错误码信息描述
可选
用于展示给消费者具体的错误信息
transactionType
string 
交易状态
必需
固定 pay
reference
string 
交易流水号
可选
UseePay返回的交易流水号
echoParam
string 
回声参数
可选
同Request参数原样返回 (max=256)
signType
string 
签名类型
必需
currency
string 
币种
必需
merchantNo
string 
商户号
必需
商户号(max=16)
示例
{
  "codeUrl": "weixin://wxpay/bizpayurl?pr=lHmpT1Mzz",
  "amount": "100",
  "redirectUrl": "http://192.168.1.56:8003/redirectV2u0",
  "resultCode": "pending",
  "sign": "5c5b84597a7db7674c108fbe43305dbf",
  "errorCode": "3200",
  "transactionId": "202305260343367",
  "errorMsg": "Transaction is pending",
  "transactionType": "pay",
  "reference": "1012305261543015506",
  "echoParam": "echoParam",
  "signType": "MD5",
  "currency": "USD",
  "merchantNo": "500000000007245"
}
上一页
扫码支付
下一页
扫码支付收银台模式(wechat_native)
Built with