简体中文

English

简体中文

English

显示模式

关于 退货 ​

访问范围

需要多个访问范围—请参阅每个端点以了解访问范围要求。

需要访问受保护的客户数据。

退款管理是 Genstore 交易系统的重要组成部分，它提供了规范化的退款处理流程和管理能力。通过标准化的退款处理机制，帮助商户高效处理各类退款场景，提升售后服务质量。

核心功能

  • 创建退款：创建退款申请、指定退款金额、设置退款原因和方式
  • 管理退款状态：更新退款状态、跟踪退款进度
  • 查询退款信息：查询退款单详情、查询退款列表、查询订单关联退款

使用场景

  • 售后退款处理：客服团队可快速响应退款申请、跟进退款进度、维护退款记录，确保高效的售后服务体验。
  • 退款风控管理：风控团队可审核异常退款、监控退款趋势、识别欺诈风险，保障交易安全。
  • 财务对账核算：财务团队可统计退款数据、核对退款明细、生成对账报表，实现准确的财务管理。
  • 经营分析决策：运营团队可分析退款原因、评估服务质量、优化商品策略，提升经营效率。

接口

EVENT refunds/create: 退款状态变更

退货业务对象 对象 ​

退货退款业务对象

属性 ​

refundobject
退货信息。
- 收起属性
idnumber
退款单号。
customerIdnumber
客户唯一标识。
customerobject
客户信息。
+ 展开属性
lineItemsarray
退款行。
+ 展开属性
notestring
退款备注。
createTimestring
创建时间。
updateTimestring
更新时间。
refundPricenumber
这是退款的申请金额。
bash
{
  "refund": {
    "lineItems": [
      {
        "line_item": "",
        "line_item_id": "",
        "quantity": "",
        "subtotal": "10.00",
        "id": "",
        "total_tax": "0.00",
        "location_id": ""
      }
    ],
    "note": "Note",
    "createTime": "2013-06-27T08:48:27-04:00",
    "customerId": "1020000013594",
    "updateTime": "2012-08-24T14:01:46-04:00",
    "id": "1000069823694",
    "refundPrice": "10.00",
    "customer": {
      "lastName": "Terry",
      "note": "This is Note.",
      "updatedTime": "2012-08-24T14:01:46-04:00",
      "addresses": "",
      "taxExempt": "",
      "taxExemptions": "",
      "tags": "",
      "firstName": "",
      "phone": "",
      "createdTime": "2013-06-27T08:48:27-04:00",
      "currency": "",
      "id": "",
      "state": "",
      "email": "",
      "verifiedEmail": "",
      "defaultAddress": ""
    }
  }
}

EVENT 退款状态变更 ​

退款消息，主要包括退款处理中、已退款和资金变动消息。

访问范围

需要以下任意访问权限: write_refunds read_refunds

消息

EVENT refunds/create 

消息数据

refundobject
退款对象。
- 收起属性
lineItemsarray
退款行项目列表。
+ 展开属性
orderIdnumber
这是退款的订单编号。
refundPricenumber
这是退款的申请金额。
createTimestring
退款记录创建时间。
updateTimestring
退款记录最后更新时间。
idnumber
这是退款编号。
customerobject
客户信息。
+ 展开属性
notestring
退款备注。
json
{
  "refund": {
    "lineItems": [
      {
        "totalTax": "0.00",
        "quantity": "1",
        "lineItem": {
          "quantity": "1",
          "productId": "12901212",
          "price": "10.00",
          "discountAllocations": [
            {
              "amount": "0.01"
            }
          ],
          "variantId": "12901312",
          "sku": "128G;白色;",
          "currentQuantity": "1",
          "taxLines": [
            {
              "price": "10.00"
            }
          ]
        },
        "subtotal": "1"
      }
    ],
    "note": "Note",
    "orderId": "300141548096383",
    "createTime": "2024-12-31 00:00:00",
    "updateTime": "2024-12-31 00:00:00",
    "id": "10220473645",
    "refundPrice": "10.00",
    "customer": {
      "lastName": "Terry",
      "note": "Note",
      "updatedTime": "2013-06-27T08:48:27-04:00",
      "addresses": "1990 Poplar Ridge Road",
      "taxExempt": "true",
      "tags": "[ \"xinsheng\",          \"human\" ]",
      "firstName": "wh",
      "phone": "+16173034750",
      "createdTime": "2012-08-24T14:01:46-04:00",
      "currency": "USD",
      "id": "1",
      "state": "DECLINED",
      "email": "[email protected]",
      "verifiedEmail": "1",
      "defaultAddress": "1990 Poplar Ridge Road"
    }
  }
}