滴滴 API
  1. OpenAPI
滴滴 API
  • 简介
  • OpenAPI
    • 接入前必读
    • 环境说明
    • 状态回调
    • 获取接入方用户信息
    • 安全认证
      POST
    • 扩展设备绑定验证
      POST
    • POI地址服务
      GET
    • 运力类型
      GET
    • 计价规则
      GET
    • 周边司机
      GET
    • 预估时间(ETA)
      GET
    • 预估价格
      GET
    • 发单预校验接口
      POST
    • 请求行程
      POST
    • 等待司机响应
      GET
    • 发单后修改行程
      PUT
    • 取消行程
      PUT
    • 司机位置
      GET
    • 行程详情
      GET
    • 账单
      GET
    • 评价司机
      POST
    • 司机号码解密
      GET
    • 申请发票
      POST
    • 发票查询
      GET
    • 电子发票预览
      GET
    • 电子发票重发
      GET
    • 服务器状态查询
      GET
    • 支付状态检查
      GET
    • 支付接口
      POST
    • 机场信息接口
      GET
    • 呼端链接
      GET
    • openCoupon
      POST
    • couponInfo
      POST
    • 顺风车
      GET
    • 线下测试环境司机自动化接单
      GET
    • 司乘重联
      POST
    • 取消规则
      GET
  • 备注
    • 接入频次控制等级
    • 行程状态推送支持类型
    • 状态机(专车,快车)
    • 费用列表(专车,快车)
    • 错误码(持续更新)
    • 滴滴开放平台服务器ip列表
    • 其他
  • 安全
    • 用户访问滴滴H5凭证
    • 获取用户封禁信息
    • 录音录像授权结果查询
    • 录音录像授权
    • 紧急联系人查询
    • 紧急联系人操作
    • 安全中心面板-获取报警信息
    • 获取报警信息
    • 触发一键报警
  1. OpenAPI

支付接口

正式环境
https://api.xiaojukeji.com/
正式环境
https://api.xiaojukeji.com/
POST
/v1/orders/{didi_oid}/payment
功能: 接入方通知滴滴,支付订单费用给司机。
支持运力:express-car,private-car,taxi(司机填写账单后可用)
注:
1.专/快车费用与滴滴所出账单不一致时(实时计价订单),支付处理失败
2.需满足条件:总金额 == 乘客实际支付金额 + 接入方补贴金额 + 滴滴补贴金额,否则支付处理失败
3.支付币种为人民币,单位为分
支付失败(专车、快车):http status 非200aa
codeerror_detail说明
40010输入金额校验失败,请检查支付金额支付金额与滴滴生成的账单金额不一致
费用检查未通过。行程车费:xx.xx元,乘客支付车费:xx.xx元支付费用与账单不一致,支付失败
40018行程id错误,不存在该行程订单不存在,无法支付
40029无支付权限无支付权限,不能请求支付
40030无司机接单,无需支付未产生费用,不能支付
行程中不能支付行程未结束,不能支付
40031请求正在处理中,请稍后为防止重复支付,每个订单的支付会锁定3s,锁定时间内重复请求无效
40032订单已支付,请勿重复支付已支付的行程不能再支付,出租车订单乘客线下支付后,不能再线上支付
更新日志
2017.08.04 增加支付信息通知,is_notify=1滴滴不发起支付请求,只保存支付信息。is_notify=2保存支付信息并且发起支付
2018.06.19 pay_info参数增加 trade_id字段,表示支付交易流水号,用于滴滴校验支付结果
2018.06.27 pay_info字段增加detail字段,用于传递用户完整支付信息,更新示例
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.xiaojukeji.com//v1/orders//payment' \
--header 'Authorization: Bearer domain|{access_token}' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{"total_fee":10000,"is_notify":2,"pay_info":{"pay_type":"creditcard","status":1,"lng":116.344434,"lat":39.998568,"deviceid":"BEO19-POIA1-PO98T","imei":"aasd9012kjkasd","ip":"127.0.0.1","wifi_mac":"fa:e2:d9:c5:f1:ab","detail":{"trade_id":"10000503012018062002208","business_id":"biz_id","amount":"10000","pay_time":"2018-06-01T10:00:00+0800"}},"fee_info":{"real_fee":10000,"subsidy":0,"allowance":0}}'
响应示例响应示例
{
  "error": "string",
  "error_detail": "string"
}

请求参数

Path 参数
didi_oid
string 
必需
Header 参数
Content-Type
string 
必需
示例值:
application/json
Authorization
string 
必需
示例值:
Bearer domain|{access_token}
Body 参数application/json
total_fee
integer 
总金额(单位分)
必需
is_notify
integer 
必需
支付通知类型。 0:需要支付(默认); 1:支付通知,只保存支付信息,不发起支付请求(用于运营发票,如存在第三方补贴); 2:保存支付信息并且支付司机(用于运营发票 & 非垫付渠道)
pay_info
object 
v
必需
pay_type
string 
必需
支付方式,空值表示未支付。 baidu(百度钱包), alipay(支付宝), wechat(微信), qq(qq钱包), debitcard(借记卡), creditcard(信用卡
status
integer 
必需
支付状态。 0:支付失败, 1:支付成功
lng
number 
必需
支付时用户经纬度信息
lat
number 
必需
支付时用户经纬度信息
deviceid
string 
必需
支付设备id,必须至少提供一个
imei
string 
必需
支付设备id,必须至少提供一个
ip
string 
支付ip
必需
wifi_mac
string 
必需
支付网络的 wifi mac 地址
detail
object 
完整支付记录
必需
fee_info
object 
可选
费用信息( is_notify=1, 2 时该字段不能为空),币种为人民币,单位为分
real_fee
integer 
必需
乘客实际支付金额,单位为分
subsidy
integer 
必需
滴滴补贴金额,单位为分
allowance
integer 
必需
第三方补贴金额,单位为分
示例

返回响应

🟢200成功
application/json
Body
error
string 
必需
error_detail
string 
必需

【滴滴】API开发者 微信交流群

用微信扫右侧二维码,加入【滴滴】API开发者 交流群,互助沟通

扫码加入交流群
上一页
支付状态检查
下一页
机场信息接口
Built with