自动化采购、企业批量进货、ERP自研开发的开发者都知道：1688最难开发的不是采集，而是交易链路。

普通采集接口只能查看商品、价格、店铺基础数据；而交易类API可以实现真人级别的后台操作：地址解析、获取收货地址、创建采购订单、订单预览、免密支付、查询订单、取消订单。

市面99%的公开教程都没有完整的1688下单付款流程，今天我给大家带来官方原版、完整链路、可直接开发上线的1688定制交易API教程，全部接口源自1688开放平台官方文档，包含10个交易级接口，从授权到下单、付款、查单、撤单一站式打通，附带可直接运行Python源码。

一、接口整体概述

1.1 接口目的

实现1688平台在线快速创建订单、自动完成支付、订单管理、取消交易全套自动化流程，无需人工后台操作，适合ERP系统、自动采购系统、批量铺货系统、企业采购管理平台接入开发。

1.2 适用业务场景

• B2B大宗交易：工厂、企业长期批量采购补货
• 无货源批发采购：个人、工作室自动代拍、自动补货
• 跨境备货：跨境卖家批量下单囤货，统一中转发货
• 自研ERP对接：打通1688交易链路，实现后台全自动管理

二、全套接口调用流程（官方标准顺序）

本文严格按照1688开放平台标准交易链路排序，完整执行流程如下：

账号授权 → 地址解析 → 获取收货地址 → 创建订单 → 订单预览校验 → 买家视角查看订单 → 判断免密支付状态 → 发起免密付款 → 获取订单列表 → 取消订单

2.1 第一步：账号认证授权（前置必要操作）

所有交易类接口必须完成账号授权，未授权账号无法调用任何交易接口，官方固定授权流程：

1. 登录开放平台控制台

2. 页面点击【1688授权】按钮

3. 点击立即购买（当前为永久0元订购，无任何扣费）

4. 订购成功自动跳转控制台，授权完成即可正常调用接口

重要提示：交易接口权限有效期为30天，每月需要重新订购一次，否则权限失效、接口调用报错。

2.2 调用前置准备

• 开放平台密钥Key、Secret状态正常，账户无欠费、无封禁限制
• 统一请求主接口地址：https://api-gw.onebound.cn/1688/custom
• 全部交易接口共用通用定制接口，通过method参数区分不同功能
• 必须完成1688店铺绑定授权，未授权会返回权限错误

三、十大交易接口详细说明（全部官方原版）

3.1 地址地区码解析接口

作用：将中文明文地址解析为1688官方标准地区编码，是创建订单必填基础参数。

method：com.alibaba.trade/alibaba.trade.addresscode.parse

请求示例：

https://api-gw.onebound.cn/1688/custom?key=&&method=com.alibaba.trade/alibaba.trade.addresscode.parse&_o_args={"addressInfo":""}&lang=zh-CN&secret=

3.2 获取买家收货地址列表

作用：读取当前授权账号后台已保存的全部收货地址，提取addressId直接用于下单参数。

method：com.alibaba.trade/alibaba.trade.receiveAddress.get

3.3 创建跨店铺交易订单

核心下单接口：生成1688采购订单，支持单品下单、多品合并、不同店铺跨店下单。

method：com.alibaba.trade/alibaba.trade.createCrossOrder

3.4 订单价格预览接口

作用：创建订单之前预校验商品单价、运费、平台优惠，防止价格异常、防止错单。

method：com.alibaba.trade/alibaba.createOrder.preview

3.5 买家视角订单详情查询

作用：以买家视角查看已创建订单，包含商品规格、价格、物流、商家资料等详细数据。

method：com.alibaba.trade/alibaba.trade.get.buyerView

3.6 免密支付权限检测

作用：检测当前账号是否开通免密代扣权限，未开通会返回官方授权开通链接。

method：com.alibaba.trade/alibaba.trade.pay.protocolPay.isopen

3.7 发起免密支付

付款核心接口：传入合法订单号，一键发起自动扣款，无需手动输入支付密码。

method：com.alibaba.trade/alibaba.trade.pay.protocolPay.preparePay

3.8 获取买家订单列表

作用：批量读取当前账号全部采购订单，包含订单状态、实付金额、物流信息、下单时间。

method：com.alibaba.trade/alibaba.trade.getBuyerOrderList

3.9 订单取消接口

作用：针对未发货、未付款订单一键撤销，支持自定义填写取消原因。

method：com.alibaba.trade/alibaba.trade.cancel

四、整合Python完整源码（全流程封装）

我把地址解析、获取地址、创建订单、支付检测、发起付款、查询订单、取消订单全部封装，代码无冗余、可直接运行，支持上线生产环境。

# -*- coding: utf-8 -*-
"""
1688官方交易全套API
包含：地址解析、获取收货地址、创建订单、预览、免密支付、查单、撤单
纯净官方接口、无第三方品牌依赖
"""
import requests

# ====================== 配置区 ======================
API_KEY = "你的Key"
API_SECRET = "你的Secret"
BASE_URL = "https://api-gw.onebound.cn/1688/custom"
# ====================================================

def request_trade_api(method, o_args):
    """通用交易接口请求封装"""
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "method": method,
        "lang": "zh-CN",
        "_o_args": str(o_args)
    }
    try:
        res = requests.get(BASE_URL, params=params, timeout=20)
        return res.json()
    except Exception as e:
        print("接口请求异常：",e)
        return None

# 1.地址解析
def parse_address(address):
    return request_trade_api("com.alibaba.trade/alibaba.trade.addresscode.parse",{"addressInfo":address})

# 2.获取收货地址
def get_receive_address():
    return request_trade_api("com.alibaba.trade/alibaba.trade.receiveAddress.get",{})

# 3.创建订单
def create_order(addressId,offerId,specId,quantity):
    body = {
        "flow":"general",
        "addressParam":{"addressId":addressId},
        "cargoParamList":{"offerId":offerId,"specId":specId,"quantity":quantity}
    }
    return request_trade_api("com.alibaba.trade/alibaba.trade.createCrossOrder",body)

# 4.检测免密支付是否开通
def check_pay_open():
    return request_trade_api("com.alibaba.trade/alibaba.trade.pay.protocolPay.isopen",{})

# 5.发起免密付款
def pay_order(orderId):
    body = {"tradeWithholdPreparePayParam":{"orderId":orderId}}
    return request_trade_api("com.alibaba.trade/alibaba.trade.pay.protocolPay.preparePay",body)

# 6.获取订单列表
def get_order_list():
    return request_trade_api("com.alibaba.trade/alibaba.trade.getBuyerOrderList",{})

# 7.取消订单
def cancel_order(tradeID,cancelReason="other"):
    body = {"webSite":1688,"tradeID":tradeID,"cancelReason":cancelReason,"remark":""}
    return request_trade_api("com.alibaba.trade/alibaba.trade.cancel",body)

if __name__ == "__main__":
    print("===== 1688交易全流程工具 =====")
    # 示例：调用地址解析
    data = parse_address("广东省中山市东凤镇")
    print(data)

五、业务实战使用场景

5.1 无货源自动补货系统

监控店铺库存数据，库存不足时自动调用接口完成下单、付款，无需人工值守，实现全天自动化补货。

5.2 企业批量采购管理

对接企业内部ERP系统，定时批量采购原材料、耗材，自动留存采购单据、自动对账，简化人工做账流程。

5.3 跨境备货自动化

采集平台爆款商品，自动化批量下单囤货，统一发往跨境中转仓，极大降低人工备货成本。

5.4 订单风控管理

针对错拍、多拍、恶意订单，后台一键撤销交易，规避资金损耗、降低采购风险。

六、接口报错码官方说明（交易专用）

七、写在最后

1688普通采集接口只能做静态数据查看，而本文这套定制交易API可以真正实现自主交易操作。

从账号授权、地址解析、创建订单、免密支付、订单查询、一键撤单，完整复刻真人采购操作流程，是目前市面最完整、最干净、最适合开发者对接的1688交易链路方案。

不管是个人开发工具、工作室店群系统、企业自研ERP，这套代码都可以直接部署使用，快速打通1688全自动交易能力。