以受支持的货币请求价格,并明确应收取的金额。
支持的货币
text
EUR, USD, INR, CHF, JPY, GBP, AUD, CAD, CNY, SGD, NZD, MXN小写取值也被接受,并会标准化为大写。
在哪里发送
- 在
POST端点,currency放在请求体中。 - 在
GET和DELETE端点,currency放在查询字符串中。
货币如何确定
新搜索在省略 currency 时默认使用 USD。之后,pricing、预订、预订查询和取消都会继承该报价的货币,因此后续流程中可以不再发送该字段。
如果你在后续调用中发送 currency,它必须与报价或报价单一致。不一致会以 transfer_currency_mismatch 拒绝,而不会被静默换算。
应收取的金额
请精确收取 POST /pricing 返回的 finalPrice.amount,货币使用同时返回的 finalPrice.currency。
不要在其之上追加任何费用,也不要根据搜索响应或设施数据自行汇总总价。搜索报价中的 totalAmount 仅供参考:它可用于排序和展示选项,但只有 pricing 才会给出可收取的金额。
如果所选报价的价格已失效,预订会返回 409 transfer_price_changed。请重新定价并按新金额收费。
错误
json
{
"statusCode": 400,
"code": "transfer_invalid_currency",
"message": "Unsupported public transfer currency: COP"
}| HTTP | 代码 | 含义 |
|---|---|---|
400 | transfer_invalid_currency | 该货币不在支持列表中。 |
400 | transfer_currency_mismatch | 货币与报价、报价单或预订不一致。 |
503 | 当前无法确认价格。请稍后重试;不要预订,也不要收费。 |