Get Payment
get
/rest/apis/customer/financials/payments/{paymentId}
Request
Path Parameters
-
paymentId(required): string
Payment ID is the system-assigned unique identifier of the payment.Example:
317896608844
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Root Schema : C1-CxPayment
Type:
Show Source
object-
_self: string
_self
-
account: object
account
-
accountCheckDigit: string
Maximum Length:
1Account Check Digit -
cancelReason: string
Maximum Length:
30If the payment is canceled, the Cancel Reason is displayed.Example:Data entry error -
characteristics: object
characteristics
-
currency: object
currency
-
Exception: object
Exception
-
isNonCISAccount: boolean
Non-CIS Account SwitchExample:
true -
isOpenItemAccounting: boolean
Open Item Accounting SwitchExample:
false -
isPayTransfer: boolean
When Payment Transfer button is clicked, the Payment Event Transfer dialog opens to transfer a payment.Example:
true -
matchType: object
matchType
Match Type and Match Value will only be used if either of the following conditions is true: The Account ID belongs to an open item customer class. In this situation, specify a Match Type to define how the payment should be matched to the customer's open-items and use Match Value to define the open-items covered by the payment The customer wants to restrict the distribution of the payment to a specific service agreement. In this situation, specify a Match Type of "service agreement ID" and a Match Value of the respective service agreement ID. Match Type and Match Value are gray after the payment is frozen.
-
matchValue: string
Maximum Length:
30Match Type and Match Value will only be used if either of the following conditions is true: The Account ID belongs to an open item customer class. In this situation, specify a Match Type to define how the payment should be matched to the customer's open-items and use Match Value to define the open-items covered by the payment The customer wants to restrict the distribution of the payment to a specific service agreement. In this situation, specify a Match Type of "service agreement ID" and a Match Value of the respective service agreement ID. Match Type and Match Value are gray after the payment is frozen. -
nextActions: array
nextActions
-
nonCisComments: string
Maximum Length:
254If the payment is linked to an Account ID that belongs to a customer class that is used for non-CIS payments, the following fields appear (note, these fields are gray after the payment is frozen): Name is the name of the person remitting the payment. Reference Number is the reference number of the item being paid. For example, the property tax reference number. Comments are used to describe anything unusual about the non-CIS payment. -
nonCisName: string
Maximum Length:
50If the payment is linked to an Account ID that belongs to a customer class that is used for non-CIS payments, the following fields appear (note, these fields are gray after the payment is frozen): Name is the name of the person remitting the payment. Reference Number is the reference number of the item being paid. For example, the property tax reference number. Comments are used to describe anything unusual about the non-CIS payment. For this one I would recommend something such as: If the payment is linked to an Account ID that belongs to a customer class that is used for non-CIS payments, the Name defines the name of the person remitting the payment.Example:ZZMXA,CX_test -
nonCisReferenceNumber: string
Maximum Length:
30If the payment is linked to an Account ID that belongs to a customer class that is used for non-CIS payments, the following fields appear (note, these fields are gray after the payment is frozen): Name is the name of the person remitting the payment. Reference Number is the reference number of the item being paid. For example, the property tax reference number. Comments are used to describe anything unusual about the non-CIS payment. -
paymentAccountCash: string
Maximum Length:
30Use Cash-Only Threshold to define the number of cash-only points a customer must have before the system warns the customer service representative accepting payments that the account is cash-only. -
paymentAmount: number
Payment Amount is the amount of the payment. This field is gray after the payment is frozen.Example:
300 -
paymentEvent: object
paymentEvent
-
paymentId: string
Maximum Length:
12Payment ID is the system-assigned unique identifier of the payment.Example:317896608844 -
paymentStatus: string
Allowed Values:
[ "10 ", "20 ", "30 ", "50 ", "60 " ]Payment Status is the payment's status. * `10 ` - Incomplete, * `20 ` - Error, * `30 ` - Freezable, * `50 ` - Frozen, * `60 ` - CanceledExample:30 -
paySegments: object
paySegments
-
transferAccountId: string
Maximum Length:
10Account ID is the account to which the payment event should be transferred. -
transferCancelReason: string
Maximum Length:
4Cancel Reason defines why you are performing the payment event transfer.Example:NSF (Non sufficient funds) -
transferMatchType: string
Maximum Length:
8Match Type and Match Value are defaulted based on their values for the payment event that you are transferring. If necessary, modify the values appropriately for the account to which you are transferring the payment event.Example:BILL-ID (Bill ID / Sequential Bill Number) -
transferMatchValue: string
Maximum Length:
30Match Type and Match Value are defaulted based on their values for the payment event that you are transferring. If necessary, modify the values appropriately for the account to which you are transferring the payment event.Example:995516242555 -
transferNonCISComment: string
Maximum Length:
254Following parameters must be specified in the Payment Event Transfer dialog to transfer a payment - Non CIS Name, Reference Number, and Non CIS Comments. Non CIS Name, Reference Number, and Non CIS Comments appear if the Account ID belongs to a customer class that is used for non-CIS payments. -
transferNonCisName: string
Maximum Length:
50Following parameters must be specified in the Payment Event Transfer dialog to transfer a payment - Non CIS Name, Reference Number, and Non CIS Comments. Non CIS Name, Reference Number, and Non CIS Comments appear if the Account ID belongs to a customer class that is used for non-CIS payments. -
transferNonCisReferenceNumber: string
Maximum Length:
30Following parameters must be specified in the Payment Event Transfer dialog to transfer a payment - Non CIS Name, Reference Number, and Non CIS Comments. Non CIS Name, Reference Number, and Non CIS Comments appear if the Account ID belongs to a customer class that is used for non-CIS payments. -
version4: number
Minimum Value:
-99999Maximum Value:99999Version
Nested Schema : account
Type:
Show Source
object-
_link: string
_link
-
accountId2: string
Maximum Length:
10Account ID
Nested Schema : currency
Type:
Show Source
object-
_link: string
_link
-
currency4: string
Maximum Length:
3Currency Code
Nested Schema : Exception
Type:
Show Source
object-
callingProgramSequence: string
Maximum Length:
254Calling Program Sequence -
comments: string
Maximum Length:
254Comments -
creationDateTime: string
(date-time)
Create Date/TimeExample:
2010-11-24T17:49:23-05:00 -
expandedMessage: string
Maximum Length:
254Expanded Message exceptionExample:The Payment is incomplete. -
isReviewed: boolean
ReviewedExample:
false -
messageCategory: object
messageCategory
Message category within Oracle Utilities Application Framework.
-
messageNumber: number
Minimum Value:
-99999Maximum Value:99999Message number within Oracle Utilities Application Framework.Example:14107 -
messageParameter1: string
Maximum Length:
2000Message Parameter -
messageParameter2: string
Maximum Length:
2000Message Parameter -
messageParameter3: string
Maximum Length:
2000Message Parameter -
messageParameter4: string
Maximum Length:
2000Message Parameter -
messageParameter5: string
Maximum Length:
2000Message Parameter -
messageParameter6: string
Maximum Length:
2000Message Parameter -
messageParameter7: string
Maximum Length:
2000Message Parameter -
messageParameter8: string
Maximum Length:
2000Message Parameter -
messageParameter9: string
Maximum Length:
2000Message Parameter -
paymentExceptionType: string
Allowed Values:
[ "10 ", "20 ", "30 ", "40 " ]Payment Exception Type * `10 ` - No Payment Segment found, * `20 ` - No SA found for this acct., * `30 ` - Unbalanced Payment, * `40 ` - Payment in errorExample:40 -
reviewedDate: string
(date)
Review Date
-
reviewUser: object
reviewUser
Review User
-
user: object
user
User
-
version2: number
Minimum Value:
0Maximum Value:0The Version number is used for internal concurrency checks.Example:1
Nested Schema : matchType
Type:
objectMatch Type and Match Value will only be used if either of the following conditions is true:
The Account ID belongs to an open item customer class. In this situation, specify a Match Type to define how the payment should be matched to the customer's open-items and use Match Value to define the open-items covered by the payment
The customer wants to restrict the distribution of the payment to a specific service agreement. In this situation, specify a Match Type of "service agreement ID" and a Match Value of the respective service agreement ID.
Match Type and Match Value are gray after the payment is frozen.
Show Source
-
_link: string
_link
-
matchType: string
Maximum Length:
8Match Type and Match Value will only be used if either of the following conditions is true: The Account ID belongs to an open item customer class. In this situation, specify a Match Type to define how the payment should be matched to the customer's open-items and use Match Value to define the open-items covered by the payment The customer wants to restrict the distribution of the payment to a specific service agreement. In this situation, specify a Match Type of "service agreement ID" and a Match Value of the respective service agreement ID. Match Type and Match Value are gray after the payment is frozen.
Nested Schema : paymentEvent
Type:
Show Source
object-
_link: string
_link
-
expMsg2: string
Maximum Length:
30Payment Event ID is the system-assigned unique identifier of the payment event.Example:317772795000 -
paymentEventId: string
Maximum Length:
12Payment Event ID is the system-assigned unique identifier of the payment event.Example:317772795000
Nested Schema : paySegments
Type:
Show Source
object-
count: number
Minimum Value:
0Maximum Value:99999Count -
distributedAmount: number
Total distributed amountExample:
75 -
paySegments: object
paySegments
Nested Schema : items
Type:
Show Source
object-
characteristicType: object
characteristicType
-
characteristicValue: object
characteristicValue
-
sequence: number
Minimum Value:
-999Maximum Value:999Sequence Controls the order in which characteristics of the same type are displayed.Example:1 -
typeOfCharacteristicValue: string
Allowed Values:
[ "ADV ", "DFV ", "FKV ", "FLV " ]Characteristic Value indicates the value of the characteristic if the characteristic type is pre-defined or foreign key reference. * `ADV ` - Adhoc Value, * `DFV ` - Predefined Value, * `FKV ` - Foreign Key Value, * `FLV ` - File Location ValueExample:02-20-2008 -
version: number
Minimum Value:
-99999Maximum Value:99999The Version number is used for internal concurrency checks.Example:20
Nested Schema : characteristicType
Type:
Show Source
object-
_link: string
_link
-
characteristicType: string
Maximum Length:
8Characteristic Type
Nested Schema : characteristicValue
Type:
Show Source
object-
_link: string
(_link)
-
value: string
(value)
-
value2: string
(value2)
-
value3: string
(value3)
-
value4: string
(value4)
-
value5: string
(value5)
Nested Schema : messageCategory
Type:
objectMessage category within Oracle Utilities Application Framework.
Show Source
-
_link: string
_link
-
messageCategory: number
Minimum Value:
-99999Maximum Value:99999Message category within Oracle Utilities Application Framework.Example:11
Nested Schema : reviewUser
Type:
objectReview User
Show Source
-
_link: string
_link
-
reviewUser: string
Maximum Length:
8Review User
Nested Schema : user
Type:
objectUser
Show Source
-
_link: string
_link
-
user: string
Maximum Length:
8User
Nested Schema : items
Type:
Show Source
object-
action: string
Allowed Values:
[ "C1CF", "C1CR", "C1DE", "C1DS", "C1FR", "C1IC", "C1RB", "C1RC", "C1RO", "C1SA", "C1SV", "C1TR", "F1CN", "F1CO", "F1GN" ]Web Service Action: * `C1CF` - Cancel Frozen, * `C1CR` - Credit Note, * `C1DE` - Delete, * `C1DS` - Distribute, * `C1FR` - Freeze, * `C1IC` - Init Cancel, * `C1RB` - Rebill, * `C1RC` - Recommend Budget, * `C1RO` - ReOpen, * `C1SA` - Submit For Approval, * `C1SV` - Save, * `C1TR` - Transfer, * `F1CN` - Cancel, * `F1CO` - Complete, * `F1GN` - Generate
Nested Schema : paySegments
Type:
Show Source
object-
_link: string
_link
-
paymentId: string
Maximum Length:
12Payment ID is the system-assigned unique identifier of the payment.Example:317896608844
400 Response
Bad Request
Root Schema : problemDetailDocument
Type:
Show Source
object-
detail: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0Maximum Value:9999The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction. -
problemType: string
Maximum Length:
60URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework. -
serverMessage: object
serverMessage
-
stackTrace: string
Maximum Length:
60The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object-
callSequence: string
Maximum Length:
60Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0Maximum Value:0Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999Maximum Value:99999Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60Name of the program that encountered the error.
500 Response
Internal Server Error
Root Schema : problemDetailDocument
Type:
Show Source
object-
detail: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0Maximum Value:9999The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction. -
problemType: string
Maximum Length:
60URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework. -
serverMessage: object
serverMessage
-
stackTrace: string
Maximum Length:
60The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object-
callSequence: string
Maximum Length:
60Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0Maximum Value:0Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999Maximum Value:99999Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60Name of the program that encountered the error.