对外接口文档(项目版)
  1. 天猫
对外接口文档(项目版)
  • 对外接口
    • 充值接口
      • 京东/云闪付票券
        • 请求获取京东验证码
        • 校验验证码
      • 天猫
        • 根据手机号码查询用户信息查询
          POST
        • 根据手机号,获取验证码
          POST
      • 统一下单入口
        POST
    • 回调接口
      • 异步回调接口
    • 查询接口
      • 查询订单接口
      • 查询权益订单接口
      • 查询商户余额接口
    • 检查签名
      POST
  1. 天猫

根据手机号码查询用户信息查询

测试中
POST
http://127.0.0.1/api/tmall/userInfoQuery
请注意,天猫购物券和盒马直充支持淘宝账号或手机号充值,天猫超市享淘卡根据淘宝账号充值。
天猫盒马根据手机号充值,如果一个手机号对应一个淘宝账号(根据手机号码查询用户信息查询接口会返回userNum=1),则直接根据手机号充值;
如果一个手机号对应多个淘宝账号(根据手机号码查询用户信息查询接口会返回userNum=2或3...以该手机号实际对应几个账号为准返回),则先调用根据手机号获取验证码接口,再将验证码作为参数调用当前接口查询该手机号下对应的加密的淘宝账号,同时会返回淘宝账号脱敏显示,取用户选择的淘宝账号对应的加密的淘宝ID,再调用天猫直充下单接口下单。
用户选择哪个账号充值,充值时传加密的淘宝账号obsBuyerId。

请求参数

Body 参数application/json
merchantId
string 
商户号
必需
phoneNumber
string 
手机号
必需
smsCode
string 
短信验证码
必需
先调用接口查询,如果返回userNum为1,表示该手机号只对应一个淘宝账号,可以直充根据手机号充值
sign
string 
签名
必需
md5(phoneNumber+smsCode(没有就不传)+merchantId+商户key)
示例
{
    "merchantId": "string",
    "phoneNumber": "string",
    "smsCode": "string",
    "sign": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/api/tmall/userInfoQuery' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantId": "string",
    "phoneNumber": "string",
    "smsCode": "string",
    "sign": "string"
}'

返回响应

🟢200成功
application/json
Body
count
integer 
必需
data
object 
必需
userNum
integer 
必需
userInfos
array [object {4}] 
必需
msg
string 
必需
code
string 
必需
示例
{
    "count": 0,
    "data": {
        "userNum": 2,
        "userInfos": [
            {
                "buyerDisplayNickMask": "d*****4",
                "buyerNickMask": "d*****4",
                "obsBuyerId": "serewdw34rwed",
                "active": true
            },
            {
                "buyerDisplayNickMask": "d*****4",
                "buyerNickMask": "d*****4",
                "obsBuyerId": "serewdw34rwed",
                "active": false
            }
        ]
    },
    "msg": "",
    "code": "0"
}
修改于 2023-11-02 02:41:28
上一页
校验验证码
下一页
根据手机号,获取验证码
Built with