跳到主要内容
版本:202201

Partial 订单 Refund

POST 

/openapi/2022-01/orders/:id/partial_refund

请求

Path参数

    id string必填

    Order's ID

请求体

    is_returnboolean

    Whether to return the fulfillments, for example: true or false

    pricestring

    Refund Amount, for example: 10.00

    line_items object[]

    Refund line items, only the Unfulfilled Order is supported

  • Array [
  • idstring

    Line item ID

    quantityint32

    Quantity for this product

  • ]

响应

200

数据结构
    idstring
    示例: e18d1fc2-df36-4d6e-8e03-f1586d963b5f
    statusstring
    示例: finished
    numberstring
    示例: 00000013-S1
    created_atstring
    示例: 2024-04-22T07:22:51Z
    notestring
    示例:
    refund_fail_reasonstring
    示例:
    all_refundedboolean
    默认值: true
    示例: false
    refund_statusstring
    示例: general
    order object
    idstring
    示例: 633130-00000013
    note
    numberstring
    示例: 00000013
    financial_statusstring
    示例: partially_refunded
    statusstring
    示例: placed
    cancel_reason
    payment_methodstring
    示例: bogus_gateway
    fulfillment_statusstring
    示例: waiting
    discount_codestring
    示例:
    discount_applicationsstring
    示例: []
    customer_notestring
    示例:
    sales_platformstring
    示例: shoplazza
    landing_sitestring
    示例: https://test-shoplazza.stg.myshoplaza.com/checkout/633130-00000001?key=e281e6f81c335487dd91cf3df34a8e
    buyer_accepts_marketingboolean
    默认值: true
    示例: true
    currencystring
    示例: CNY
    total_pricestring
    示例: 242.00
    total_discountstring
    示例: 0.00
    total_taxstring
    示例: 0.00
    total_shippingstring
    示例: 80.00
    sub_totalstring
    示例: 162.00
    code_discount_totalstring
    示例: 0.00
    line_item_discount_totalstring
    示例: 0.00
    tagsstring
    示例:
    created_atstring
    示例: 2024-04-22T07:21:34Z
    updated_atstring
    示例: 2024-04-22T07:22:52Z
    canceled_at
    customer_deleted_at
    deleted_at
    placed_atstring
    示例: 2024-04-22T07:21:48Z
    total_refund_pricestring
    示例: 81.00
    total_refund_taxstring
    示例: 0.00
    total_refund_discountstring
    示例: 0.00
    refund_statusstring
    示例: general
    total_tip_receivedstring
    示例: 0.00
    browser_ipstring
    示例: 183.15.177.205
    sourcestring
    示例: https://test-shoplazza.stg.myshoplaza.com/checkout/633130-00000001?key=e281e6f81c335487dd91cf3df34a8e
    last_landing_urlstring
    示例:
    email_statusstring
    示例: waiting
    recovery_statusstring
    示例: waiting
    total_paidstring
    示例: 242.00
    source_name object
    datastring
    示例:
    created_atstring
    示例:
    last_referrer_show object
    datastring
    示例:
    created_atstring
    示例:
    shipping_line object
    namestring
    示例: test
    customer object
    idstring
    示例: f6de152d-ec40-4734-81e5-62db979da04e
    emailstring
    first_namestring
    示例: zhang
    last_namestring
    示例: senjun
    phonestring
    示例: +8615014471143
    created_atstring
    示例: 2024-04-17T08:43:37Z
    updated_atstring
    示例: 2024-04-22T07:21:39Z
    orders_countinteger
    默认值: 0
    示例: 6
    total_spentstring
    示例: 163.99
    shipping_address object
    first_namestring
    示例: test
    last_namestring
    示例: test
    address1string
    示例: 6 三聖街
    address2string
    示例: 1111
    phonestring
    示例: +8615014471143
    citystring
    示例: 沧州
    zipstring
    示例: 061000
    provincestring
    示例: Hebei
    countrystring
    示例: China mainland
    companystring
    示例:
    latitude
    longitude
    namestring
    示例: test test
    country_codestring
    示例: CN
    province_codestring
    示例: CN-HE
    phone_area_codestring
    示例: CN_86
    emailstring
    areastring
    示例:
    extra_info
    billing_address object
    first_namestring
    示例: test
    last_namestring
    示例: test
    address1string
    示例: 6 三聖街
    address2string
    示例: 1111
    citystring
    示例: 沧州
    zipstring
    示例: 061000
    provincestring
    示例: Hebei
    countrystring
    示例: China mainland
    companystring
    示例:
    latitude
    longitude
    namestring
    示例: test test
    country_codestring
    示例: CN
    province_codestring
    示例: CN-HE
    emailstring
    areastring
    示例:
    phonestring
    示例: +8615014471143
    payment_line object
    payment_channelstring
    示例: bogus
    payment_methodstring
    示例: bogus_gateway
    transaction_nostring
    示例: test_633130-00000013
    merchant_idstring
    示例:
    merchant_emailstring
    示例:
    payment_lines object[]
  • Array [
  • payment_channelstring
    示例: bogus
    payment_methodstring
    示例: bogus_gateway
    transaction_nostring
    示例: test_633130-00000013
    merchant_idstring
    示例:
    merchant_emailstring
    示例:
    paid_totalstring
    示例: 242.00
  • ]
  • line_items object[]
  • Array [
  • idstring
    示例: 31d95f28-baf0-47c9-ad53-dbf3833f1b85
    product_idstring
    示例: a1a88be0-a1d4-47e4-a2f2-ba6e131cf447
    variant_idstring
    示例: cbd7a7b0-5dd7-4902-9466-e21bd02688b4
    variant_titlestring
    示例: L-red-S
    product_titlestring
    示例: shirt
    product_handlestring
    示例: shirt
    quantityinteger
    默认值: 0
    示例: 2
    notestring
    示例:
    fulfillment_statusstring
    示例: waiting
    skustring
    示例: T-M-L-red-S-A001011
    weight_unitstring
    示例: kg
    vendorstring
    示例: shoplazza
    product_urlstring
    示例: /products/shirt
    compare_at_pricestring
    示例: 97.00
    imagestring
    示例: //cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg
    pricestring
    示例: 81.00
    totalstring
    示例: 162.00
    weightstring
    示例: 1.10
    properties object[]
  • Array [
  • namestring
    示例: size
    valuestring
    示例: L
  • ]
  • custom_properties
    refund_quantityinteger
    默认值: 0
    示例: 1
    refund_totalstring
    示例: 81.00
    base_pricestring
    示例: 0.00
    discount_applicationsstring
    示例: []
  • ]
  • fulfillments object[]
  • Array [
  • object
  • ]
  • gift_card_totalstring
    示例: 0.00
    shipping_tax_totalstring
    示例: 0.00
    product_tax_includedboolean
    默认值: true
    示例: true
    refer_infostring
    示例: {"$latest_referrer":"https://myaccount.stg.shoplazza.com/","$latest_referrer_host":"myaccount.stg.shoplazza.com","$latest_search_keyword":"未取到值","$latest_traffic_source_type":"引荐流量","address_check":true,"client_id":"1703040491710183","country":"CN","customer_session":"e198c29a-70bb-4f9d-9d43-b1ab12b557fb","domain":"test-shoplazza.stg.myshoplaza.com","fbc":"","fbp":"fb.1.1701051195560.2038310036","inventory_deduction":"order_created","ip":"183.15.177.205","session_id":"1713767538649476","source":"buy_now","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36"}
    additional_totalstring
    示例: 0.00
    additional_prices object[]
  • Array [
  • object
  • ]
  • logistics_codestring
    示例:
    config object
    page_typestring
    示例: three_step
    requires_shippingboolean
    默认值: true
    示例: true
    checkout_business_typeinteger
    默认值: 0
    示例: 0
    product_tax_includedboolean
    默认值: true
    示例: true
    checkout_template_typeinteger
    默认值: 0
    示例: 0
    market_setting object
    primary_market_langstring
    示例: en-US
    market_langstring
    示例: en-US
    market_idstring
    示例: 370871064999238186
    market_currencystring
    示例: CNY
    market_currency_symbol object
    codestring
    示例: CNY
    valstring
    示例: ¥
    leftstring
    示例: ¥
    rightstring
    示例:
    market_base_idstring
    示例:
    market_base_currencystring
    示例: CNY
    market_base_currency_symbol object
    codestring
    示例: CNY
    valstring
    示例: ¥
    leftstring
    示例: ¥
    rightstring
    示例:
    primary_market_idstring
    示例: 311711862569844266
    primary_market_currencystring
    示例: USD
    primary_market_currency_symbol object
    codestring
    示例: USD
    valstring
    示例: $
    leftstring
    示例: $
    rightstring
    示例:
    market_price_setting object
    local_currency_enabledboolean
    默认值: true
    示例: false
    custom_rate_enabledboolean
    默认值: true
    示例: false
    custom_rateinteger
    默认值: 0
    示例: 0
    ratenumber
    默认值: 0
    示例: 7.239804
    back_ratenumber
    默认值: 0
    示例: 0.138125
    actual_ratenumber
    默认值: 0
    示例: 7.239804
    base_to_localinteger
    默认值: 0
    示例: 0
    local_to_baseinteger
    默认值: 0
    示例: 0
    adjustinteger
    默认值: 0
    示例: 10
    price_round_enabledboolean
    默认值: true
    示例: true
    market_countrystring
    示例: CN
    refund object
    idstring
    示例: 371921398756556394
    order_idstring
    示例: 633130-00000013
    notestring
    示例:
    refund_pricestring
    示例: 81.00
    currencystring
    示例: CNY
    created_atstring
    示例: 2024-04-22T07:22:51Z
    updated_atstring
    示例: 2024-04-22T07:22:51Z
    refund_line_items object[]
  • Array [
  • refund_quantityinteger
    默认值: 0
    示例: 1
    line_item_idstring
    示例: 31d95f28-baf0-47c9-ad53-dbf3833f1b85
    line_item object
    idstring
    示例: 31d95f28-baf0-47c9-ad53-dbf3833f1b85
    product_idstring
    示例: a1a88be0-a1d4-47e4-a2f2-ba6e131cf447
    variant_idstring
    示例: cbd7a7b0-5dd7-4902-9466-e21bd02688b4
    variant_titlestring
    示例: L-red-S
    product_titlestring
    示例: shirt
    product_handlestring
    示例: shirt
    quantityinteger
    默认值: 0
    示例: 2
    notestring
    示例:
    fulfillment_statusstring
    示例: waiting
    skustring
    示例: T-M-L-red-S-A001011
    weight_unitstring
    示例: kg
    vendorstring
    示例: shoplazza
    product_urlstring
    示例: /products/shirt
    compare_at_pricestring
    示例: 97.00
    imagestring
    示例: //cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg
    pricestring
    示例: 81.00
    totalstring
    示例: 162.00
    weightstring
    示例: 1.10
    properties object[]
  • Array [
  • namestring
    示例: size
    valuestring
    示例: L
  • ]
  • custom_properties
    refund_quantityinteger
    默认值: 0
    示例: 1
    refund_totalstring
    示例: 81.00
    base_pricestring
    示例: 0.00
    discount_applicationsstring
    示例:
  • ]