Skip to content

批量还款确认

接口说明

批量确认还款并执行扣款

接口地址

POST /api/repay/confirm/batch

请求参数 (data 解密后)

json
{
  "transactionId": "幂等ID",
  "memberId": 1000001,
  "batchRequests": [
    {
      "orderId": 3000001,
      "outerBusinessNo": "REPAY20250113001",
      "repayType": 3,
      "repayAmount": 10100000,
      "repayInterestSubsidy": 50000,
      "repayPrincipal": 10000000,
      "repayInterest": 100000,
      "repayScene": 1,
      "repayTime": "2025-01-13 14:30:00"
    }
  ]
}

字段说明

字段名类型必填说明
transactionIdString幂等ID
memberIdLong企业ID
batchRequestsArray还款明细信息(限制200笔以内)
batchRequests[].orderIdLong融资订单ID
batchRequests[].outerBusinessNoString外部流水号(业务标识,每笔还款唯一,不可重复)
batchRequests[].repayTypeRepayType还款类型:3-结清(固定传3)
batchRequests[].repayAmountLong还款金额/分(不含溢缴款,不能小于1)
batchRequests[].repayInterestSubsidyLong还款贴息金额/分(只做记录,实际还款金额应包含贴息)
batchRequests[].repayPrincipalLong还款本金/分
batchRequests[].repayInterestLong还款利息/分
batchRequests[].repaySceneRepayScene还款场景:1-用户主动还款,2-退款自动还款
batchRequests[].repayTimeString设置还款日期(yyyy-MM-dd HH:mm:ss)

响应参数 (data 解密后)

json
{
  "code": "0",
  "message": "success",
  "data": {}
}

业务规则

  1. 还款类型只能是 3(结清),固定传3
  2. 同一批次有一笔失败,则全部失败(事务回滚)
  3. repayPrincipal、repayInterest、repayInterestSubsidy、repayTime 必填
  4. repayTime格式为 yyyy-MM-dd HH:mm:ss

粒粒通金融服务平台 API 文档