优惠券/返现API – 简体中文

(通用)查看预算情况

该API用于查看目前设置的所有合同的优惠券预算情况。用于优惠券的预算是根据合同条件按月设置的，因此可按照合同及月份查看。路径 GET /v2/providers/fms/apis/api/v1/vendors/{vendorId}/budgets 示例 https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1/vendors/... 查看更多

(通用) 查看单份优惠卷合同

该API用于查看所设置的单份合同。路径 GET /v2/providers/fms/apis/api/v2/vendors/{vendorId}/contract 示例 https://api-gateway.coupang.com/v2/providers/fms/apis/api/v2/vendors/A00012345/contract?contractId=9962 请求参数 ... 查看更多

(通用) 查看合同列表

该API用于查看所有当前设置的合同列表，自由合同（NON_CONTRACT_BASED）和一般合同（CONTRACT_BASED）类型的合约都可以查看。路径 GET /v2/providers/fms/apis/api/v2/vendors/{vendorId}/contract/list 示例 https://api-gateway.coupang.com/v2/providers/f... 查看更多

[立减优惠券] 创建

该API用于创建基于合同ID（contractid）的优惠券。因以异步方式，仅执行处理请求，可使用响应的“requestedId” 值，通过确认请求状态API来查看实际API 执行结果值。请在添加产品到立减优惠券的时候谨慎选择产品列表，因为此立减优惠券创建之后卖家就无法对优惠券的产品列表进行删除操作。如果您确实需要删除其中的一些产品，请暂停旧的优惠券，创建新的立减优惠券，并添加新... 查看更多

[立减优惠券] 过期/禁用

该API用于过期/禁用已创建的优惠券。因以异步方式，仅执行处理请求，可使用响应的”requestedId” 值，通过确认请求状态API来查看实际API 执行结果值。在过期/禁用优惠券时，如果该优惠券还有其它未完成请求，则可能导致失败。例如，在创建优惠券后申请添加商品，在完成所有商品添加之前，优惠券的过期/禁用请求将失败。（"success"：输出false）路径 PUT /... 查看更多

[立减优惠券] 确认请求状态

通过requestedId查看立减优惠券API的请求结果。调用优惠券创建，删除，优惠券添加至单品，单品中删除API时，使用响应的requestedId值查看成功/失败(Done/fail)结果。路径 GET /v2/providers/fms/apis/api/v1/vendors/{vendorId}/requested/{requestedId} 示例 https://api-gat... 查看更多

[立减优惠券] 添加产品单品

该API用于将创建的优惠券添加至单件商品。本API是异步的方式，仅执行处理请求。可使用响应的“requestedId”值，通过确认请求状态API来查看实际API 执行结果值。请在添加产品到立减优惠券的时候谨慎选择产品列表，因为此立减优惠券创建之后卖家就无法对优惠券的产品列表进行删除操作。如果您确实需要删除其中的一些产品，请暂停旧的优惠券，创建新的立减优惠券，并添加新的产品列表。 ... 查看更多

[立减优惠券] 查看单个优惠券(couponId)

该API用于查看单个优惠券信息，不可查看其他卖家的优惠券。路径 GET /v2/providers/fms/apis/api/v2/vendors/{vendorId}/coupon 示例 https://api-gateway.coupang.com/v2/providers/fms/apis/api/v2/vendors/A00012345/coupon?couponId=91 请... 查看更多

[立减优惠券] 查看单个优惠券 (couponItemId)

该API用于通过优惠券单品ID查看使用了优惠券的单品。路径 GET /v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items/{couponItemId} 示例 https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1/vendors/... 查看更多

[立减优惠券] 单件优惠券查看(vendorItemId)

该API用于通过vendor item ID查看当前使用了优惠券的商品。路径 GET /v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items/{vendorItemId} 示例 https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1... 查看更多

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

该API用于按照优惠券状态查看创建的优惠券。路径 GET /v2/providers/fms/apis/api/v2/vendors/{vendorId}/coupons 示例 https://api-gateway.coupang.com/v2/providers/fms/apis/api/v2/vendors/A00012345/coupons?status=APPLIED&page... 查看更多

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

该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/... 查看更多

[立减优惠券] 查看优惠产品列表 (status)

该API用于按照优惠券状态查看创建的优惠券中的产品单项。路径 GET /v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items 示例 https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1/vendors/A00012345/coup... 查看更多

[可下载优惠券]创建

创建顾客可以下载并使用的优惠券。若想使用优惠券，商品的总订单金额必须满足卖家设置的金额，否则将无法使用。优惠券可按固定比例/满减折扣的形式发行，同一张优惠券最多可包含 3 种形式。（例：购买10,000韩元减1,000韩元；购买20,000韩元减3,000韩元；购买30,000韩元减3,000韩元等）每个属性ID(vendorite)可以创建一张优惠券，创建后更新到前端至... 查看更多

[可下载优惠券]过期/终止

将优惠券过期（终止）。实际API执行结果可以通过响应的"requestTransactionId"，搜索“满减优惠券请求状态确认API”查看。路径 POST /v2/providers/marketplace_openapi/apis/api/v1/coupons/expire 示例 https://api-gateway.coupang.com/v2/providers/market... 查看更多

[可下载优惠券] 应用到产品单项

该API用于将创建好的满减优惠券用于商品（vendorItemId）上。商品添加优惠券失败时，该优惠券也将被销毁。路径 PUT /v2/providers/marketplace_openapi/apis/api/v1/coupon-items 示例 https://api-gateway.coupang.com/v2/providers/marketplace_openapi/ap... 查看更多

[可下载优惠券] 查看请求结果

使用requestTransactionId确认优惠券单品创建API的请求结果。路径 GET /v2/providers/marketplace_openapi/apis/api/v1/coupons/transactionStatus 示例 https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/... 查看更多

[可下载优惠券]单个优惠券查询（couponId)

使用couponId(创建优惠券时通过Response确认)查询下载优惠券。路径 GET /v2/providers/marketplace_openapi/apis/api/v1/coupons/{couponId} 示例 https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupon... 查看更多

[图书] 使用商品返现

为每个产品单项ID 使用返现规则。它可以应用于使用了相同返现规则的属性，并且只能用于审核通过的属性。 * 返现功能仅适用于图书产品，可与酷澎销售负责人在签订合同并协商好使用政策后使用。每种返现的业务逻辑请参考下表： Value type 说明 value maxAmount Example 计算公式返现金额 FIXED（定额... 查看更多

[图书] 搜索商品返现

查看该产品单项号码上使用的返现规则。搜索到没有返现的属性ID (vendorItemId)时，返回 404 或 400 错误。路径 GET /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/products/items/cashback 示例 https://api-gateway.coupang.com/v2/provid... 查看更多

[图书] 删除商品返现

停止在此产品单项上使用的返现规则。路径 DELETE /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/products/items/cashback 示例 https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/produc... 查看更多

OPENAPI 관련 안내