- 集成指南
- 实施 Batch 集成
- 创建批处理请求
创建批处理请求
创建批处理请求是商家集成的关键步骤。 批处理请求由本机格式的批处理文件构成，Batch 服务使用 HTTPS PUT 接受该文件并提交至 Mastercard GatewayBatch URL。
本机格式定义如下：
- HTTP 标头必须指定基本身份验证并包括 base64 编码的集成密码。
- 请求的字符编码必须只包含 ISO-8859-1(Latin1) 或 UTF-8 格式。 请参见确保字符编码。
- 批处理文件必须使用逗号分隔的 CSV 格式提供并考虑以下处理限制：
- 不应包含注释，因为不支持注释。
- 值不能使用前导空格或尾随空格填充。
- 嵌入式逗号应处理为使用引号括住值。
- 嵌入式双引号应处理为使用引号括住值，然后用一对双引号表示。
- 每行的最大值长度为 100,000 个字符。
- 每个批处理文件应包含一个标头行，其中包含与 API NVP 协议字段名称对应的值。 请参见 NVP 参考。
- 数据文件内的字段必须遵守 API 验证规则（字段长度和格式、强制要求、唯一值等）。
- 文件内可能提供所有交易类型（授权、购买、过账、退款、取消）的记录。 但请确保这些交易类型不是与同一个订单有关，即它们不包含相同的订单识别码。 更多信息，请参见最佳做法和建议。
下方示例显示面向商家的测试批处理输入文件，使用密码作为连接到 Mastercard Gateway 的身份验证机制。
apiOperation,order.id,order.currency,transaction.id,transaction.amount,transaction.currency,sourceOfFunds.type,sourceOfFunds.provided.card.number,sourceOfFunds.provided.card.expiry.month,sourceOfFunds.provided.card.expiry.year,response.gatewayCode,result,error.cause,error.explanation,error.field,error.supportCode,error.validationType PAY,921830104177,TXID1,30,AUD,CARD,5123456789012346,05,17,,,,, PAY,921830104178,TXID1,100,AUD,CARD,5123456789012346,05,17,,,,, PAY,921830104179,TXID1,50,AUD,CARD,4987654321098769,05,17,,,,, PAY,921830104180,TXID1,90,AUD,CARD,4987654321098769,05,17,,,,, PAY,936742085167,AUD,TX1,30.00,AUD,CARD,5123456xxxxxx346,05,21,,,, PAY,936742085168,AUD,TX1,35.00,AUD,CARD,5123456xxxxxx346,05,21,,,,
基本 Batch 集成的示例代码已包括在此示例代码中。 请参见下载。
下一步是发送批处理请求。