好的收款接口及相应的说明文档

需要对接一个接口时，一般先要阅读这个接口的文档，一个好的收款接口及相应的说明文档应该包含以下几个方面：

接口作用描述	描述这个收款支付接口的一般使用场景，给阅读者一个整体概念。
整体调用过程描述	描述这个收款支付接口的在各种情况下如何调用其他相关后续接口。比如收款检测接口，退款接口等
输入参数作用描述	描述这个收款接口所有输入参数的要求和作用。
不同场景输入参数举例	对不同场景下输入参数的举例，让阅读者有直观认识。
返回参数完整，说明清晰	描述这个接口的所有返回参数的作用，并且保证返回参数能够满足所有业务方的需要。
返回结果判定依据清晰	根据返回参数能够清晰准确地判断当前支付请求的状态。
错误码表完整，说明清晰	有完整的错误码及相应描述，既便于调用方能够根据错误码进行相应的后续处理，还能提高对接开发效率。
有相应支付检测接口	有支付检测接口可以随时查询当前支付请求的状态
有代码Demo供参考	降低开发者的入门难度，提高对接开发效率。

收款检测接口及相应的说明文档应该包含以下几个方面：

输入参数完整	检测的输入参数支持使用商户订单号及第三方订单号
返回参数完整，说明清晰	描述这个接口的所有返回参数的作用，并且保证返回参数能够满足所有业务方的需要。
返回结果判定依据清晰	根据返回参数能够清晰准确地判断当前支付请求的状态。
错误码表完整，说明清晰	有完整的错误码及相应描述，既便于调用方能够根据错误码进行相应的后续处理，还能提高对接开发效率。
有代码Demo供参考	降低开发者的入门难度，提高对接开发效率。