Get payment chargeback details
post
/bi/v1/{orgIdentifier}/getPaymentChargebacks
First Available Version: 20.1.11
Gets payment transaction records for the given record date and location. This API only returns data for customers using Oracle MICROS Payment Cloud Service.
Request
Path Parameters
-
orgIdentifier(required): string
Unique identifier of the organization name
The request body defines the details of the API request.
Root Schema : paymentChargebacksPayload
Type:
object
Request payload for payment chargeback details
Show Source
-
applicationName:
string
Title:
Application name
Maximum Length:128
The name of the application which is accessing the API -
include:
string
Title:
Include
Maximum Length:2000
List of objects to include in response -
locRef(required):
string
Title:
Location reference
Maximum Length:99
The location reference, this may be a store number or name depending on the organization -
recordDt(required):
string(date)
Title:
Record date
The record date associated with the transactions -
searchCriteria:
string
Title:
Search criteria
Maximum Length:2000
Search criteria to filter results based on field value
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : paymentChargebacksDimensions
Type:
object
The response body contains information about the payment chargebacks.
Show Source
-
accounts(required):
array accounts
An array of accounts
-
locRef(required):
string
Title:
Location reference
Maximum Length:99
The location reference, this may be a store number or name depending on the organization -
recordDt(required):
string(date)
Title:
Chargeback record date
The record date associated with the chargeback transactions
Nested Schema : accounts
Type:
array
An array of accounts
Show Source
-
Array of:
object paymentChargebacksAccounts
The response body contains information about the accounts.
Nested Schema : paymentChargebacksAccounts
Type:
object
The response body contains information about the accounts.
Show Source
-
acctCode(required):
string
Title:
Account code
Maximum Length:50
Unique code of the account -
revenueCenters(required):
array revenueCenters
An array of revenue centers
Nested Schema : revenueCenters
Type:
array
An array of revenue centers
Show Source
-
Array of:
object paymentChargebacksRevenueCenters
The response body contains information about the payment chargebacks revenue centre.
Nested Schema : paymentChargebacksRevenueCenters
Type:
object
The response body contains information about the payment chargebacks revenue centre.
Show Source
-
chargebacks(required):
array chargebacks
An array of chargebacks
-
rvcNum(required):
integer
Title:
Revenue center number
Maximum Length:10
Revenue center number
Nested Schema : chargebacks
Type:
array
An array of chargebacks
Show Source
-
Array of:
object paymentChargebackschargebacks
The response body contains information about the payment chargebacks.
Nested Schema : paymentChargebackschargebacks
Type:
object
The response body contains information about the payment chargebacks.
Show Source
-
autodefense(required):
boolean
Title:
Is transaction autodefended
Was the transaction autodefended by the payment service provider (PSP) -
busDt(required):
string(date)
Title:
Business date
The business date associated with the transaction -
checkNum(required):
integer
Title:
Check number
Maximum Length:10
Number of the check related to the transaction -
chgbkRsnCode(required):
string
Title:
Chargeback reason code
Maximum Length:30
Chargeback reason code -
chgbkSchemeCode(required):
string
Title:
Card scheme
Maximum Length:30
Card scheme -
currStatus(required):
Boolean
Title:
Chargeback status
Indicates if this record is the current status of the chargeback. Downstream systems should reset the current status flag of prior records to "false" -
disputeAmt(required):
number
Title:
Amount charged-back
Amount charged-back -
disputeCur(required):
string
Title:
Currency of the transaction
Maximum Length:3
Currency of the transaction -
disputeEndUTC(required):
string(date-time)
Title:
End of the dispute defense period
Date and time of day when dispute defense period ended -
disputePspRef(required):
string
Title:
Chargeback reference
Maximum Length:256
PSP reference of the chargeback transaction -
disputeRsn(required):
string
Title:
Chargeback reason description
Maximum Length:256
Chargeback reason description -
disputeUTC(required):
string(date-time)
Title:
Dispute date and time
The UTC Date and time of when the chargeback transaction was initiated -
guestCheckID(required):
integer
Title:
Guest check identifier
Maximum Length:16
Unique identifier of the guest check -
guestCheckLineItemId(required):
integer
Title:
Guest check line item identifier
Maximum Length:16
Unique identifier of the guest check line item -
modPspRef(required):
string
Title:
Modification reference provided by the PSP
Maximum Length:80
This is the modification reference provided by the PSP, a unique ID that identifies the modification request, if applicable. -
pmntType(required):
string
Title:
Type of the payment
Maximum Length:30
Type of the payment. Possible values: PAY, VOID, CANCEL, REFUND, ADJUSTMENT -
pspRef(required):
string
Title:
Transaction reference
Maximum Length:64
Reference identifying the original transaction, issued by Payment Service Provider (PSP) -
recordType(required):
string
Title:
Record type
Maximum Length:50
Shows the record type. Possible values: REQUESTFORINFORMATION, NOTIFICATIONOFFRAUD, CHARGEBACK, INFORMATIONSUPPLIED, CHARGEBACKREVERSED, NOTIFICATIONOFCHARGEBACK, SECONDCHARGEBACK, ACQUIRERPREARBITRATIONUPLOADED, PREARBITRATIONWON, PREARBITRATIONLOST -
transAmt(required):
number
Title:
Transaction amount
Amount of the disputed payment transaction
400 Response
Bad Request
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail:
string
Title:
Error description
The description of the error -
o:errorCode(required):
integer
Title:
Oracle error code
Oracle error code -
status:
integer
Title:
Status
HTTP response code -
title(required):
string
Title:
Title
High level description of the error -
type(required):
string
Title:
Type
The description of the type of HTTP error
401 Response
Unauthorized
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail:
string
Title:
Error description
The description of the error -
o:errorCode(required):
integer
Title:
Oracle error code
Oracle error code -
status:
integer
Title:
Status
HTTP response code -
title(required):
string
Title:
Title
High level description of the error -
type(required):
string
Title:
Type
The description of the type of HTTP error
403 Response
Service Unavailable
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail:
string
Title:
Error description
The description of the error -
o:errorCode(required):
integer
Title:
Oracle error code
Oracle error code -
status:
integer
Title:
Status
HTTP response code -
title(required):
string
Title:
Title
High level description of the error -
type(required):
string
Title:
Type
The description of the type of HTTP error
404 Response
Resource Not Found
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail:
string
Title:
Error description
The description of the error -
o:errorCode(required):
integer
Title:
Oracle error code
Oracle error code -
status:
integer
Title:
Status
HTTP response code -
title(required):
string
Title:
Title
High level description of the error -
type(required):
string
Title:
Type
The description of the type of HTTP error
Default Response
Unexpected Error
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail:
string
Title:
Error description
The description of the error -
o:errorCode(required):
integer
Title:
Oracle error code
Oracle error code -
status:
integer
Title:
Status
HTTP response code -
title(required):
string
Title:
Title
High level description of the error -
type(required):
string
Title:
Type
The description of the type of HTTP error
Examples
The following example shows how to get the payment account holder details by submitting a POST request on the REST resource using cURL. For more information, see Use cURL
curl -i -X POST -H "Authorization: Bearer" -H "Content-Type:application/json" -d https://baseurl/bi/v1/getPaymentChargebacks
Example of Response Header
The following shows an example of the response header.
HTTP/1.1 200 OK Date: Tue, 20 Oct 2020 21:24:33 GMT Transfer-Encoding: chunked Content-Type: application/json
Example of Response Body
The following example shows the contents of the response body in JSON format:
{ "recordDt": "2020-10-20", "locRef": "1234", "accounts":[{ "acctCode": "8516212653197782", "revenueCenters":[{ "rvcNum": 123, "chargebacks":[{ "recordType": "REQUESTFORINFORMATION", "disputePspRef": "12345678", "pmntType": "PAY", "checkNum": 1234, "guestCheckID": 123654, "guestCheckLineItemId": 123, "disputeUTC": "2020-10-20T12:10:00", "transAmt": 2.5, "disputeCur": "USD", "disputeAmt": 2.5, "currStatus": "True", "chgbkSchemeCode": "Visa", "chgbkRsnCode": "12.6", "disputeRsn": "Duplicate Processing/Paid by Other Means", "pspRef": "8836251672789792", "busDt": "2020-10-20", "autodefense": "false", "disputeEndUTC": "2020-10-20T12:12:00", "modPspRef": "8036251672851715" }] }] }] }