- 集成指南
- 实施 Batch 集成
- 处理批处理响应
处理批处理响应
批量操作完成后,您可以请求一个包含每个已上载操作的结果的响应文件。 您将收到 csv 格式的响应文件,其编码与批量上传请求相同。
下载批处理响应
您可以通过发送 HTTPS GET 请求至以下地址来下载批量响应:
其中:
- <versionNum> 是 Batch 的版本
- <merchantId> 是商家识别码
- <batchName> 是批处理的唯一名称
响应文件将包含与原始批量提交相同的标题和记录,并且所有字段都将被来自 API 请求的结果覆盖。
下面是 csv 格式的示例批处理响应文件的摘录,显示网关响应代码为 "APPROVED"。
"apiOperation","order.id","transaction.id","order.amount","order.currency","sourceOfFunds.type","sourceOfFunds.provided.card.number","sourceOfFunds.provided.card.expiry.month","sourceOfFunds.provided.card.expiry.year","sourceOfFunds.provided.card.number","result","error.cause","error.explanation","response.gatewayCode" "","921830104177","TXID1","30.00","AUD","CARD","512345xxxxxx2346","5","17","512345xxxxxx2346","SUCCESS","","","APPROVED" "","921830104178","TXID1","100.00","AUD","CARD","512345xxxxxx2346","5","17","512345xxxxxx2346","SUCCESS","","","APPROVED" "","921830104179","TXID1","50.00","AUD","CARD","498765xxxxxx8769","5","17","498765xxxxxx8769","SUCCESS","","","APPROVED" "","921830104180","TXID1","90.00","AUD","CARD","498765xxxxxx8769","5","17","498765xxxxxx8769","SUCCESS","","","APPROVED" "","921830104181","TXID1","45.00","AUD","CARD","345678xxxxx4564","5","17","345678xxxxx4564","SUCCESS","","","APPROVED" "","921830104182","TXID1","75.00","AUD","CARD","345678xxxxx4564","5","17","345678xxxxx4564","SUCCESS","","","APPROVED"
使用批量响应
批量响应中提供的信息基于批量上传请求中定义的参数。 您可能会发现,包含诸如 response.gatewayCode 和 error.cause 之类的参数很有用,因为它能够识别处理操作中的问题。
验证您为某个操作提供的数据是否与用于处理该操作的数据相同也是一个很好的做法。 例如,您应该检查某项操作的批量响应中返回的金额是否与您在该操作的批量请求中发送的值相匹配。