Update a Deposit Refund Request
patch
/bcws/webresources/v1.0/depositManagement/depositRefund/{id}
Updates the specified deposit refund request.
Request
Path Parameters
-
id(required): string
The deposit refund ID, for example: 0.0.0.1+-deposit_refund+1234567
Supported Media Types
- application/xml
- application/json
Root Schema : schema
Type:
Show Source
object
-
accountNumber(required): string
The account number.
-
approvedRefundAmount: object
Money
-
completedAt(required): string
The deposit refund completion date.
-
createdAt(required): string
The date when the deposit refund is initiated.
-
customerDepositRef(required): string
The customer deposit reference.
-
customerRef(required): string
The customer reference.
-
error(required): string
Error message for the deposit refund.
-
glCode(required): string
The general ledger ID.
-
href(required): string
The unique resource URL, used to get the object.
-
id(required): string
The deposit refund ID.
-
modifiedAt(required): string
The date when the deposit refund is modified.
-
notes(required): string
Notes about the deposit refund.
-
reason(required): string
Reason for the deposit refund.
-
refundAmount: object
Money
-
refundRef(required): string
The deposit refund reference.
-
serviceRef(required): string
The service reference.
-
status: integer
(int32)
The deposit refund status. Allowed Values:
- 0 (Completed)
- 1 (Failed)
- 2 (Pending)
- 3 (Accepted)
- 4 (Rejected)
Nested Schema : Money
Type:
Show Source
object
-
amount(required): number
The amount of money.
-
currency: integer
(int32)
The currency for the money.
Root Schema : schema
Type:
Show Source
object
-
accountNumber(required): string
The account number.
-
approvedRefundAmount: object
Money
-
completedAt(required): string
The deposit refund completion date.
-
createdAt(required): string
The date when the deposit refund is initiated.
-
customerDepositRef(required): string
The customer deposit reference.
-
customerRef(required): string
The customer reference.
-
error(required): string
Error message for the deposit refund.
-
glCode(required): string
The general ledger ID.
-
href(required): string
The unique resource URL, used to get the object.
-
id(required): string
The deposit refund ID.
-
modifiedAt(required): string
The date when the deposit refund is modified.
-
notes(required): string
Notes about the deposit refund.
-
reason(required): string
Reason for the deposit refund.
-
refundAmount: object
Money
-
refundRef(required): string
The deposit refund reference.
-
serviceRef(required): string
The service reference.
-
status: integer
(int32)
The deposit refund status. Allowed Values:
- 0 (Completed)
- 1 (Failed)
- 2 (Pending)
- 3 (Accepted)
- 4 (Rejected)
Nested Schema : Money
Type:
Show Source
object
-
amount(required): number
The amount of money.
-
currency: integer
(int32)
The currency for the money.
Response
201 Response
The deposit refund request was updated successfully, and the ID of the updated deposit refund request was returned.
500 Response
An error occurred. An exception has been raised.
Examples
This example shows how to update a deposit refund request by submitting a PUT request on the REST resource using cURL. For more information about cURL, see "Use cURL".
cURL Command
curl -X PUT 'http://hostname:port/bcws/webresources/version/depositManagement/depositRefund/0.0.0.1+-deposit_refund_request+2619159' -H 'content-type: application/json' -d @updateDepositRefund.json
where:
- hostname is the URL for the Billing Care REST server.
- port is the port for the Billing Care REST server.
- version is the version of the API you're using, such as v1.0.
- updateDepositRefund.json is the JSON file that specifies the details to update.
Example of Request Body
This example shows the contents of the updateDepositRefund.json file sent as the request body.
{
"customerDepositRef": "0.0.0.1+-purchased_deposit+2172776+0",
"refundAmount": {
"amount": 10,
"currency": "INR"
},
"status": "REJECT",
"notes": "Deposit refund request rejected"
}
Example of Response Body
This example shows the contents of the response body in JSON format.
{
"id": " 0.0.0.1+-deposit_refund_request+2619159",
"href": "http://hostname:port/bcws/webresources/version/depositManagement/depositRefund/0.0.0.1+-deposit_refund_request+2619159"
}