接送服务

接送服务的货币与价格

以受支持的货币请求价格,并明确应收取的金额。

分享

以受支持的货币请求价格,并明确应收取的金额。

支持的货币

text
text
EUR, USD, INR, CHF, JPY, GBP, AUD, CAD, CNY, SGD, NZD, MXN

小写取值也被接受,并会标准化为大写。

在哪里发送

  • POST 端点,currency 放在请求体中。
  • GETDELETE 端点,currency 放在查询字符串中。

货币如何确定

新搜索在省略 currency 时默认使用 USD。之后,pricing、预订、预订查询和取消都会继承该报价的货币,因此后续流程中可以不再发送该字段。

如果你在后续调用中发送 currency,它必须与报价或报价单一致。不一致会以 transfer_currency_mismatch 拒绝,而不会被静默换算。

应收取的金额

请精确收取 POST /pricing 返回的 finalPrice.amount,货币使用同时返回的 finalPrice.currency

不要在其之上追加任何费用,也不要根据搜索响应或设施数据自行汇总总价。搜索报价中的 totalAmount 仅供参考:它可用于排序和展示选项,但只有 pricing 才会给出可收取的金额。

如果所选报价的价格已失效,预订会返回 409 transfer_price_changed。请重新定价并按新金额收费。

错误

json
json
{
  "statusCode": 400,
  "code": "transfer_invalid_currency",
  "message": "Unsupported public transfer currency: COP"
}
HTTP代码含义
400transfer_invalid_currency该货币不在支持列表中。
400transfer_currency_mismatch货币与报价、报价单或预订不一致。
503当前无法确认价格。请稍后重试;不要预订,也不要收费。