【注意】
来源系统流水号(sourceFlowNumber 来源系统流水号)是每笔交易的唯一编号,是防止重复提交的重要手段,如需重复发送请求,请务必保证同一笔交易的来源系统流水号不变,否则会存在重复提交风险。报文结果判断逻辑:当返回报文head节点中resultcode字段为0时,表明请求已经被资金系统成功接收,不代表业务处理成功,业务处理结果请调用查询接口进行判断。返回其他错误码时,如果是查询类的请求可以直接重发,如果是经办类请求请先调用相应业务的查询接口判断之前请求是否有成功送达银行,确认没有记录后可以重发之前的请求,请注意:重发时请保证请求报文里面的业务参考号字段和之前请求里面的业务参考号一致(有特殊说明的接口除外),否则存在重复提交的风险。其他错误代码的描述请参见resultmsg的错误描述。【概述】
企业业务系统(如:OA系统、ERP系统)以及财务系统(如:应付模块发起付款)通过“单笔支付创建”API可向集团企业内部单位或外部其它企事业单位进行付款,本API支持各国家地区境内单笔支付、跨境单笔支付。允许客户在资金平台设置审批流程,待审批人员完成审批后(如设置审批流程),才能发起支付。允许客户在资金平台设置自动支付流程,系统在可无人值守情况下自动完成支付整个过程,若处理过程出现异常情况,交易落地处理,由出纳手动操作完成支付。【注意事项】
(1)客户支付时,应避开日切点时进行支付,避免有交易因为日切而失败。通常银行日切时点是:22:00--2:00,若实际银行日切时点有差异,请和对接银行确认。(2)请求报文字段(sourceFlowNumber 来源系统流水号)用于标识该笔交易指令级别的唯一编号,同时该信息作为支付流水号传递到银行。字段(sourceNoteCode 来源系统单据号)用于标识该笔交易业务单据唯一编号,便于出纳通过单据号在业务系统查找并核对原单信息(3)“创建单笔支付”接口支持公对私支付,但需要考虑人行反洗钱监管要求。使用对公支付接口进行对私支付业务时,必须是付款企业同个人间正常的业务往来,且交易摘要应该要说明公转私用途,或对接具体的批量支付(批量代发)、工资代发接口。如果是企业的员工报销、福利发放、补 贴发放之类,建议企业对接批量支付(批量代发)接口进行。(4)“创建单笔支付”请求接口返回的成功结果仅代表“交易数据提交成功”,由资金系统异步通知支付结果(见:支付结果通知API),或企业业务系统调用“查询单笔支付”API接口查询支付结果,若查询出来状态不是终态的,说明资金正在落地处理中(如:出纳在补填或调整收款方开户行信息,复核岗正在核实支付信息,或者支付指令已提交到银行,银行端正在落地处理),不要让系统自动做“超时失败”设定!对于支付效率方面,每个银行的支付效率是不统一的,有个别城商行农信社支付需要人工落地处理,导致支付结果反馈时间较长,可能要接近日终才会展现,因此建议客户可在日终通过查询单笔支付结果再次获取支付结果,或者查询日终账户明细检查交易是否已完成,对于退票情况,资金系统检查账户明细自动识别退票交易,由出纳、复核岗确认后完成结果反馈。【对接接口】
1.创建单笔支付:调用此接口创建单笔支付交易单
2.撤销单笔支付:调用此接口撤回创建的单笔交易单,前提是交易单未支付
3.查询单笔支付:调用此接口查询支付结果
4.支付结果通知:资金平台支付结果(支付成功、支付失败、退票)从银行查回后,调用业务系统接口推送支付结果