优惠券转赠 - iPaaS三方执行动作

特殊说明：该接口需保证幂等，执行异常时，上游会进行重试，可使用 outVoucherNo + fromOutOpenId + toOutOpenId 作为幂等键

请求参数

Body 参数application/json

rootKdtId

integer <int64>

有赞店铺总部Id

必需

appId

string

必需

应用厂商标识appId

globalProps

object (Map«Object»)

全局变量

必需

key

object (key)

可选

extendMap

object (Map«Object»)

必需

上下文扩展信息，透传信息key

key

object (key)

可选

fromYzOpenId

string

可选

有赞优惠券持有人 id

fromOutOpenId

string

必需

三方优惠券持有人 id

toYzOpenId

string

可选

有赞优惠券被赠送会员 id

toOutOpenId

string

必需

三方优惠券被赠送会员 id

requestId

string

此次请求唯一标识

必需

outVoucherNo

string

三方优惠券编码

必需

outVoucherId

string

三方优惠券 id

必需

示例

{
    "rootKdtId": 0,
    "appId": "string",
    "globalProps": {
        "key": {}
    },
    "extendMap": {
        "key": {}
    },
    "fromYzOpenId": "string",
    "fromOutOpenId": "string",
    "toYzOpenId": "string",
    "toOutOpenId": "string",
    "requestId": "string",
    "outVoucherNo": "string",
    "outVoucherId": "string"
}

返回响应

🟢200成功

application/json

Body

success

boolean

可选

标识本次调用是否返回

code

integer

可选

本次调用返回code，一般为错误代码

message

string

可选

本次调用返回的消息，一般为错误消息

requestId

string

请求Id

可选

errorData

object (Map«Object»)

调用失败返回的数据

可选

key

object (key)

可选

data

object (VoucherGivingExtResponse)

调用返回的数据

可选

newOutVoucherNo

string

可选

转赠后三方优惠券编码

newOutVoucherId

string

可选

转赠后三方优惠券 id

示例

{
  "success": false,
  "code": 0,
  "message": "",
  "requestId": "",
  "errorData": {
    "": {}
  },
  "data": {
    "newOutVoucherNo": "",
    "newOutVoucherId": ""
  }
}