- 集成指南
- 实施 Batch 集成
- 了解您的输入字段
了解您的输入字段
在执行测试交易之前，您必须准备好需要输入的字段的值。 无论您选择哪种方法来生成这些值，手动还是使用脚本自动生成，这些字段的适当值都可以简化管理订单和交易的过程，特别是检索丢失的交易。
交易/订单识别码和订单编号
有关字段类型、验证规则以及哪些操作需要以下字段的更多信息，请参阅 API 参考。
订单的唯一标识符（包含在 REST 的 URL 中），用于区别于您创建的任何其他订单。 此字段为强制字段，对于您根据商家配置文件创建的每个订单必须是唯一的。 在尝试对订单执行后续交易时（例如，Refund、Capture 或 Void），您必须提供与初始 Authorization 或 Pay 对应的订单 ID。
重复使用订单识别码
从 API v15 开始，如果订单的初始交易失败，您可以为此订单提交另一个初始交易，无需创建新订单。 在付款人可能希望使用不同的付款详细信息（例如不同的信用卡或其他付款方式 (PayPal)）重新进行失败的交易时，此功能会很有用。
交易的标识符（包含在 REST 的 URL 中），用于将其与此订单中的其他交易区分开来。 此字段是必填项，并且对于您在订单中创建的交易必须是唯一的。 唯一的交易 ID 对于稍后检索交易很有用。 但是，交易 ID 必须始终附带订单 ID 才能够成功执行检索操作。
此交易 ID 将作为交易 ID 显示在 Merchant Administration 中的财务交易详细信息页面中。
用于在 Mastercard Gateway 中提供一些有意义的基于业务的识别码的可选识别码。 例如，购物车号、订单号或发票号。 订单编号可以在 Merchant Administration 中用作搜索条件。
用于识别 Mastercard Gateway 内的交易的可选识别码。 此值在交易级别设置，没有唯一性约束，因此，您可以根据您的要求使用。 您可以在 Merchant Administration中使用此字段搜索交易。
用于识别可用于将 Mastercard Gateway 请求与响应匹配的暂时识别码。 您提供的值不会在网关中留存，将返回为请求响应中提供的值。 您可以将关联 ID 应用于所有 API 请求。
您可以使用此值来将响应文件中的条目与请求文件中的对应条目匹配，即使响应返回的顺序与请求不同。