- 集成指南
- 实施 Batch 集成
- 检索批处理状态
检索批处理状态
提交批处理后,您可以定期请求批处理状态以确定批处理的当前状态,包括已上载、已处理和已递延操作的总数以及处理操作的时间和日期戳。 相同批处理状态还通过 Merchant Manager 中的 Batch 状态搜索屏幕对 your payment service provider 可见。
批次状态请求
您可以通过发送 HTTPS GET 请求至以下地址来按需请求批处理状态:
其中:
- <versionNum> 是 Batch 的版本
- <merchantId> 是商家识别码
- <batchName> 是批处理的唯一名称
批次状态响应
响应主体将包含 csv 格式的处理摘要,其中包含一个标题行和一个详细信息行。
显示批处理状态为"COMPLETE"的 csv 格式的示例批处理状态摘要文件。
"merchantId","batchName","totalRecords","uploadCompleted","batchStatus","processed","errors","lastAction","processingCompleted" "TESTMERCHANT","testfile20110818a","46","2011-08-18T10:40:20+10:00","COMPLETE","46","0","2011-09-11T02:36:10+10:00","2011-08-18T10:40:30+10:00"
下表描述了批处理响应文件中返回的信息。
merchantId |
商家’的唯一字母数字标识符。 每个商家账户/配置文件都有一个唯一的商家 ID。 |
batchName |
初始上传时使用的批处理文件名。 |
totalRecords |
批处理中操作的总数。 |
uploadCompleted |
完成上载所有记录的日期和时间。 |
batchStatus |
当前批处理过程的状态。 有效值为︰
|
processed |
处理的记录总数。 |
errors |
超时或因系统错误而无法处理的记录总数。 |
lastAction |
上次操量操作的日期和时间。 |
processingCompleted |
批处理完成且所有记录处于最终状态的时间和日期。 |
下一步是处理批处理响应。