96 lines
3.9 KiB
YAML
96 lines
3.9 KiB
YAML
WithholdingCancelDisc:
|
||
post:
|
||
tags:
|
||
- 代扣管理
|
||
summary: 取消代扣交易
|
||
description: |
|
||
银行向公用事业单位发起的取消代扣交易请求接口。
|
||
用于取消已经发起但尚未完成的代扣交易。
|
||
|
||
## 交易码说明
|
||
- 请求交易码：CancelDisc
|
||
- 应答交易码：CancelDiscRes
|
||
|
||
## 使用场景
|
||
- 代扣交易发起后，用户要求取消
|
||
- 代扣交易异常需要撤销
|
||
- 银行系统故障需要回滚交易
|
||
|
||
## 注意事项
|
||
- 只能取消当天发起的代扣交易
|
||
- 已经成功扣款的交易不能取消，需要通过退款流程处理
|
||
- 取消成功后，相关的代扣协议仍然有效
|
||
|
||
operationId: withholdingCancelDisc
|
||
parameters:
|
||
- $ref: '../components/parameters.yaml#/components/parameters/ContentTypeHeader'
|
||
- $ref: '../components/parameters.yaml#/components/parameters/EncryptTypeHeader'
|
||
- $ref: '../components/parameters.yaml#/components/parameters/EncryptModeHeader'
|
||
- $ref: '../components/parameters.yaml#/components/parameters/DataTypeHeader'
|
||
requestBody:
|
||
required: true
|
||
content:
|
||
application/xml:
|
||
schema:
|
||
$ref: '../components/schemas.yaml#/components/schemas/WithholdingCancelDiscRequest'
|
||
example: |
|
||
<?xml version="1.0" encoding="GBK"?>
|
||
<in>
|
||
<Version>1.0.1</Version>
|
||
<InstId>00001</InstId>
|
||
<TranCode>CancelDisc</TranCode>
|
||
<TranDate>20240101</TranDate>
|
||
<TranSeq>123456789012</TranSeq>
|
||
<billKey>123456</billKey>
|
||
<companyId>654321</companyId>
|
||
<originalTranSeq>ORIG123456789012</originalTranSeq>
|
||
<originalTranDate>20240101</originalTranDate>
|
||
<cancelReason>用户申请取消</cancelReason>
|
||
<contractNo>CONTRACT001</contractNo>
|
||
<payAmount>15000</payAmount>
|
||
</in>
|
||
application/json:
|
||
schema:
|
||
$ref: '../components/schemas.yaml#/components/schemas/WithholdingCancelDiscRequest'
|
||
responses:
|
||
'200':
|
||
description: 取消代扣交易成功
|
||
headers:
|
||
Content-Type:
|
||
$ref: '../components/headers.yaml#/components/headers/ContentType'
|
||
X-Response-Time:
|
||
$ref: '../components/headers.yaml#/components/headers/ResponseTime'
|
||
X-Request-Id:
|
||
$ref: '../components/headers.yaml#/components/headers/RequestId'
|
||
content:
|
||
application/xml:
|
||
schema:
|
||
$ref: '../components/schemas.yaml#/components/schemas/WithholdingCancelDiscResponse'
|
||
example: |
|
||
<?xml version="1.0" encoding="GBK"?>
|
||
<out>
|
||
<Version>1.0.1</Version>
|
||
<InstId>00001</InstId>
|
||
<TranCode>CancelDiscRes</TranCode>
|
||
<TranDate>20240101</TranDate>
|
||
<TranSeq>123456789012</TranSeq>
|
||
<RespCode>AAAAAAA</RespCode>
|
||
<RespMessage>取消代扣交易成功</RespMessage>
|
||
<billKey>123456</billKey>
|
||
<companyId>654321</companyId>
|
||
<originalTranSeq>ORIG123456789012</originalTranSeq>
|
||
<cancelStatus>1</cancelStatus>
|
||
<cancelTime>20240101120000</cancelTime>
|
||
</out>
|
||
application/json:
|
||
schema:
|
||
$ref: '../components/schemas.yaml#/components/schemas/WithholdingCancelDiscResponse'
|
||
'400':
|
||
$ref: '../components/responses.yaml#/components/responses/BusinessError'
|
||
'500':
|
||
$ref: '../components/responses.yaml#/components/responses/SystemError'
|
||
'403':
|
||
$ref: '../components/responses.yaml#/components/responses/SecurityError'
|
||
security:
|
||
- ApiKeyAuth: []
|
||
- EncryptedData: [] |