下单接口 支持 https

接入方式: POST (Content-Type: application/json)

接入测试URL: http://buy.fudoupay.com/payment/ua/order/placeOrder

安卓测试包下载:下载

 

接入正式URL: http://order.fudoupay.com/payment/ua/order/placeOrder

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由平台分配
reqNo 商户订单号 商户订单号,需唯一(只允许数字、字母、中划线、下划线的组合)
amount 金额 保留两位小数,例如 金额60元 为 60.00
asyncUrl 异步回调地址 异步通知的请求地址
syncUrl 同步回调地址 同步通知的请求地址
timeStamp 请求时间 时间戳
attach 商户附加信息 通知过程中会原样返回 ; 若不为空,需参与签名
apiVersion 版本号 固定值:1
sign 签名 采用 MD5 + RSA 组合签名

示例参数

{
"amount":"300.00",
"apiVersion":"1",
"asyncUrl":"https://www.baidu.com/",
"attach":"2022",
"merchno":"4b284a5186",
"reqNo":"202208111731",
"sign":"I9YCtgeF6FgrFbef/Bn1p8rVMcPwXxsCjOk6rNZ+rI+NHdhtqmu/ZQjNUApMc9dKy8ems7Z67Llvb4WtDPFnOIpWg7athDstzm6h4/DQLFMRaUR/hIt+1cfhmE/EBGMul/QzOIHk82UrVeKR4PSeCi9HAl+1fnB4FucXljz61jyyKRMRUhB3aB6ejYCYAA6r4MXaRZHSnBXfteVEnTMkd/l338cYHh3bon01h511DAF3ToPoN0zoSa9x7AlbCDRo4OlKEyGDU0JIUiSERlBZ1fRy9xxiICqFG0qJX8gHsoJYsLtxyoDCqzxtp+D4XzUccF6dBVUUIXWONWVA/qTQIw==",
"syncUrl":"https://www.baidu.com/",
"timeStamp":1660272210836
}
响应参数 响应格式为 json
参数 参数名 必填 签名 说明
code 响应码 详见响应码说明
msg 响应消息
id 平台订单号
payUrl H5支付地址
payUrlBase64 支付二维码图片base64字符串(用于扫码支付)
downloadUrl 下载福豆链接
openText 打开福豆app按钮显示文本
downloadText 下载福豆app按钮显示文本
wakePayUrl 唤醒福豆app支付URL(极端情况唤醒失败可以使用payUrl字段)

返回参数

{
"code":0,
"msg":"成功",
"id":"1660272285709",
"payUrl":"http://buy.fudoupay.com/ua/order/pay?token=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJvcmRlck5vIiwianRpIjoiMTY2MDI3MjI4NTcwOSIsImlhdCI6MTY2MDI3MjI4NSwiZXhwIjoxNjYwMjcyODg1fQ.WkAHb46wCKn8aUSHMEkIWweN5tlWUlffgvoLYafMazc"
"wakePayUrl":"fudou:\/\/qianbao?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25vIjoiMzk2Mzk0MTE2NiIsInJlYWxfbmFtZSI6IuWRg-WRgyIsIm9yZGVyX2lkIjoiMzk2Mzk0MTE2NjIwMjUwMjE3MjAwNTQ0NDY2OTY1IiwiYW1vdW50IjoxMDAsImV4cCI6MTczOTc5NDMwNCwiaXNzIjoiOTg4In0.cnhrDsMFQkXKB5eNPRl7o0qcOlN-6Szqr9wsz2TSCQo"
}
响应码说明
  • 0 : 成功

  • 500 : 系统错误

  • 550 : 参数不能为空

  • 551 : 无效参数

  • 552 : 非法参数

  • 553 : 不支持的参数

  • 560 : 不存在的商户

  • 561 : 商户已禁用

  • 562 : 尚未初始化商户公钥

  • 563 : ip受限

  • 564 : 签名错误

  • 565 : 订单号重复

  • 566 : 金额小于最低限制

  • 567 : 金额大于最高限制

  • 568 : 交易类型不支持

  • 569 : 通道维护

  • 570 : 余额不足

  • 571 : 尚未初始化平台公钥,请联系平台

  • 572 : 尚未初始化平台私钥,请联系平台

  • 573 : api下发已禁用

  • 580 : 不存在的订单

下单异步回调接口

接入方式: POST (Content-Type: application/json)

接入URL: 根据下单参数 asyncUrl 的地址回调

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
reqNo 商户订单号 下单时商户的订单号
amount 金额 保留两位小数
attach 备注 下单中attach值原样返回 ; 若不为空,需参与签名
status 订单状态 详见订单状态说明
timeStamp 时间戳 时间戳
apiVersion 版本号 与下单时的版本号一致
sign 签名 采用MD5 + RSA 签名
响应协议参数
商户系统收到异步通知后,需返回 success (小写)
若返回结果 非 success ,会重复多次发送支付结果
订单状态
  • 未支付: 0

  • 支付成功: 1

示例参数

{
"merchno":"4b284a5186",
"reqNo":"202208111731",
"amount":"300.00",
"attach":"2022",
"timeStamp":"1660272928005",
"status":"1",
"apiVersion":"1",
"sign":"Ow+vSFgEByYRjIAK/MhHx7RTdMjvmQqemUWA6bQaw4TOCdmglF+uJkTOYr47r5xyjeHkuL5bXP3ijW8hP2wWI4k/Ry2W1JrEgbAetTIChuq8TD3LSzjXU6da3BCsepNPS+SBCSmw5uFE4JxYgsFr1A5A3oargmKziJhrdkvYQEp7tWX4XDMgHIpy/XL3gH0Eg6fT9ko8kC0ldPS1vt+r1Qf18nSS5hz85KQ5hbBrxidicGvjkjVRqwcwHZoz4OOZAKqENbw5UzEobFhfaH9WOm8L4eovT3hyrB4+3OY67U7cL67NUVBuOJR9qezvfMi3cC83W05dytdSAjbCRVccmg=="
}

下单查询接口 支持 https

接入方式: POST (Content-Type: application/json)

接入URL: http://buy.fudoupay.com/payment/ua/order/queryOrder

接入正式URL: http://order.fudoupay.com/payment/ua/order/queryOrder

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
reqNo 商户订单号 商户系统订单号
timeStamp 请求时间戳 时间戳
apiVersion 接口版本号 固定值: 1
sign 签名 采用 MD5 + RSA 签名
响应协议参数
参数 参数名 必填 签名 说明
id 平台订单号 平台订单号
merchno 商户号 商户号,由商户系统分配
reqNo 商户订单号 商户订单号
amount 订单金额 保留2位小数
attach 备注信息 下单中attach值原样返回
status 订单状态 订单状态

示例参数

{
"apiVersion" : "1",
"merchno" : "4b284a5186",
"reqNo" : "202208111731",
"sign" : "XMpENcC2hEqFP6jU2eIQWYjX4rah8mW72Tkn5wv8MKqB/mVUxc6PmAD5I8k+0SmSVGiNw0VmY8lcxim/yJQX77NOi0kZGyFa3ePLAljQDUB9BXsmQIwZuxod2qUXiMcIrLcplioiBD4eexBDgNxN8AYHtO/ib+3CpoYwb4Sm7GXDZqsBCpTkKJ58/3xjmS63BNe8jznIw5SV+ASCS+24BP7RB7cVyppWthkhRS9zsLiu2hYYy7E8lVCxN3FGP87GGKNi2O1he//FBe52RLfaCLxm9VK4cVZQ8puTRoKwTX+X3Iq1kub6NHhYAEfAAFtunslfUfJlRLnb7kXLTjJ2nw==",
"timeStamp" : 1660274078605
}

响应参数

{
"code":0,
"msg":"成功",
"id":"1660272285709",
"merchno":"4b284a5186",
"reqNo":"202208111731",
"amount":"300.00",
"attach":"2022",
"status":1
}
订单状态
  • 未支付: 0

  • 支付成功: 1

余额查询接口 支持 https

接入方式: POST (Content-Type: application/json)

接入URL: http://buy.fudoupay.com/payment/ua/fund/queryFund

接入正式URL: http://order.fudoupay.com/payment/ua/fund/queryFund

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
timeStamp 时间戳 时间戳
apiVersion 接口版本号 固定值: 1
sign 签名 采用 MD5 + RSA 签名
响应协议参数
参数 参数名 必填 签名 说明
code 状态码 详见状态码
msg 状态描述 状态描述
merchno 商户号 商户号,由商户系统分配
totalAmount 余额 总金额
lockedAmount 锁定金额 被锁定的金额
availableAmount 可用金额 可用金额

示例参数

{
  "apiVersion": "1",
  "merchno": "4b284a5186",
  "sign": "ao4R09Bpr9wvvS/GHnUtvm7ARiKlXDlyQkQhcY//4Ysj7yAHq64v7VQnnlEM3tSBJIJrZkjSBW5v4l4ZtfMbljK2BeEHhxzG7Mhjab+qGdSACzoUEYNYIROhpeW1w5eM2b7zoRlI5OSxz1ZXa6WvjCR/QLxC1ggVdK8hhaT+oqiklarkcSGAKaepffe1rTutO/glbT1Tn8k6H0SwFdocdGzHm6CKv7YNnM2HLByr+cPlK8GV+d1uPrC3ft4vLnxM5voF/xmxu/2QjKQSTaKZBkio8Vbi6hCBFrTekgI93MkO3Dcc2kbi+WO6VDcA9mKFPw4oHNiOu/Etmx7UaDqTdg==",
  "timeStamp": 1660274863217
}

响应参数

{
  "code": 0,
  "msg": "成功",
  "merchno": "4b284a5186",
  "totalAmount": 1235.56,
  "lockedAmount": 1,
  "availableAmount": 1234.56
}
状态码说明
  • 0 : 成功

  • 500 : 系统错误

  • 550 : 参数不能为空

  • 551 : 无效参数

  • 552 : 非法参数

  • 553 : 不支持的参数

  • 560 : 不存在的商户

  • 561 : 商户已禁用

  • 562 : 尚未初始化商户公钥

  • 563 : ip受限

  • 564 : 签名错误

  • 565 : 订单号重复

  • 566 : 金额小于最低限制

  • 567 : 金额大于最高限制

  • 568 : 交易类型不支持

  • 569 : 通道维护

  • 570 : 余额不足

  • 571 : 尚未初始化平台公钥,请联系平台

  • 572 : 尚未初始化平台私钥,请联系平台

  • 573 : api下发已禁用

  • 580 : 不存在的订单

取款下单接口 支持 https

接入方式: POST (Content-Type: application/json)

接入URL: http://buy.fudoupay.com/payment/ua/withdraw/placeWithdraw

接入URL: http://order.fudoupay.com/payment/ua/withdraw/placeWithdraw

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由平台分配
reqNo 商户订单号 商户订单号,需唯一(只允许数字、字母、中划线、下划线的组合)
amount 金额 保留两位小数,例如 500元 为 500.00
toAddr 收款钱包地址
asyncUrl 异步通知地址 异步通知地址
timeStamp 时间戳 时间戳
attach 商户附加信息 通知过程中会原样返回 ; 若不为空,需参与签名
apiVersion 接口版本号 固定值: 1
sign 签名 采用 MD5 + RSA 加密
响应协议参数 响应格式为 json
参数 参数名 必填 签名 说明
code 状态码 详见响应状态码
msg 状态描述 状态描述
id 平台订单号 平台订单号
status 订单状态 订单状态
响应样例
{
  "code": 0,
  "msg": "成功",
  "id": "1660275365952",
  "status": 3
}
响应码说明
  • 0 : 成功

  • 500 : 系统错误

  • 550 : 参数不能为空

  • 551 : 无效参数

  • 552 : 非法参数

  • 553 : 不支持的参数

  • 560 : 不存在的商户

  • 561 : 商户已禁用

  • 562 : 尚未初始化商户公钥

  • 563 : ip受限

  • 564 : 签名错误

  • 565 : 订单号重复

  • 566 : 金额小于最低限制

  • 567 : 金额大于最高限制

  • 568 : 交易类型不支持

  • 569 : 通道维护

  • 570 : 余额不足

  • 571 : 尚未初始化平台公钥,请联系平台

  • 572 : 尚未初始化平台私钥,请联系平台

  • 573 : api下发已禁用

  • 580 : 不存在的订单

订单状态
  • 已受理: 1

  • 已审核: 2

  • 成功: 3

  • 失败: -1

取款异步通知接口

接入方式: POST (Content-Type: application/json)

接入URL: 下单参数的asyncUrl值

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
reqNo 商户提现单号 商户提现单号
amount 金额 保留两位小数
toAddr 收款钱包地址 收款钱包地址
attach 备注 通知过程中会原样返回 ; 若不为空,需参与签名
status 订单状态 订单状态
timeStamp 时间戳 时间戳
apiVersion 接口版本号 接口版本号
sign 签名 采用 MD5 + RSA 验签
响应协议参数
商户系统收到异步通知后,需返回 success (小写)
若返回结果 非 success ,会重复多次发送支付结果
订单状态
  • 已受理: 1

  • 已审核: 2

  • 成功: 3

  • 失败: -1

取款查询接口 支持 https

接入方式: POST (Content-Type: application/json)

接入URL: http://buy.fudoupay.com/payment/ua/withdraw/queryWithdraw

接入URL: http://order.fudoupay.com/payment/ua/withdraw/queryWithdraw

参数信息
参数 参数名 必填 签名 说明
merchno 商户号 商户号,由商户系统分配
reqNo 商户订单号 商户系统订单号
timeStamp 时间戳 时间戳
apiVersion 接口版本号 固定值: 1
sign 签名 采用 MD5 + RSA 签名
响应协议参数 响应格式为json
参数 参数名 必填 签名 说明
code 响应码 详见响应码
msg 状态描述 状态描述
merchno 商户号 商户号,由商户系统分配
id 平台订单号 平台订单号(下单失败,则为空)
reqNo 商户订单号 商户订单号
amount 订单金额 保留两位小数
toAddr 钱包地址 收款钱包地址
attach 备注 下单中attach值原样返回
status 订单状态 订单状态
响应样例
{
  "code": 0,
  "msg": "成功",
  "id": "1660275365952",
  "merchno": "4b284a5186",
  "reqNo": "4b284a5186",
  "amount": "50.00",
  "toAddr": "umknjjnkiikjjjssssoko",
  "attach": "取款",
  "status": 3
}
订单状态
  • 已受理: 1

  • 已审核: 2

  • 成功: 3

  • 失败: -1

响应码说明
  • 0 : 成功

  • 500 : 系统错误

  • 550 : 参数不能为空

  • 551 : 无效参数

  • 552 : 非法参数

  • 553 : 不支持的参数

  • 560 : 不存在的商户

  • 561 : 商户已禁用

  • 562 : 尚未初始化商户公钥

  • 563 : ip受限

  • 564 : 签名错误

  • 565 : 订单号重复

  • 566 : 金额小于最低限制

  • 567 : 金额大于最高限制

  • 568 : 交易类型不支持

  • 569 : 通道维护

  • 570 : 余额不足

  • 571 : 尚未初始化平台公钥,请联系平台

  • 572 : 尚未初始化平台私钥,请联系平台

  • 573 : api下发已禁用

  • 580 : 不存在的订单

签名说明(MD5+RSA)

  • MD5 加密
    1. 参数列表中,除去sign外,其他所有非空的参数都要参与签名,值为空的参数不用参与签名。
    2. 签名顺序按照参数名的字典顺序排序,若遇到相同的首字母,则看第二个字母,以此类推
    3. 将第2步组装成的字符串末尾添加 &secretKey=商户密钥
    4. 组成规则如下:

      参数名1=参数值1 & 参数名2=参数值2 …… 参数名n=参数值n & secretKey=商户密钥

    5. 所有参与签名的参数值均不进行urlencode编码,都是使用原始值进行签名
    6. secretKey为商户密钥,可"联系客服或开户人员"获取秘钥
    7. MD5加密后需转换为小写
    8. MD5前的字符串1234567890abcdefghijklmnopqrstuvwxyz
      MD5加密后为928f7bcdcd08869cc44c1bf24e7abec6
  • RSA2 加密(温馨提示:1、商户下单过程使用商户公钥和商户私钥,商户自行生成商户公钥和商户私钥,商户公钥需要配置到三方后台。 2、回调过程是使用了平台公钥和平台私钥,商户需要从三方后台获取平台公钥配置商户系统后台)
    1. 对生成的 md5字符串 进行RSA2加密
    2. 举例:

      MD5 字符串: 928f7bcdcd08869cc44c1bf24e7abec6

      商户私钥: MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCRJ+CuJ3lUEo4Y2/KqhDo3aNeRIUak4/Sb9G/YQweR0Mh6EtfqYyA4XgC2EsnkLvchmxPHbLbtueo34bthpN3Md6TwZnV/6noiS62iggu3lSoCszV4zgPTGS3ZAfdRZXxORYHTTpcUSce2IgpkSLdbhCS8siAfUeEtYdJd4KQ3qA4j9OVIuAdSzDrR7lSJHkwGkuvYHnaSfImdtyHp8c8nim8fWTHfCHOPAXHJtuRg5i7Ao5Ue5/HZx6Aqp+b6IDyZq+GiD9/4bwQxlWFGsAlYPR3Ga7nRTAvM7wU1S9yw1iNWdUH5pqXxKll7mttLRMONpmIiKKaPLfPACONQ0dmxAgMBAAECggEAetqxgzTNr6Z0tf2SiVeYnkUSDjeHvw9gfI6KCxPQWE3JH+jK7govvwVwvKlyTrqhV8QVHXiZ6uKrpdhb6+zJ/MBWzVEqqbUe4eADecNvf1W0VMywuSpEemqZL05GsJGgf+68Tsf5fqZjbXeqK+6PodlZ7oskPN3kI7Djh6kV1DQV8wnXKy01lHOxU81zFNL2k81dZa5RfZGfrtiR7zPWrFLq0Rr22TkDWtkDV5qJ8QSTI2lOyOpOt8fNWDwuVuyxEtC8EKua4PGMRUs/Cd0mENpqu7+avO3k0T5rAQmoYGSzAacnjEdASSem21jO6ycrug7NOm+QIuCYmB7r049bQQKBgQDKTz6SBHTFnE5exSnMDae1QTHVCj8ANUn/vOdG8jrXcqpWT+NZ/ekPW+0cD8oZ1BGtfAoCz2dF8Af7kdtVr8+0qaAhaXzmWD49OptIhfEY9iR/cTLsOZH4S/7NyDMJ55Ff304TeE/xiG3/HfiWOgE2fihgh5ZskF93WBbJmVfUdQKBgQC3raZFut+eYUA6bOG+ZYpdETx07Fp9rNe5AdZxPfN0uW2Mvvdijup/aW1c1LjHeBrqM23TufZ0e7V3OCXxvDSeKsff5MyYIVLstF8dQJaL4+TWR0qbSKL5KeXXGUMXv1TiAfhzen7DP/4OVEHWSFeWI0CbozBaN5brpjebUhLYzQKBgCWLIy9xyEHLyfdoW2NUvWSzno3MgviE6yCca8cMuMK2ssmltalDp3aENrJYc8brRgSN2kW/O4kNDE4xOSTjpYX/XIoWy2jrw1EViS+iO6XIN+m2lh6kaGRNphGGL4KNCLtj81dFooBOMyt+4lzukr8MFm4je1TWTgEVxdTPsi7pAoGAJeUUpdQ9KH7l8mfeVxq55iOVNoZA0Sbkxs2jQW/Hl7Bd8qi/fzz/ElRc9McKbFTSMLl1kjYOq8+OC8+wvGPY8zzeScn5j/VoF1/LM8zMgoX9A1xn/wuIXCGRwsP6fJ7D03EWojSGjJ/aOXiWsK/yKg6R2MpdQm+vmmSLmmbfbo0CgYAtECmCePlkxwQ3tNvR63n6ncfOTsIKpK4WyWjXvBKuvUG18YLJBmOrR/YpmTLAa+BCL30AlOojBzJ8CXmIlT94vZHZf70Wwwp/90BwRVt68vkhHkoIoYMnSmNeEjO+z9ACSLqMYj/XJoeBy8CzXkLGlP3EnhMM/jwhqo+Vc4MyHQ==

      加密后的字符串: O1K1P8o/kEyVPcIYkctaAvm8orwUZqVA1vwz0lKhJ0jv6IoeBt7XQenEBfci3FVLjHXMJHem1+cLkfiJjV/gn/C9nJf8BudB/LDi5qh1KG2T4B+1RQEIe8D4wR30l2GrW8TDySGVJ69HxBfSNHooOowHiCe9s7lHGBD93jmC44koXvLS6Lgbz2i12T4vrQEhc4TyuvrRX7QsiEKhA6IROePs+CpYaIsfjjxsdsQNr4Ye8gb7pXFomP41Nd1x9w64p8OmvB818TsLjq8RcJg1pKHUVoCUggljNEy4Ak8kQXxEQlgzGOjC9V0/uBvuqlsDkIegLljEMDVBp+i7TzcpuA==

  • RSA 验签: 验签参数 MD5字符串 、加密串、平台公钥
    1. 加密串: Ow+vSFgEByYRjIAK/MhHx7RTdMjvmQqemUWA6bQaw4TOCdmglF+uJkTOYr47r5xyjeHkuL5bXP3ijW8hP2wWI4k/Ry2W1JrEgbAetTIChuq8TD3LSzjXU6da3BCsepNPS+SBCSmw5uFE4JxYgsFr1A5A3oargmKziJhrdkvYQEp7tWX4XDMgHIpy/XL3gH0Eg6fT9ko8kC0ldPS1vt+r1Qf18nSS5hz85KQ5hbBrxidicGvjkjVRqwcwHZoz4OOZAKqENbw5UzEobFhfaH9WOm8L4eovT3hyrB4+3OY67U7cL67NUVBuOJR9qezvfMi3cC83W05dytdSAjbCRVccmg==

    2. MD字符串:f2cf1a59c5531041d1d3f8029546bc19

    3. 平台公钥: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnJjApJ0oCzRA/fYj9GDZSuY9vIO9gThIGS01KocIZA+lo+m/kSUWK2D4Tb+BL48Pp1EgEcAmAr0zphUD/Ajb7T/YEITjiOrxlnWto2fwVMvTX7vu4MgNG2qtcfds5SQxJNn9bPk0Zt6/4oKZE9K7JUSpNhw5+lOs++orEdH+nGXB1L0GB5p8LUBKB9VGbYtB9LiGTdnll1hwnN4Rf5JsL4D5O51CYVaXcpHllleVfmp8LycP3i4xpqa8uHBEHswh3tAK6+husAX95F0SEqMMcUF+5cHKukVvW8shCs8g9v3w+OUx2fbS2LZbZqGutBNxqcnkJdQBQt69lkw9qLdgrQIDAQAB