Get a Deposit Transaction by ID
get
/bcws/webresources/v1.0/depositManagement/depositTxn/{id}
Gets the specified deposit transaction.
Request
Path Parameters
-
id(required): string
The deposit transaction ID, for example: 0.0.0.1+-event-billing-payment-cash+123456789123456789
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
The deposit transaction details were returned successfully.
Root Schema : depositTxn
Type:
Show Source
object
-
balanceImpacts(required): array
balanceImpacts
-
createdAt(required): string
The date when the deposit transaction event is created.
-
depositDetails(required): array
depositDetails
-
depositInfo(required): array
depositInfo
-
descr(required): string
The deposit transaction event description.
-
href(required): string
The unique resource URL, used to get the deposit transaction event.
-
id(required): string
The deposit transaction event ID.
-
modifiedAt(required): string
The date when the deposit transaction event is modified.
-
notes(required): array
notes
-
payment: object
DepositTxnPayment
-
quantity: number
The quantity of the deposit transaction event.
-
startsAt(required): string
The start date of the deposit transaction event.
-
systemEvent(required): string
The system event of the deposit transaction event.
-
txnType(required): string
The transaction type of the deposit transaction event.
Nested Schema : DepositTxnPayment
Type:
Show Source
object
-
completedAt(required): string
The date when the deposit payment is completed.
-
createdAt(required): string
The date when the deposit payment is created.
-
customerDepositRef(required): string
The deposit reference.
-
customerRef(required): string
The customer reference.
-
glCode(required): string
The general ledger code for the deposit payment.
-
href(required): string
The unique resource URL, used to get the deposit payment.
-
id(required): string
The deposit payment ID.
-
notes(required): string
The notes for the deposit payment.
-
paymentAmount(required): object
Money
-
paymentMethodType: integer
(int32)
The payment method type. Allowed Values:
- 10003 (Credit card)
- 10005 (Direct debit)
- 10011 (Cash)
- 10012 (Check)
- 10013 (Wire Transfer)
- 10014 (Inter-bank payment order)
- 10015 (Postal order)
- 3 (Prepayment)
- 4 (Other)
-
paymentRef(required): string
The payment reference.
-
status: integer
(int32)
The deposit payment transaction status. Allowed Values:
- 1 (Completed)
- 2 (Failed)
- 3 (Pending)
Nested Schema : DepositTxnBalanceImpacts
Type:
Show Source
object
-
amount(required): object
Money
-
discountAmount(required): object
Money
-
resourceId(required): string
The balance impact's resource ID.
-
tax(required): object
Money
Nested Schema : Money
Type:
Show Source
object
-
amount(required): number
The amount of money.
-
currency: integer
(int32)
The currency for the money.
Nested Schema : DepositTxnDepositDetails
Type:
Show Source
object
-
depositRef(required): string
The deposit reference.
-
destDepositRef(required): string
The destination deposit reference.
-
sourceDepositRef(required): string
The source deposit reference.
Nested Schema : DepositTxnDepositInfo
Type:
Show Source
object
-
amount: object
Money
-
billInfoRef(required): string
The bill reference.
-
customerRef(required): string
The customer reference.
-
dayOfWeek: integer
(int32)
The day of the week.
-
serviceRef(required): string
The service reference.
-
toBillInfoRef(required): string
The bill reference to which the transaction is made.
-
toServiceRef(required): string
The service reference to which the transaction is made.
Nested Schema : DepositTxnNotes
Type:
Show Source
object
-
createdAt(required): string
The date when the deposit transaction note is created.
-
id(required): string
The deposit transaction note ID.
-
modifiedAt(required): string
The date when the deposit transaction note is modified.
-
note(required): string
The deposit transaction note.
500 Response
An error occurred. An exception has been raised.
Examples
This example shows how to get a deposit transaction by submitting a GET request on the REST resource using cURL. For more information about cURL, see "Use cURL".
cURL Command
curl -X GET 'http://hostname:port/bcws/webresources/version/depositManagement/depositTxn/0.0.0.1+-event-billing-item-transfer+332984897451942258'
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.
Example of Response Body
This example shows the contents of the response body in JSON format.
{
"id": "0.0.0.1+-event-billing-item-transfer+332984897451942258",
"href": "http://hostname:port/bcws/webresources/version/depositManagement/depositTxn/0.0.0.1+-event-billing-item-transfer+332984897451942258",
"txnType": "Billing Change Item Event",
"descr": "",
"createdAt": "2021-10-28T07:10:56.000Z",
"modifiedAt": "2021-10-28T07:10:56.000Z",
"quantity": 0,
"depositInfo": [{
"amount": {
"amount": 36
}
}
]
}