Coupang Developer Center

API支持的买家用户地区：韩国

该API用于按照订单号码状态查看创建的优惠券列表。

路径

GET

/v2/providers/fms/apis/api/v2/vendors/{vendorId}/{orderId}/coupons

示例

https://api-gateway.coupang.com/v2/providers/fms/apis/api/v2/vendors/A00012345/8000000000294/coupons

请求参数

Name					Required	Type	Description
vendorId					O	String	卖家ID 酷澎分配给卖家的固有代码 ex) A00012345
orderId					O	Number	订单号码

请求体

无

返回消息

名称

数据类型

描述

code

Number

服务器响应代码

message

String

服务器响应信息

httpStatus

Number

HTTP状态代码 (与服务器响应代码的值相同)

httpStatusMessage

String

HTTP 状态信息 (与服务器响应信息的值相同)

errorMessage

String

除HTTP Status 200以外，剩下Status 中包含服务器详细失败原因信息。

data

Object

优惠券列表数据

success

Boolean

成功与否

true or false

content

Array

优惠券列表

contractId

Number

卖家合同号码

ex) 1, 2

couponId

Number

优惠券号码

ex) 75, 80

discount

Number

折扣

ex) 100.0, 20.0

endAt

String

有效期结束时间日期/时间

ex) 2017-09-01 00:00:00

maxDiscountPrice

Number

最大优惠金额

ex) 1000, 10000

promotionName

String

促销名称

ex) Dress discount coupon for the 2nd wk of Jan

startAt

String

有效期开始时间日期/时间

ex) 2017-08-04 01:00:00

status

String

优惠券状态

代码	描述
STANDBY	待命
APPLIED	使用中
PAUSED	暂停
EXPIRED	过期/禁用
DETACHED	产品被移除

type

String

折扣类型

ex) RATE (固定比例折扣), FIXED_WITH_QUANTITY (满足订单产品数量的折扣) and PRICE (固定金额折扣)

wowExclusive

Boolean

折扣受众

false (全部买家: 默认)

true (火箭会员用户)

vendorItemId

Number

产品单项号码

ex) 3223826213

Pagination

null

使用订单号码查询没有分页

返回消息示例

{
  "code": 200,
  "message": "OK",
  "httpStatus": 200,
  "httpStatusMessage": "OK",
  "errorMessage": "",
  "data": {
    "success": true,
    "content": [
      {
        "vendorItemId": 5500016112,
        "contractId": 10,
        "promotionName": "99%",
        "couponId": 91,
        "status": "PAUSED",
        "type": "RATE",
        "maxDiscountPrice": 1000000,
        "discount": 99,
        "startAt": "2017-11-22 00:00:00",
        "endAt": "2017-11-23 23:59:00",
        "wowExclusive": "false" 
      },
      {
        "vendorItemId": 53000439458,
        "contractId": 7,
        "promotionName": "자유계약 원피스 폭탄 세일 시즌 1",
        "couponId": 65,
        "status": "PAUSED",
        "type": "RATE",
        "maxDiscountPrice": 1000,
        "discount": 10,
        "startAt": "2017-09-22 00:00:00",
        "endAt": "2017-09-23 23:59:00",
        "wowExclusive": "false" 
      }
    ],
    "pagination": null
  }
}

错误信息

HTTP status code (error type)	Error message	How to resolve
400 (check request parameter)	请确认卖家权限	查看卖家ID（vendorid）值是否输入正确

[立减优惠券] 查看优惠券列表(orderId)

简介

详细内容

路径

示例