Developer Hub
这是自动生成的译文

购物卡退款

供应商取消使用 P-cards 预订的航班时,退还已兑换的旅行积分。

当旅客的行程因航空公司变更而改变时,您可以协助他们返还用于购买卡(P-card)预订的已赚取的忠诚度积分。您将创建一个文件并将其上传到 Expedia SFTP 服务器。从宏观层面来说,这意味着你将:

  1. 从 Expedia 请求 TPID、EAPID 和 SITEID 信息。该信息是报告名称的重要组成部分,用于确保退款信息正确映射。有关更多详细信息,请参阅命名规则部分。
  2. 根据指定的格式和结构创建文件,并按照命名规则命名。
  3. 将文件上传到 Expedia SFTP 服务器。

通过遵守本文档中定义的各部分,您可以确保文件在自动化处理过程中顺利处理,不会出现错误或遗漏。

获取信息

请您的 P-card 发卡机构提供每日数据文件,其中包含您发送给 Expedia 的采购卡退款报告所需的报告数据点。通常情况下,P-card 支付处理商(例如 TSYS)会提供此报告。

文件格式

要成功处理退款申请,申请文件必须符合以下标准:

  • 文件格式必须为.csv(未加密文件)或.pgp(加密文件)。提交加密文件时,请确保使用 PGP 加密将整个文件作为一个整体进行加密,而不是对每一行单独进行加密。
  • 文件的第一行必须始终包含列标题。
  • 下表中的所有 10 列都必须按所列顺序填写。不应添加其他列。
  • 每行内容之间必须用竖线字符(|)分隔,而不能用逗号分隔。
  • 在列标题之后,每一行对应一条交易记录。
  • 所有必填列都必须存在且包含有效数据。缺少必填字段的记录将被跳过或标记,供代理审核。

文件结构

运营商将提供 AIR_CONFIRMATION_NUMBER 或 AIR_TICKET_NUMBER,因此请同时包含这两个属性,以确保退款得到报告。

最好在报告中包含条件必填字段(AIR_TICKET_NUMBER 和 AIRLINE_CARRIER_CODE),但如果运营商不提供数据,则报告在被 Expedia 接收时不会失败。

命令列名说明数据类型示例是否必需?
1AIR_TICKET_NUMBER机票号码。必须是 10 位数字。如果此字段没有值,则需要代理审核以将记录与 Expedia 匹配。注意:无纸化客运公司将使用确认号码。字符串9607721439(有条件地)
2AIRLINE_CARRIER_CODE2 或 3 位字母数字组成的航空公司 IATA 代码。如果此字段没有值,则需要代理审核以将记录与 Expedia 匹配。字符串DL(达美航空)
加拿大航空(AC)
美联航(UA)
(有条件地)
3TRANSACTION_AMOUNT表示刷卡金额的两位小数。负数表示退款。
注意:此字段在退款交易中为必填项,但在贷记交易中则不是必填项。
号码104.23(收费)
-104.23(退款)
必填
4CURRENCY_CODE3 字母 ISO 货币代码。字符串CAD
USD
必填
5POST_DATEP-card 帖子日期格式为 mm/dd/yyyy。日期11/07/2024必填
6TRANSACTION_DATEP-card 交易日期,格式为 mm/dd/yyyy。日期07/07/2024必填
7TRAVELER_FIRST_NAME与该机票关联的旅客的名字。最多 50 个字符。请勿使用竖线字符。
允许的值:拉丁字母(A-Z, a-z),)、带重音符号的字母(如 é、ü、ç)、数字、空格。
字符串帕尔瓦蒂
玛丽安
可选
8TRAVELER_LAST_NAME与该机票关联的旅客的姓氏。最多 50 个字符。请勿使用竖线字符。
允许的值:拉丁字母(A-Z, a-z),)、带重音符号的字母(如 é、ü、ç)、数字、空格。
字符串史密斯
德拉克鲁兹
可选
9SUPPLY_INFO供应商的其他信息,通常是商家名称。最多 300 个字符。
允许的值:拉丁字母(A-Z, a-z), 数字、空格。不允许使用特殊字符(例如 @、'、-、#、é、ç)。
字符串空气罐 0111111111111
加勒比海 AI1062222222222
布鲁塞尔人工智能 0823333333333
可选
10AIR_CONFIRMATION_NUMBER6 位字母数字组合的航空确认号码。当没有票号时,此字段用作标识符。只有在与无票航空公司打交道时才需要这样做。
允许的值:拉丁字母(A-Z, a-z), 数字。
请勿使用:空格、特殊字符(例如 @、#、é、ç)
字符串ABCD12可选(无票处理时必需)

示例文件

文件名: [PARTNERNAME]_ 5002_900188_ 900188_20241108.csv

AIR_TICKET_NUMBER|AIRLINE_CARRIER_CODE|TRANSACTION_AMOUNT|CURRENCY_CODE|POST_DATE|TRANSACTION_DATE|TRAVELER_FIRST_NAME|TRAVELER_LAST_NAME|SUPPLY_INFO|AIR_CONFIRMATION_NUMBER 
9607721439|AC|104.23|CAD|11/07/2024|11/01/2024|Sam F.|Doe|AIR CAN 0111111111111|ABCD12
5954412772|WS|-550.9|CAD|02/08/2024|02/04/2024|John|Smith|CARIBBEAN AI1062222222222|WQJGL5 
54412723|UA|-265.9|CAD|02/09/2024|02/04/2024||||

文件参数

在上传退款文件之前,您需要遵循一些标准惯例,包括设置文件名和加密信息。

命名规则

所有申请退款的文件必须遵循以下命名规则。任何偏离此格式的文件都将不被处理。

文件名应按以下格式编写:[PARTNERNAME]_TPID_EAPID_SITEID_YYYYMMDD.csv,其中:

  • 合作伙伴名称:贵组织的名称。
  • TPID:由 Expedia 分配的旅行产品 ID。
  • EAPID:由 Expedia 分配的 Expedia 附属合作伙伴 ID。
  • SITEID:由 Expedia 分配的站点的销售点 ID。
  • YYYYMMDD = 文件生成的年份、月份和日期,年份用 4 位数字表示,月份和日期各用 2 位数字表示。

文件名中请勿包含特殊字符或空格。文件大小不应超过 5 GB。

加密

为了提高安全性,您可以选择使用 PGP 对文件进行加密。请向您的客户经理索取我们的公钥 PGP 密钥,并:

  • 保护整个文件,而不仅仅是其内容。
  • 添加 .pgp 扩展名(例如,PARTNERNAME_0_1_1_20250101.pgp

上传说明

要成功处理该文件,必须使用 Expedia SFTP 主机名提交:eps-pcard-transactions-datafeed.transfer.expedia.com

要建立 SFTP 连接,您需要提供以下详细信息:

  • SFTP 用户的首选用户名(字母数字混合,最多 20 个字符)
  • SSH(安全外壳)公钥
  • 要添加到允许列表的 IP 子网(SFTP 连接将仅允许来自此允许子网的连接)

使用任何 SFTP 连接工具,在 SFTP 客户端上打开一个新连接。选择安全文件传输协议,并输入您的 Expedia 帐户管理员将提供的服务器和用户名。

**注意:**您每天只能上传一次退款文件。

测试

在正式上线您的模板网站之前,我们建议您测试退款上传流程。 为了进行初步验证,请先上传包含模拟数据的示例报告文件。我们将核实文件是否已收到,并确认数据是否已成功处理。

然后,在网站上线前,通过生产预订进行验证。您的 Expedia 客户经理将与您协调,根据用户验收测试期间的生产测试预订情况,提交特定日期的报告。

您觉得这个页面有用吗?
我们该如何改进这些内容?
感谢您帮助我们改进!