消费者购物

消费者购物 · 全流程

业务规则与 REST 的「接入指南 · 消费者购物」完全一致，这里按工具讲一遍。x-open-user 在连接上，工具参数里不传用户。

1. 1
   找商品

   lm_search_products 搜索，lm_get_product 看规格并选出 skuId。下单时原样使用返回的 id 与 skuId。

2. 2
   准备收货地址

   下单要行政区划码：用 lm_list_divisions 逐级查到区县码和乡镇码，buyer_add_address 存进地址簿，下单只传 addressId。拿不到地址就用托管结账页，让用户自己填。

3. 3
   下单并交给用户付款

   先 lm_checkout_preview 拿权威价与运费，再 lm_create_payment_link。优先把付款二维码给用户用手机支付宝扫；idempotencyKey 用你的订单号，重试或「再发一次链接」都用同一个，拿到的是同一张收款单。付款成功后平台自动下单。

4. 4
   确认结果

   以 lm_get_payment 为准：fulfilled 即已下单；下单失败平台会自动原路退款。用户说「付好了」不算数。

5. 5
   售后

   先 lm_refund_options 取可退金额与原因，用户确认后再 lm_request_refund；需要退货的回传运单号。 退款有分钟级延迟，进度看 lm_get_payment 的 refundItems。