更新结算信息

2025-01-08 07:28

使用接口更新二级商户结算银行账户信息的流程如下：

图 1. 二级商户结算信息更新流程

二级商户向平台商提交新的结算银行信息。
平台商通过调用 更新结算信息 接口提交二级商户结算银行信息更新的请求。
Antom 向平台商返回结算信息更新申请结果。
平台商告知二级商户银行信息更新结果。
Antom 审核更新后的结算银行信息材料，审核时间预计 5 分钟。
审核完成后，Antom 通过异步通知告知平台商二级商户结算银行信息是否更新成功。
平台商通知二级商户结算银行信息更新结果。

提交更新结算信息请求

平台商可以通过 更新结算信息 接口提交二级商户结算银行信息请求，在请求中需要传入需更新结算银行账号的二级商户信息 referenceMerchantId、及新的结算银行信息 settlementBankAccount。

更新结算信息请求样例：

copy
{
    "settlementBankAccount": {
        "routingNumber": "123",
        "bankBranchCode": "0001",
        "bankRegion": "BR",
        "bankAccountNo": "123456765****",
        "swiftCode": "AAAAAABRAAA",
        "accountHolderType": "INDIVIDUAL",
        "accountHolderName": "Timi",
        "cardTIN": "1234567****",
        "accountType": "CC"
    },
    "settlementCurrency": "BRL",
    "updateRequestId": "up_cangxi_lj_20230618_225515****",
    "referenceMerchantId": "mid_cangxi_lj_20230615_211451****"
}

该接口的响应仅表示更新二级商户结算信息请求的申请结果，实际结算信息的更新结果请以异步通知或查询接口返回为准。

更新结算信息响应样例：

copy
{
    "updateStatus": "PROCESSING",
    "result": {
        "resultCode": "SUCCESS",
        "resultMessage": "success.",
        "resultStatus": "S"
    }
}

获取结算信息变更通知

在更新结算信息请求提交之后，Antom 系统通常会在五分钟内处理完毕，并通过异步通知 通知结算信息更新 告知二级商户的结算银行信息变更结果。

异步通知的地址需要平台商在开发者中心进行设定。在 Antom Dashboard 的 Integration Settings 标签页下，编辑 Notification URL。

结算银行信息更新成功的异步通知样例如下：

copy
{
    "notifyType": "SETTLEMENT_INFO_UPDATE_RESULT",
    "updateRequestId": "UPDATE_2023061813584****",
    "referenceMerchantId": "MERCHANT_2023061813584****",
    "updateStatus":"SUCCESS"
}

结算银行信息更新失败的异步通知样例如下：

copy
{
    "notifyType": "SETTLEMENT_INFO_UPDATE_RESULT",
    "updateRequestId": "UPDATE_2023061813584****",
    "referenceMerchantId": "MERCHANT_2023061813584****",
    "updateStatus":"FAILED"
    "reasonCode": "REJECT_FOR_RISK",
    "reasonMessage": "The settlement information update is rejected because of risk control."
}

如果结算信息更新失败，可以根据返回的 reasonCode 和 reasonMessage 来了解更新失败的原因并做响应处理。

收到 Antom 的异步通知后，需要您按照如下规定格式返回响应。若未按要求响应异步通知，或者因为网络原因异步通知未送达，通知会在 24 小时内自动重发。通知至多重发 8 次或直至收到正确响应终止发送。发送间隔如下：0分钟，2分钟，10分钟，10分钟，1小时，2小时，6小时，15小时。

copy
{
    "result": {
        "resultStatus": "S",
        "resultCode": "SUCCESS",
        "resultMessage": "success."
    }
}