微信支付新版转账接口中transfer_scene_report_infos字段的数组处理技巧

在go-pay/gopay项目中使用微信支付新版转账接口时，开发者可能会遇到一个常见的技术问题：如何正确传递transfer_scene_report_infos字段要求的数组格式。这个问题看似简单，但实际上涉及到JSON数据结构的正确构建和gopay库的特定使用方法。

问题背景

微信支付新版转账接口要求transfer_scene_report_infos字段必须传递一个JSON数组对象，而不是单个对象。这个字段用于上报转账场景信息，通常包含转账类型和内容描述。当开发者尝试直接传递单个对象时，微信支付服务器会返回PARAM_ERROR错误，明确指出需要JSON数组对象。

解决方案

正确的处理方式是构建一个map切片，然后通过gopay库的BodyMap进行设置。具体实现如下：

bm := make(gopay.BodyMap)

js := []map[string]string{
    {
        "info_type":    "1000",
        "info_content": "现金奖励",
    },
}

b := bm.Set("appid", "123").
    Set("out_bill_no", fmt.Sprintf("%d", 12344)).
    Set("transfer_scene_id", "1000").
    Set("openid", "xxxx").
    Set("transfer_amount", 100).
    Set("transfer_remark", "现金奖励").
    Set("notify_url", env.Get("payment.we_transfer_callback")+"/"+strconv.FormatUint(123, 10)).
    Set("transfer_scene_report_infos", js)

技术要点解析

1. 数据结构构建：使用[]map[string]string创建一个包含转账场景信息的切片，每个元素都是一个map，包含info_type和info_content键值对。

2. gopay库使用：通过BodyMap的Set方法将整个切片作为transfer_scene_report_infos的值设置进去，gopay库会自动处理为正确的JSON数组格式。

3. JSON序列化：最终生成的JSON会正确包含数组结构：

{
    "transfer_scene_report_infos": [
        {
            "info_content": "现金奖励",
            "info_type": "1000"
        }
    ]
}

常见误区

1. 直接传递单个map：开发者可能会尝试直接传递一个map对象，而不是map切片，这会导致微信支付接口报错。

2. 错误的切片类型：使用[]interface{}或其他非map类型的切片，虽然可能不会报错，但不是最佳实践。

3. 忽略gopay库的特性：有些开发者可能会尝试自己构建JSON字符串，而不是利用gopay库提供的BodyMap功能。

最佳实践建议

1. 对于需要传递数组的微信支付接口字段，总是使用切片类型。

2. 保持数据结构的一致性，使用明确的类型定义(map[string]string)而不是空接口。

3. 充分利用gopay库的BodyMap功能，它已经为微信支付接口做了优化处理。

4. 在开发过程中，可以使用fmt.Printf("%+v", bm)打印BodyMap内容，验证数据结构是否正确。

通过遵循这些实践，开发者可以避免微信支付接口参数格式错误，确保转账功能正常工作。