ET-PAY-API
  1. 创建收单订单
ET-PAY-API
  • ET PAY API接入概述
  • 准备工作
  • 签名机制
  • 加密机制
  • API
    • 公共请求报文头
    • 公共响应报文头
    • API列表
    • 创建收单订单
      • 请求数据
      • 响应说明
    • 查询收单订单信息
      • 请求数据
      • 响应数据
    • 创建退款订单
      • 请求数据
      • 响应数据
    • 查询退款订单
      • 请求数据
      • 响应数据
    • 关闭收单订单
      • 请求数据
      • 响应数据
  • 异步通知
    • 回调服务接入概述
    • 公共请求报文头
    • 公共响应报文头
    • 回调附录
    • 收单支付成功通知
      • 请求说明
      • 响应说明
    • 退款回调
      • 请求说明
      • 响应说明
  • 附录
    • 证件类型
    • 国家列表
    • 货币列表
    • 收单交易状态说明
    • 状态码说明
    • 收单退款状态说明
  • 变动日志
    • 变动日志
  1. 创建收单订单

请求数据

主订单信息#

字段名类型是否必填备注示例
merchant_order_idString是客户自定义的收单ID,唯一值 最大长度 128XXXX
order_titleString是标题,最大长度 100Example Title
order_descriptionString否描述,最大长度 500Example description
remarkString否订单备注,最长 500Example remark
amountFLOAT(21,2)是金额,小数2位12345.67
currency_codeString是币种代码USD, 具体请看附录的货币列表
time_expireString否订单有效期,当不传的时候,默认24小时后失效,有效期为当前时间1分钟后至72小时2024-12-31 23:59:00
tzString否订单时区,当不传的时候,默认+8+8
productsArray[object]否产品信息[{'name': ''}]
consumer_infoobject是消费者信息{'name': '']
notify_urlString否回调地址XXXX
payment_success_urlString否支付成功跳转URL,默认跳转ET支付成功页
close_order_urlString否订单关闭跳转URL,默认跳转ET订单关闭页
need_user_phoneint否是否需要收集 手机号 - 0不收集 1:收集但不需要验证 2:收集且需要验证
need_user_schoolint否是否需要收集 学校 - 0不收集 1:收集
need_user_postscriptint否是否需要收集 附言 - 0不收集 1:收集

产品信息 (products)#

字段名类型是否必填备注示例
nameString否产品名称, 最大长度 255
quantityInteger否数量, 不传默认为11
amountNumber(9,2)否单价, 最大长度9,整数7位,小数2位99.99

consumer_info- 消费者信息#

字段名类型是否必填备注示例
emailString是邮箱, 最大长度 100
name_cnString否姓名(中文), 最大长度 100,姓名中英文必填其一
first_name_enString是名字(英文), 最大长度 100
last_name_enString是姓氏(英文), 最大长度 100
tel_codeString否区号, 最大长度 1086
mobileString否手机号, 最大长度 20
user_country_codeString否用户国家, 具体请看附录的国家列表
id_numberString否证件号码
id_typeint否证件类型,具体请看附录的证件类型
school_namestr否学校名字
whatsappstr否whatsapp号
data_of_birthstr否生日,格式:2024-11-07
school_nameString否学校名称, 最大长度 128
postscriptString否附言, 最大长度 128
修改于 2025-03-31 03:55:23
上一页
API列表
下一页
响应说明
Built with