帐户信息 API
使用您的网站,通过旅客的帐户信息验证旅客身份。
账户信息 API 包含每位旅客的详细信息。Expedia 代理将使用它来验证旅行者的唯一标识符,用于购买、积分兑换、取消等操作。此唯一标识符可以是信用卡号(支付卡行业 (PCI) 标识符)或 non-PCI 标识符 ,例如电子邮件地址或会员账号,具体取决于您的要求或安全标准。
有关更多信息,请参阅通用数据和响应。
获取帐户信息
您将使用这组字段发送 POST /user/v1/account 请求获取会员或持卡人的帐户信息。
标题
| 字段 | 说明 | 示例值 | 字段类型 | 是否必填? |
|---|---|---|---|---|
partnerId | 由 Expedia 提供的企业唯一标识符 | 您的品牌 | 字符串,最多 20 个字符 | 是 |
Authorization | Expedia 从您的授权服务器收到的访问令牌,由您的团队进行验证 | 标准 JSON web 令牌 (JWT) | 字符串,标准 JWT 长度 | — |
Authorization2 | 由 Expedia 发送的 JSON web 令牌 (JWT);签名和申请将在您的终端进行验证 | 标准 JWT | 字符串,标准 JWT 长度 | — |
请求
您需要将 membershipId、loyaltyAccountNumber、cardNumber 或 email设置为必填参数。您的客户经理将与您一起根据您的需求确定最佳方案。
注意: 如果您使用 cardNumber作为标识符,您还需要查看下面的 cardDetails和 billingAddress表格。其他参数不需要此数据。
| 字段 | 说明 | 字段类型 | 是否必填? |
|---|---|---|---|
requestId | 交易请求的唯一标识符 | 字符串 | 是 |
membershipId | 唯一旅行者标识符 | 字符串 | 是的,选项 1 |
loyaltyAccountNumber | 旅客忠诚度账户号码(也称为programAccountNumber);仅当忠诚度操作需要除membershipId之外的标识符时才应填写此项。 | 字符串 | 是的,选择方案二 |
programId | 旅行者所属会员计划的标识符或与该会员计划关联的等级名称 | 字符串 | — |
cardNumber | 旅行者信用卡号(已加密) | 字符串 | 是的,选项 3 |
email | 旅客邮箱地址 | 字符串 | 是的,选项 4 |
响应
| 字段 | 说明 | 字段类型 | 是否必填? |
|---|---|---|---|
status | 交易状态(值:已批准、已拒绝) | 字符串 | 是 |
requestId | 交易请求的唯一标识符(来自请求有效负载) | 字符串 | 是 |
programAccount | 会员计划账户详情;有关嵌套字段,请参见programAccount表格 | — | |
languageId | 本网站支持的语言;详情请参阅本地化详情页面。 | 字符串 | — |
optInForMarketingEmail | 用户是否选择接收营销邮件 | 布尔值 | — |
channelType | 经过优化的网站平台(值:WEB、MOBILE、TABLET) | 字符串 | — |
users | 用户详细信息列表;有关嵌套字段,请参见users表格。 | — | |
cardDetails | 交易中使用的信用卡详情;有关嵌套字段,请参见cardDetails表格(如果已填写,则某些嵌套项必须加密)。 | — |
programAccount
| 字段 | 说明 | 示例值 | 是否必填? |
|---|---|---|---|
programId | 旅行者所属会员计划的标识符或与该会员计划关联的等级名称 | Aventura 金卡 | 是 |
accountName | 计划名称(如果与 programId 不同) | Aventura | — |
loyaltyAccountNumber | 旅客忠诚度账户号码(也称为programAccountNumber);仅当忠诚度操作需要除membershipId之外的标识符时才应填写此项。 | 1234567 | — |
lastFourDigitsOfCreditCard | 旅客预订时使用的信用卡后四位数字 | 0000 | — |
loyaltyConversionRatio | 消费金额转换为累积积分的比率(例如 $1 = 1 积分) | — | |
loyaltyAccountBalance | 旅行者当前已获得的忠诚度积分余额 | 2003 | 是 |
cardDetails
| 字段 |
|---|