Create a set of refund data
post
/fscmRestApi/resources/11.13.18.05/publicSectorPaymentRefunds
Request
Supported Media Types
- application/vnd.oracle.adf.resourceitem+json
- application/json
The following table describes the body parameters in the request for this task.
Root Schema : publicSectorPaymentRefunds-item
Type:
Show Source
object
-
AgencyId(optional):
integer(int32)
The unique identifier of the agency associated with the refund transaction.
-
EmailId(optional):
string
Maximum Length:
100
Email ID used in the original payment transaction or new email ID if allowed by the agency. -
links(optional):
array Items
Title:
Items
Link Relations -
PartyId(optional):
integer(int64)
Party ID from the original payment transaction or a new party if allowed by the agency.
-
PaymentAmount(optional):
number
Total amount of the original payment.
-
PaymentCurrency(optional):
string
Maximum Length:
3
Currency code used for the original payment transaction. -
PaymentDate(optional):
string(date)
Payment date on which the original payment transaction occurred.
-
PaymentMethodCode(optional):
string
Maximum Length:
30
Payment method code used for the original payment transaction. -
PaymentReferenceId(optional):
string
Maximum Length:
50
Payment reference of the original payment for which the refund is requested. -
ProfileId(optional):
integer(int64)
Profile ID from the original payment transaction or a new profile ID if allowed by the agency.
-
RefundAmount(optional):
number
Total refund amount processed by the payment gateway or trust account system.
-
RefundCurrency(optional):
string
Maximum Length:
3
Typically, the same currency used for the payment. -
RefundDate(optional):
string(date)
Date on which the refund was requested.
-
RefundDttm(optional):
string(date-time)
Date and time when the refund was processed.
-
RefundFailureCode(optional):
string
Maximum Length:
100
Failure code returned by the payment gateway. -
RefundHistoryKey(optional):
integer(int64)
The unique identifier for the refund transaction.
-
RefundHistoryLine(optional):
array Payment Refund Lines
Title:
Payment Refund Lines
The payment refunds resource is used to view or create payment refunds. -
RefundMethodCode(optional):
string
Maximum Length:
30
Refund method code. Defaults to the payment method code used in the original payment transaction. -
RefundReasonCode(optional):
string
Maximum Length:
20
Reason code for the refund passed by the fee source application. -
RefundReferenceId(optional):
string
Maximum Length:
50
Combination value consisting of the RE- prefix and the value using the PSC GUID function. This value is passed to the calling application and displayed to the user. -
RefundReferencePrimary(optional):
string
Maximum Length:
50
Pass through reference data from calling app. Should not contain PII information. -
RefundReferenceSecondary(optional):
string
Maximum Length:
50
Additional pass through reference data from calling app. Should not contain PII information. -
RefundRequestCode(optional):
string
Maximum Length:
50
Refund code or reference value returned by the payment gateway. -
RefundStatus(optional):
string
Maximum Length:
10
The status of the refund. Values are pending, refunded or failed. -
RefundTransactionId(optional):
string
Maximum Length:
50
Transaction ID received from the payment gateway, trust account system, or accounts payable system. -
RefundType(optional):
string
Maximum Length:
10
Either chargeback (referenced transaction to the same payment method) or refund (referenced transaction but using a different payment method). -
ResponseMessageAdditional(optional):
string
Maximum Length:
100
Response message returned by the payment gateway. -
ResponseMessagePrimary(optional):
string
Maximum Length:
100
Response message returned by the payment gateway. -
ResponseMessageSecondary(optional):
string
Maximum Length:
100
Response message returned by the payment gateway.
Nested Schema : Payment Refund Lines
Type:
array
Title:
Payment Refund Lines
The payment refunds resource is used to view or create payment refunds.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href(optional):
string
Title:
hyperlink reference
The URI to the related resource. -
rel(optional):
string
Title:
relation
The name of the relation to the resource instance. Example: self.
Nested Schema : publicSectorPaymentRefunds-RefundHistoryLine-item
Type:
Show Source
object
-
AgencyId(optional):
integer(int32)
The unique identifier of the agency associated with the refund transaction.
-
Classification(optional):
string
Maximum Length:
3
Source application that generated the fee. -
ItemDescription(optional):
string
Maximum Length:
100
Item description used for the original payment for this item. -
ItemLine(optional):
integer(int32)
Item line used for the original payment for this item.
-
ItemName(optional):
string
Maximum Length:
30
Item name used for the original payment for this item. -
ItemPaymentAmount(optional):
number
Payment amount from the original payment transaction for this item.
-
ItemPaymentCurrency(optional):
string
Maximum Length:
3
Currency code used from the original payment transaction for this item. -
ItemRefundAmount(optional):
number
Refund amount.
-
ItemRefundCurrency(optional):
string
Maximum Length:
3
Refund currency. -
ItemRefundReferencePrimary(optional):
string
Maximum Length:
50
Attribute identifying item level reference value provided by the refund source application. -
ItemRefundReferenceSecondary(optional):
string
Maximum Length:
50
Additional attribute identifying item level reference value provided by the refund source application. -
links(optional):
array Items
Title:
Items
Link Relations -
RecordId(optional):
string
Maximum Length:
50
Source application's record ID identifier. -
RecordTypeId(optional):
string
Maximum Length:
30
Source application's record type identifier. -
RefundHistoryKey(optional):
integer(int64)
Parent history key.
-
RefundRecordKey(optional):
integer(int32)
Auto-sequencing generated value for the unique identification of each line row.
Response
Supported Media Types
- application/vnd.oracle.adf.resourceitem+json
- application/json
Default Response
The following table describes the default response for this task.
Root Schema : publicSectorPaymentRefunds-item
Type:
Show Source
object
-
AgencyId(optional):
integer(int32)
The unique identifier of the agency associated with the refund transaction.
-
EmailId(optional):
string
Maximum Length:
100
Email ID used in the original payment transaction or new email ID if allowed by the agency. -
links(optional):
array Items
Title:
Items
Link Relations -
PartyId(optional):
integer(int64)
Party ID from the original payment transaction or a new party if allowed by the agency.
-
PaymentAmount(optional):
number
Total amount of the original payment.
-
PaymentCurrency(optional):
string
Maximum Length:
3
Currency code used for the original payment transaction. -
PaymentDate(optional):
string(date)
Payment date on which the original payment transaction occurred.
-
PaymentMethodCode(optional):
string
Maximum Length:
30
Payment method code used for the original payment transaction. -
PaymentReferenceId(optional):
string
Maximum Length:
50
Payment reference of the original payment for which the refund is requested. -
ProfileId(optional):
integer(int64)
Profile ID from the original payment transaction or a new profile ID if allowed by the agency.
-
RefundAmount(optional):
number
Total refund amount processed by the payment gateway or trust account system.
-
RefundCurrency(optional):
string
Maximum Length:
3
Typically, the same currency used for the payment. -
RefundDate(optional):
string(date)
Date on which the refund was requested.
-
RefundDttm(optional):
string(date-time)
Date and time when the refund was processed.
-
RefundFailureCode(optional):
string
Maximum Length:
100
Failure code returned by the payment gateway. -
RefundHistoryKey(optional):
integer(int64)
The unique identifier for the refund transaction.
-
RefundHistoryLine(optional):
array Payment Refund Lines
Title:
Payment Refund Lines
The payment refunds resource is used to view or create payment refunds. -
RefundMethodCode(optional):
string
Maximum Length:
30
Refund method code. Defaults to the payment method code used in the original payment transaction. -
RefundReasonCode(optional):
string
Maximum Length:
20
Reason code for the refund passed by the fee source application. -
RefundReferenceId(optional):
string
Maximum Length:
50
Combination value consisting of the RE- prefix and the value using the PSC GUID function. This value is passed to the calling application and displayed to the user. -
RefundReferencePrimary(optional):
string
Maximum Length:
50
Pass through reference data from calling app. Should not contain PII information. -
RefundReferenceSecondary(optional):
string
Maximum Length:
50
Additional pass through reference data from calling app. Should not contain PII information. -
RefundRequestCode(optional):
string
Maximum Length:
50
Refund code or reference value returned by the payment gateway. -
RefundStatus(optional):
string
Maximum Length:
10
The status of the refund. Values are pending, refunded or failed. -
RefundTransactionId(optional):
string
Maximum Length:
50
Transaction ID received from the payment gateway, trust account system, or accounts payable system. -
RefundType(optional):
string
Maximum Length:
10
Either chargeback (referenced transaction to the same payment method) or refund (referenced transaction but using a different payment method). -
ResponseMessageAdditional(optional):
string
Maximum Length:
100
Response message returned by the payment gateway. -
ResponseMessagePrimary(optional):
string
Maximum Length:
100
Response message returned by the payment gateway. -
ResponseMessageSecondary(optional):
string
Maximum Length:
100
Response message returned by the payment gateway.
Nested Schema : Payment Refund Lines
Type:
array
Title:
Payment Refund Lines
The payment refunds resource is used to view or create payment refunds.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href(optional):
string
Title:
hyperlink reference
The URI to the related resource. -
rel(optional):
string
Title:
relation
The name of the relation to the resource instance. Example: self.
Nested Schema : publicSectorPaymentRefunds-RefundHistoryLine-item
Type:
Show Source
object
-
AgencyId(optional):
integer(int32)
The unique identifier of the agency associated with the refund transaction.
-
Classification(optional):
string
Maximum Length:
3
Source application that generated the fee. -
ItemDescription(optional):
string
Maximum Length:
100
Item description used for the original payment for this item. -
ItemLine(optional):
integer(int32)
Item line used for the original payment for this item.
-
ItemName(optional):
string
Maximum Length:
30
Item name used for the original payment for this item. -
ItemPaymentAmount(optional):
number
Payment amount from the original payment transaction for this item.
-
ItemPaymentCurrency(optional):
string
Maximum Length:
3
Currency code used from the original payment transaction for this item. -
ItemRefundAmount(optional):
number
Refund amount.
-
ItemRefundCurrency(optional):
string
Maximum Length:
3
Refund currency. -
ItemRefundReferencePrimary(optional):
string
Maximum Length:
50
Attribute identifying item level reference value provided by the refund source application. -
ItemRefundReferenceSecondary(optional):
string
Maximum Length:
50
Additional attribute identifying item level reference value provided by the refund source application. -
links(optional):
array Items
Title:
Items
Link Relations -
RecordId(optional):
string
Maximum Length:
50
Source application's record ID identifier. -
RecordTypeId(optional):
string
Maximum Length:
30
Source application's record type identifier. -
RefundHistoryKey(optional):
integer(int64)
Parent history key.
-
RefundRecordKey(optional):
integer(int32)
Auto-sequencing generated value for the unique identification of each line row.