优化斗鱼充值

docs/鱼翅充值api/订单接口/1.创建订单_必要.md

@@ -0,0 +1,77 @@
+# 创建订单【必要】
+
+# 接口说明
+
+- 下单接口
+- POST 请求 
+- application/json
+- 接口地址  adapter-apiaccess/open/api/createOrderV2
+
+
+
+# 请求参数
+
+请求公共参数	——	参考接口规范的请求公共参数	是	携带公共参数
+product_id	string	66668888	是	商品编码
+buy_num	int	1	是	购买数量
+pay_amount	decimal	88.88	是	用户支付金额
+out_order_id	string	OUT202503010010208888	是	来源/外部订单号
+order_type	int		是	订单类型：0-直充 1-话费 2-流量 3-卡密
+recharge_arg	string	用户填写信息的JSON串	否	【直充必传】充值模板及填写值
+buyer_ip	string	114.115.116.117	否	买家IP，若要启用风控则必传
+buyer_id	string（64）	15486548471	否	买家唯一标识，若要启用风控则必传
+notify_url	string		否	回调地址，订单完成会通过该地址异步通知
+ext_arg	string	订单补充信息JSON串	否	补充字段，经过约定后，补充信息字段都在这里传递
+
+
+notify_url：
+- 一些直充类的订单时间比较久，但不能持续占用连接
+- 不传就不回调，订单的状态在查询时处理
+
+
+
+recharge_arg：（此处数据为用户填写和对应模板）
+
+[
+  {
+    "templateName": "模板名，一般是中文，如手机号，只是标识用，调用方可自行决定",
+    "templateVal": "用户填写的充值账号，比如：19876543210",
+  }
+]
+
+
+这里是用户填写的信息，比如：充值手机号：19876543210
+templateName：充值手机号
+templateVal：19876543210
+
+
+ext_arg：（此处数据均为双方约定）
+
+{
+  "skuid": 243241231238888888,
+  "skuname: "电商平台的商品名称"
+}
+
+# 响应信息
+
+## code数据对业务流程的影响
+
+参数	类型	示例值	必要	描述
+响应公共参数	——	参考接口规范的响应公共参数	是	携带公共参数
+请求异常情况下，下面的参数都是非必要的下标描述的是请求接收正常情况下的参数说明				
+out_order_id	string	OUT202503010010208888	是	来源/外部订单号
+order_id	string	202503010010208888	是	供货方的订单号
+order_type	int	4	是	订单类型：0-直充；1-话费；2-流量；3-卡密 
+order_status	int	0	是	0，待处理；1，处理中；2，成功；3，失败  4-异常
+fail_reason	string		否	失败原因，失败必传
+create_time	string	2025/3/1 0:10	是	订单创建时间（供货方）
+
+code数据对业务流程的影响
+- 如果返回 200 的状态码，则下单成功，后续通过【查询订单】或者【订单异步通知】来获取订单结果状态
+- 如果返回非 200 的状态码，订单失败，流程结束
+
+order_status数据对业务流程的影响
+- 0，待处理；1，处理中；2，成功；3，失败； 4，异常
+- 当为 0 和 1 时，订单没有结束，
+  - 需要调用方自轮询查询订单；
+  - 或本平台订单结束后，异步通知订单结果