文档中心 > API类目 > 飞猪会员互通API

alitrip.partner.member.point.newexchange (里程兑换接口)

飞猪积分互通业务,商家积分和飞猪里程之间的互换

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
req ExchangeRequestV2 必须 请求对象
  • └ partner_member_id
  • String
  • 可选
  • abc123
  • 商家会员唯一标识
  • └ exchange_type
  • Number
  • 必须
  • 2
  • 兑换类型,1-飞猪里程换商家积分 2-商家积分换飞猪里程
  • └ fliggy_user_name
  • String
  • 可选
  • abc123
  • 飞猪会员唯一标识
  • └ external_transaction_date
  • Date
  • 必须
  • 2020-01-01 00:00:00
  • 商家端兑换事务时间
  • └ exchange_rate
  • String
  • 可选
  • 0.1
  • 兑换比例
  • └ partner_key
  • String
  • 可选
  • abc123
  • 商家标识,该字段特殊场景下使用
  • └ external_transaction_id
  • String
  • 必须
  • abc123
  • 商家端兑换事务ID
  • └ given_name_zh
  • String
  • 可选
  • 小明
  • 中文名
  • └ family_name_en
  • String
  • 可选
  • WANG
  • 英文姓
  • └ fliggy_user_nick
  • String
  • 可选
  • tbtest
  • 淘宝账号
  • └ family_name_zh
  • String
  • 可选
  • 中文姓
  • └ fliggy_point
  • Number
  • 必须
  • 10
  • 飞猪里程
  • └ given_name_en
  • String
  • 可选
  • XIAOMING
  • 英文名
  • └ point_type
  • String
  • 必须
  • base
  • 积分类型
  • └ name
  • String
  • 可选
  • 王小明
  • 姓名
  • └ partner_point
  • Number
  • 可选
  • 100
  • 商家积分
  • └ remarks
  • String
  • 可选
  • 来自XXX的兑换请求
  • 请求备注信息
  • └ extension
  • String
  • 可选
  • {"xxx":1}
  • 扩展字段,json格式

响应参数

名称 类型 示例值 描述
result FfaResult 结果对象
  • data
  • ExchangeTopResponseV2
  • 数据对象
  • └ status
  • String
  • SUCCESS
  • 兑换单状态
  • └ external_transaction_id
  • String
  • abc123
  • 外部事务ID
  • └ internal_transaction_id
  • String
  • edf456
  • 内部兑换单事务ID
  • └ msg
  • String
  • 状态信息
  • └ code
  • String
  • 状态码
  • └ success
  • Boolean
  • true
  • 请求是否成功
  • └ error_code
  • String
  • 错误码
  • └ error_msg
  • String
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripPartnerMemberPointNewexchangeRequest req = new AlitripPartnerMemberPointNewexchangeRequest();
AlitripPartnerMemberPointNewexchangeRequest.ExchangeRequestV2 obj1 = new AlitripPartnerMemberPointNewexchangeRequest.ExchangeRequestV2();
obj1.setPartnerMemberId("abc123");
obj1.setExchangeType(2L);
obj1.setFliggyUserName("abc123");
obj1.setExternalTransactionDate(StringUtils.parseDateTime("2020-01-01 00:00:00"));
obj1.setExchangeRate("0.1");
obj1.setPartnerKey("abc123");
obj1.setExternalTransactionId("abc123");
obj1.setGivenNameZh("小明");
obj1.setFamilyNameEn("WANG");
obj1.setFliggyUserNick("tbtest");
obj1.setFamilyNameZh("王");
obj1.setFliggyPoint(10L);
obj1.setGivenNameEn("XIAOMING");
obj1.setPointType("base");
obj1.setName("王小明");
obj1.setPartnerPoint(100L);
obj1.setRemarks("来自XXX的兑换请求");
obj1.setExtension("{\"xxx\":1}");
req.setReq(obj1);
AlitripPartnerMemberPointNewexchangeResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_partner_member_point_newexchange_response>
    <result>
        <data>
            <status>SUCCESS</status>
            <external_transaction_id>abc123</external_transaction_id>
            <internal_transaction_id>edf456</internal_transaction_id>
            <msg></msg>
            <code></code>
        </data>
        <success>true</success>
        <error_code></error_code>
        <error_msg></error_msg>
    </result>
</alitrip_partner_member_point_newexchange_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部