商城
  1. 订单 -> 订单
商城
  • 评论
    • productReview
      POST
    • reviewSkuList
      POST
    • reviewLike
      POST
    • reviewTag
      POST
    • orderDetail
      POST
    • 图片或视频上传或其他类型文件上传
      POST
    • 图片
      POST
    • 评论提交
      POST
    • 评论详情
      POST
    • 评论翻译
      POST
  • souring相关
    • 站点->sourcing
      • 商品 -> 图片搜索
        • 阿里云以图搜图
        • 阿里云以图搜图V2
      • sourcing提交
      • sourcing详情
      • sourcing取消
      • sourcing分页查询
      • sourcing商品查询
  • 站点->sourcing
    • 数量查询
      POST
  • 购物车 -> 购物车
    • deteleCartSync
      POST
    • test
      POST
    • test2
      POST
    • 合并购物车
      POST
    • 查询购物车仓库列表
      POST
    • 查询购物车数量
      POST
    • 删除购物车
      POST
    • 更新免邮勾选
      POST
    • 移动到心愿单
      POST
    • 更新购物车
      POST
    • 加购购物车
      POST
    • studio样品加入购物车
      POST
    • 购物车列表查询
      POST
    • 查询spu下所有sku查询在购物车中的数量
      POST
    • 删除原来sku,新增sku
      POST
  • 个人中心->订单管理
    • 订单分页列表
    • 查看订单详情
    • 获取订单中已变成一包多件的商品详情
    • 同步item数据
    • 备货详情
    • Pay now待支付订单信息
    • 查看订单概览
    • 标记等待补货
    • 待支付订单信息
    • 缺货继续支付
    • 支付成功回显订单地址信息
    • 编辑订单地址
    • 订单备注
    • 导出发货清单
    • 从服务器下载已保存的checklist文件
    • 上传支付凭证
    • 获取订单图片zip下载链接
    • studio-获取订单发票信息
  • 产品->详情
    • 查询sku详情(列表页弹框)
    • 设置log
    • 查询sku详情(商品详情)
    • 计算商详sku价格
    • 批量获取商品详情
    • 批量获取供应商产品详情
    • 查询sku活动
    • 查询商品的活动配置折扣信息以及分类活动的code
    • 推荐商品
    • 推荐关键词
    • 图片压缩包
    • 墨西哥免邮商品刷新
    • 商品发货交货时效信息
    • 获取二维码的sku编码,判别二维码是否有效(是否查询的到产品)
    • 获取不同站点对应链接
    • 获取经常购买的商品
    • 遗失物品赔偿
    • 墨西哥商品利益点文案
    • 商品关联博客列表
  • 订单 -> 订单
    • create
      POST
    • google or apple
      POST
    • reorder
      POST
    • reviewToWish
      POST
    • getOrderList
      POST
    • orderAgeing
      POST
    • orderNumberGenerator
      GET
    • 获取订单优惠信息
      GET
  • 站点->支付方式
    • list
    • 根据站点获取paypal的clientId 默认是饰品站
    • 复制站点支付方式
  • 产品搜索->列表
    • 列表分页
    • 图搜商品
    • ERP分页查询
    • 查询类目
    • 根据类目ID查询关键字
    • 获取所有语言的属性名
    • 刷新属性缓存
    • 刷新关键字缓存
    • 用户历史关键词搜索查询
    • 热门关键词和分类搜索
    • 删除用户历史关键词搜索查询
    • 清除缓存关键词
    • 根据spues获取商品列表
    • 新人专享页面数据
    • 新人专享页面数据v2版本
    • 流失客户推广专题页模块
    • 流失客户推广专题页模块
    • 新人专享页面免邮门槛图片v2版本
    • 购买过查询
    • 历史浏览记录
  • 购物车 -> 结算
    • checkout
    • checkoutOptimization
    • prepareCheckout
    • loginCheckout
    • countryProhibition
    • countryProhibitionConfirm
    • ageingInfo
  • 商品详情->激光定制
    • 激光定制模板查询
    • 激光定制提交
    • 激光定制分页查询
    • 激光定制详情
  • 商品定制
    • 定制商品需求提交
    • 定制商品列表
    • 定制商品需求 详情
  • 多买多奖
    • 获取活动信息
  1. 订单 -> 订单

create

POST
/st-cart/order/create

请求参数

Body 参数application/json
orderNumber
string 
可选
prepareUid
string 
可选
useCredit
number 
可选
useCurrencyCredit
number 
可选
shippingAddressId
integer 
可选
billingAddressId
integer 
可选
addressType
integer 
可选
默认值:
0
shippingMethodId
integer 
可选
数据来自 single物流接口,返回的 jewelryShippingId 字段
运输方式ID
paymethodCode
integer 
可选
couponId
integer 
可选
couponCode
string 
可选
currency
string 
可选
默认值:
USD
payLater
integer 
可选
默认值:
0
pciParam
object (PciPaymentParam) 
可选
day
string 
可选
year
string 
可选
month
string 
可选
secureCode
string 
可选
cardNumber
string 
可选
cardData
string 
可选
document
string 
可选
installments
integer 
分期数
可选
installmentsId
string 
分期ID
可选
sessionId
string 
可选
dlocalParam
object (DlocalPaymentParam) 
可选
id
string 
支付方式ID
可选
document
string 
身份证
可选
name
string 
支付名称
可选
flow
string 
流程
可选
type
string 
可选
类型,CARD 时需要输入卡号
cvv
string 
安全码
可选
expireMonth
string 
期限月份,10
可选
expireYear
integer 
期限年,2023
可选
number
string 
卡号
可选
eBanxPaymentParam
object (EBanxPaymentParam) 
可选
id
string 
支付方式ID
可选
year
string 
2024
可选
month
string 
月份08
可选
secureCode
string 
安全码
可选
cardNumber
string 
卡号
可选
googleParam
object (PciGooglePaymentParam) 
可选
token
string 
可选
cartType
string 
可选
appleParam
object (PciApplePaymentParam) 
可选
token
string 
可选
cartType
string 
可选
pingpongDlocalPaymentParam
object (PingpongDlocalPaymentParam) 
可选
Pingpong本地支付参数
document
string 
身份证
可选
paymentKey
string 
本地支付key
可选
parentOrderNumber
string 
可选
如果是补单,前端传下父订单编号
supplementOrderNumber
string 
可选
如果是加单,则,往sales_order_supplement加一条记录
vat
string 
税号
可选
curp
string 
身份证号
可选
taxes
number 
税费
可选
rfc
string 
新税号
可选
isForword
integer 
可选
是否转发,老app创建订单转发需要额外做下处理
默认值:
0
utmInfo
string 
埋点广告参数
可选
referrerName
string 
埋点广告参数
可选
pushExternalBatchId
string 
可选
app push任务ID
referer
string 
订单的广告来源
可选
utmCampaign
string 
可选
type
integer 
可选
paymentErrorCode
integer 
可选
prohibitionConfirm
integer 
可选
默认值:
0
checkoutTime
integer 
可选
forterTokenCookie
string 
可选
userAgent
string 
可选
accOrderNum
integer 
客户第几单
可选
默认值:
0
normalConfirm
integer 
可选
批发计算, 1是 0否
默认值:
0
sessionId
string 
可选
sensorsPublicParam
object (SensorsPublicParam) 
神策埋点需要
可选
formerPageUrl
string 
前向来源链接
可选
formerFirstLevelPage
string 
前向一级页面
可选
visitorTypes
string 
新老访客类型
可选
formerModuleId
string 
前向模块id
可选
formerMktId
string 
前向模块下内容id
可选
currentPageTitle
string 
当前页面名称
可选
shipToCountry
string 
shipTo国家
可选
spm
string 
spm字段
可选
bhvType
string 
行为类型
可选
isLogin
boolean 
是否登录
可选
pushExternalBatchId
string 
可选
app push任务ID(埋点)
checkoutCustomerParam
object (CheckoutCustomerParam) 
结算页注册客户参数
可选
id
integer 
客户表的主键ID
可选
levelId
integer 
等级编号
可选
firstName
string 
用户名
可选
lastName
string 
用户姓
可选
email
string 
用户邮箱
可选
password
string 
可选
用户密码 md5加密
whatapp
string 
可选
用户的whatapp联系方式
iso2
string 
国家iso2
可选
countryName
string 
用户国家ISO编号
可选
province
string 
用户的州省
可选
storeId
integer 
语言
可选
utmSource
string 
可选
utmMedium
string 
可选
utmCampaignInfo
string 
可选
utmContent
string 
可选
utmTerm
string 
可选
returnUrl
string 
可选
source
string 
来源
可选
referer
string 
来源url
可选
utmCampaign
string 
广告系列
可选
areaCode
string 
区号
可选
appCartKey
string 
未登录购物车表示
可选
curp
string 
curp
可选
rfc
string 
rfc
可选
utmInfo
string 
广告链接
可选
referrerUrl
string 
可选
socialType
integer 
可选
以下app用
社媒登录类型
socialUserId
string 
社媒客户Id
可选
modelLogo
string 
手机logo
可选
userId
string 
可选
userId(ios使用不知道干嘛的)
deviceId
string 
可选
firebase设备id
设备id
city
string 
城市
可选
streetAddress
string 
可选
apartmentAddress
string 
可选
zipCode
string 
邮编
可选
defaultAddress
boolean 
可选
是否是默认地址(默认包含运送地址默认和账单地址默认)
billingAddress
boolean 
是否是账单地址
可选
shippingAddress
boolean 
是否是账单地址
可选
discount
number 
可选
appCartKey
string 
未登录购物车标识
可选
preSaleSplitState
integer 
可选
预售拆分状态,null-非预售,0-合并发货,1-拆分发货
示例
{
    "orderNumber": "string",
    "prepareUid": "string",
    "useCredit": 0,
    "useCurrencyCredit": 0,
    "shippingAddressId": 0,
    "billingAddressId": 0,
    "addressType": 0,
    "shippingMethodId": 0,
    "paymethodCode": 0,
    "couponId": 0,
    "couponCode": "string",
    "currency": "USD",
    "payLater": 0,
    "pciParam": {
        "day": "string",
        "year": "string",
        "month": "string",
        "secureCode": "string",
        "cardNumber": "string",
        "cardData": "string",
        "document": "string",
        "installments": 0,
        "installmentsId": "string",
        "sessionId": "string"
    },
    "dlocalParam": {
        "id": "string",
        "document": "string",
        "name": "string",
        "flow": "string",
        "type": "string",
        "cvv": "string",
        "expireMonth": "string",
        "expireYear": 0,
        "number": "string"
    },
    "eBanxPaymentParam": {
        "id": "string",
        "year": "string",
        "month": "string",
        "secureCode": "string",
        "cardNumber": "string"
    },
    "googleParam": {
        "token": "string",
        "cartType": "string"
    },
    "appleParam": {
        "token": "string",
        "cartType": "string"
    },
    "pingpongDlocalPaymentParam": {
        "document": "string",
        "paymentKey": "string"
    },
    "parentOrderNumber": "string",
    "supplementOrderNumber": "string",
    "vat": "string",
    "curp": "string",
    "taxes": 0,
    "rfc": "string",
    "isForword": 0,
    "utmInfo": "string",
    "referrerName": "string",
    "pushExternalBatchId": "string",
    "referer": "string",
    "utmCampaign": "string",
    "type": 0,
    "paymentErrorCode": 0,
    "prohibitionConfirm": 0,
    "checkoutTime": 0,
    "forterTokenCookie": "string",
    "userAgent": "string",
    "accOrderNum": 0,
    "normalConfirm": 0,
    "sessionId": "string",
    "sensorsPublicParam": {
        "formerPageUrl": "string",
        "formerFirstLevelPage": "string",
        "visitorTypes": "string",
        "formerModuleId": "string",
        "formerMktId": "string",
        "currentPageTitle": "string",
        "shipToCountry": "string",
        "spm": "string",
        "bhvType": "string",
        "isLogin": true,
        "pushExternalBatchId": "string"
    },
    "checkoutCustomerParam": {
        "id": 0,
        "levelId": 0,
        "firstName": "string",
        "lastName": "string",
        "email": "string",
        "password": "string",
        "whatapp": "string",
        "iso2": "string",
        "countryName": "string",
        "province": "string",
        "storeId": 0,
        "utmSource": "string",
        "utmMedium": "string",
        "utmCampaignInfo": "string",
        "utmContent": "string",
        "utmTerm": "string",
        "returnUrl": "string",
        "source": "string",
        "referer": "string",
        "utmCampaign": "string",
        "areaCode": "string",
        "appCartKey": "string",
        "curp": "string",
        "rfc": "string",
        "utmInfo": "string",
        "referrerUrl": "string",
        "socialType": 0,
        "socialUserId": "string",
        "modelLogo": "string",
        "userId": "string",
        "deviceId": "string",
        "city": "string",
        "streetAddress": "string",
        "apartmentAddress": "string",
        "zipCode": "string",
        "defaultAddress": true,
        "billingAddress": true,
        "shippingAddress": true,
        "discount": 0
    },
    "appCartKey": "string",
    "preSaleSplitState": 0
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://www.nihaocloud.cn/st-cart/order/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderNumber": "string",
    "prepareUid": "string",
    "useCredit": 0,
    "useCurrencyCredit": 0,
    "shippingAddressId": 0,
    "billingAddressId": 0,
    "addressType": 0,
    "shippingMethodId": 0,
    "paymethodCode": 0,
    "couponId": 0,
    "couponCode": "string",
    "currency": "USD",
    "payLater": 0,
    "pciParam": {
        "day": "string",
        "year": "string",
        "month": "string",
        "secureCode": "string",
        "cardNumber": "string",
        "cardData": "string",
        "document": "string",
        "installments": 0,
        "installmentsId": "string",
        "sessionId": "string"
    },
    "dlocalParam": {
        "id": "string",
        "document": "string",
        "name": "string",
        "flow": "string",
        "type": "string",
        "cvv": "string",
        "expireMonth": "string",
        "expireYear": 0,
        "number": "string"
    },
    "eBanxPaymentParam": {
        "id": "string",
        "year": "string",
        "month": "string",
        "secureCode": "string",
        "cardNumber": "string"
    },
    "googleParam": {
        "token": "string",
        "cartType": "string"
    },
    "appleParam": {
        "token": "string",
        "cartType": "string"
    },
    "pingpongDlocalPaymentParam": {
        "document": "string",
        "paymentKey": "string"
    },
    "parentOrderNumber": "string",
    "supplementOrderNumber": "string",
    "vat": "string",
    "curp": "string",
    "taxes": 0,
    "rfc": "string",
    "isForword": 0,
    "utmInfo": "string",
    "referrerName": "string",
    "pushExternalBatchId": "string",
    "referer": "string",
    "utmCampaign": "string",
    "type": 0,
    "paymentErrorCode": 0,
    "prohibitionConfirm": 0,
    "checkoutTime": 0,
    "forterTokenCookie": "string",
    "userAgent": "string",
    "accOrderNum": 0,
    "normalConfirm": 0,
    "sessionId": "string",
    "sensorsPublicParam": {
        "formerPageUrl": "string",
        "formerFirstLevelPage": "string",
        "visitorTypes": "string",
        "formerModuleId": "string",
        "formerMktId": "string",
        "currentPageTitle": "string",
        "shipToCountry": "string",
        "spm": "string",
        "bhvType": "string",
        "isLogin": true,
        "pushExternalBatchId": "string"
    },
    "checkoutCustomerParam": {
        "id": 0,
        "levelId": 0,
        "firstName": "string",
        "lastName": "string",
        "email": "string",
        "password": "string",
        "whatapp": "string",
        "iso2": "string",
        "countryName": "string",
        "province": "string",
        "storeId": 0,
        "utmSource": "string",
        "utmMedium": "string",
        "utmCampaignInfo": "string",
        "utmContent": "string",
        "utmTerm": "string",
        "returnUrl": "string",
        "source": "string",
        "referer": "string",
        "utmCampaign": "string",
        "areaCode": "string",
        "appCartKey": "string",
        "curp": "string",
        "rfc": "string",
        "utmInfo": "string",
        "referrerUrl": "string",
        "socialType": 0,
        "socialUserId": "string",
        "modelLogo": "string",
        "userId": "string",
        "deviceId": "string",
        "city": "string",
        "streetAddress": "string",
        "apartmentAddress": "string",
        "zipCode": "string",
        "defaultAddress": true,
        "billingAddress": true,
        "shippingAddress": true,
        "discount": 0
    },
    "appCartKey": "string",
    "preSaleSplitState": 0
}'

返回响应

🟢200成功
application/json
Body
com.nihao.sitecartweb.model.vo.CreateOrderResultVo
orderNumber
string 
可选
createdAt
string 
可选
paymethodCode
integer 
可选
paySecret
string 
可选
currencyCode
string 
可选
currencyRate
number 
可选
paymentResult
integer 
可选
支付状态,0-支付等待中, 1-支付失败, 2-支付成功
baseTotalPaid
number 
基础货币支付金额
可选
totalPaid
number 
当前货币支付金额
可选
redirect
string 
重定向链接
可选
oceanPaymentFormParam
object (OceanPaymentFormParam) 
前海支付
可选
actionUrl
string 
表单提交路径
可选
form
object (FormParam) 
表单数据
可选
paymentNumber
string 
支付编码
可选
paymentCurrencyCode
string 
支付货币金额
可选
paymentIso2
string 
可选
paymentAmount
number 
支付金额
可选
pciPaymentFormParam
object (PciPaymentFormParam) 
可选
com.nihao.sitecartweb.model.vo.CreateOrderResultVo
actionUrl
string 
表单提交路径
可选
form
object (FormParam) 
表单数据
可选
failInfo
object (FailInfo) 
失败原因
可选
code
integer 
可选
msg
string 
可选
suggestion
string 
可选
recommend
string 
可选
accOrderNum
integer 
客户第几单
可选
默认值:
0
customerLoginToken
string 
可选
customerId
integer 
可选
示例
{
  "orderNumber": "",
  "createdAt": "",
  "paymethodCode": 0,
  "paySecret": "",
  "currencyCode": "",
  "currencyRate": 0.0,
  "paymentResult": 0,
  "baseTotalPaid": 0.0,
  "totalPaid": 0.0,
  "redirect": "",
  "oceanPaymentFormParam": {
    "actionUrl": "",
    "form": {
      "account": "",
      "terminal": "",
      "signValue": "",
      "backUrl": "",
      "noticeUrl": "",
      "methods": "",
      "order_number": "",
      "order_currency": "",
      "order_amount": 0.0,
      "billing_firstName": "",
      "billing_lastName": "",
      "billing_email": "",
      "billing_phone": "",
      "billing_country": "",
      "billing_state": "",
      "billing_city": "",
      "billing_address": "",
      "billing_zip": "",
      "ship_firstName": "",
      "ship_lastName": "",
      "ship_phone": "",
      "ship_country": "",
      "ship_state": "",
      "ship_city": "",
      "ship_addr": "",
      "ship_zip": "",
      "productSku": "",
      "productName": "",
      "productNum": 0,
      "order_notes": "",
      "ET_NOTES": ""
    }
  },
  "paymentNumber": "",
  "paymentCurrencyCode": "",
  "paymentIso2": "",
  "paymentAmount": 0.0,
  "pciPaymentFormParam": {
    "actionUrl": "",
    "form": {
      "notify_url": "",
      "return_url": ""
    }
  },
  "failInfo": {
    "code": 0,
    "msg": "",
    "suggestion": "",
    "recommend": ""
  },
  "accOrderNum": 0,
  "customerLoginToken": "",
  "customerId": 0
}
修改于 2025-04-02 03:37:07
上一页
商品关联博客列表
下一页
google or apple
Built with