ZenPayments
  1. View
ZenPayments
  • General Information
    • Authentication
    • Errors
    • Responses
    • Filters
      • Example - gte
      • Example - between
      • Example - like
      • Example - in
      • Example - non-empty
    • Pagination
      • 10 results per page
    • Data Types
  • Merchants
    • Sandbox
      • Sandbox Payment Gateway
    • Card Payments
      • Authorization
      • Sale
      • Capture
      • Partial Capture
      • Refund
      • Partial Refund
      • Soft/Dynamic Descriptor
      • Card Authentication
      • Card Tokenization
      • Card Tokenization with Global Token
      • Sale with a Fee Terminal
    • Hosted Form
      • Generate
      • Generate with Billing and Contact Information
    • Hosted Fields
      • How it Works
      • Hosted Fields Token
        • Hosted Fields Token
      • Integration Guide
        • Step 1: Include the JavaScript Library
        • Step 2: Add HTML Elements for all payment fields
        • Step 3: Set the AccessToken and Configure the rest of the form
        • Step 4: Add styling
        • Step 5: Listen for Events
        • Step 6: Get the tokenized card
          • Get the tokenized card
        • Add Payment Method Page
        • Testing your integration
    • CustomerVault
      • Sandbox
        • Sandbox Dashboard
      • Hosted Card Form
        • Generate
      • Customers
        • List
        • View
        • Create
        • Update
        • Archive
        • Delete
      • Cards
        • List Cards
        • View
        • Add Card
        • Update Exp Date
        • Archive
        • Unarchive
        • Delete
      • Billing Information
        • List
        • View
        • Update
        • Create
      • Shipping Information
        • List
        • View
        • Update
        • Create
      • Recurring Payment
        • List
        • View
        • Update
        • Create
    • Transaction Reporting
      • List
      • View
    • Response Codes
      • Verification Response Codes
    • 3DSecure
      • Version
      • Create
        • Create
      • Check
        • Check
      • Test Cards
    • Account Updater
      • Card Compatibility
      • How It Works
        • Sale with Account Updater
    • ACH Payments
      • General Information
      • Transactions
        • SEC Codes
        • Statuses
        • Actions
          • Action
        • History Log
          • Log
        • List
        • View
        • Create ACH
        • Create ACH & Save Customer
        • Create ACH for an existing Customer
        • Create ACH for an existing Customer and specific Account
        • Remove
      • Hosted Form
        • Example Request
      • Customers
        • List Customers
        • View specific Customer
        • Create Customer
        • Update Customer
        • Delete a Customer
      • Customer Accounts
        • List Customer Accounts
        • Create Customer Account
        • Update Customer Account
        • Delete a Customer Account
      • Bank Information
        • View
      • ACH Settlements
        • List
        • View
      • ACH Webhooks
        • New ACH Record
        • ACH Status Update
        • New ACH Customer
    • Reporting
      • Sandbox
        • Sandbox Dashboard
      • Authorizations
        • List
        • List with Filters
      • Batches
        • List
        • List with Filters
        • Summary
      • Payouts
        • List
        • View
        • Export
      • Chargebacks
        • Disputes
          • Upload a temporary file
          • Create a Dispute
          • Preview
          • Submit
        • Webhooks
          • Signatures
          • Events
            • Chargeback
              • New Chargeback Record
              • Chargeback Update
        • View
          • List
            GET
          • View
            GET
      • Statements
        • List
        • Download
      • Reserve
        • List
      • Fraud Report
        • Generate
      • Visa Verifi
        • Submiting External Transactions
          • Submit
        • List
      • Other Reports
        • Request a Report
        • Check Status
        • Download
    • Gateway Test Cards
  • Platforms
    • Sandbox
      • Sandbox Dashboard
    • Onboarding
      • Boarding Applications
        • Campaigns
          • List
        • Equipment
          • Terminals
            • List
            • View
          • View
          • Update
        • List
          • List Boarding Applications
        • Create
          • Create Boarding Application
        • Delete
          • Delete Boarding Application
        • View
          • View Boarding Application
        • Update
          • Update Boarding Application
        • Principals
          • List Principals
          • Create Principal
          • Update a Single Principal
          • Mass update Principals
          • Delete Principal
        • Processing
          • View Processing section
          • Update Processing section
        • Merchant Category Codes (MCCs)
          • List MCCs
        • ACH
          • View ACH section
          • Update ACH section
        • Documents
          • Attachment About
            • List All Document Categories
          • View all documents
          • MPA
          • Assign a single document
          • Assign multiple documents
          • Update a single document
          • Delete a single document
        • Fees
          • Types
            • List
          • Other Fees
            • Add
            • Update
            • Delete
          • List all fees
          • View a specific fee
          • Update a single fee
          • Update multiple fees
        • Bank Accounts
          • Add
          • Update
          • Change
        • Validate
          • Validate a Boarding Application
        • URL
          • GET URL of Boarding Application
        • Signature
          • Request E-sign
            • Request Signature
          • Embed E-sign
            • Embeded E-sign Example Flow 1
            • Embeded E-sign Example Flow 2
            • Request Embed
          • Manually Signing
            • Manual Sign
          • External eSign Signing
            • External eSign
        • Automation
          • AutoSign
            • Set AutoSign
          • AutoUnderwriting
            • Set AutoUnderwriting
        • Status
          • Set status to Underwriting
        • Notes
          • List
          • Create
      • Merchants
        • Terminals
          • List Terminals
          • View a specific Terminal
          • VAR Sheet
          • VAR View
        • List Merchants
      • DBA
        • List
        • View
      • Attachments
        • Temporary Upload
          • Temporary Upload
        • Chunk Upload
          • Initialize
          • Upload Request 1/2
          • Upload Request 2/2
        • Standard Upload
        • List attachments
        • View
        • View in browser
        • Download
        • Delete
      • Webhooks
        • Signatures
        • Events
          • Boarding Application
          • Merchant
            • Account
              • New Acquiring Account
              • New ACH Account
              • Closed Acquiring Account
              • Closed ACH Account
            • Terminal
              • New Terminal Record
              • Update Terminal Record
              • Delete Terminal Record
    • Reporting
      • Authorizations
        • List
        • List with Filters
      • Batches
        • List
        • List with Filters
        • Summary
      • Payouts
        • List
        • View
        • Export
      • Chargebacks
        • View
          • List
          • View
        • Disputes
          • Upload a temporary file
          • Create a Dispute
          • Preview
          • Submit
        • Webhooks
          • Signatures
          • Events
            • Chargeback
              • New Chargeback Record
              • Chargeback Update
      • Statements
        • List
        • Download
      • Reserve
        • List
      • Fraud Report
        • Generate
      • Other Reports
        • Request a Report
        • Check Status
        • Download
    • Residuals
      • List
      • View
    • Tickets
      • Update Ticket Status
        • Close
        • Re-Open
      • Responses
        • List
        • Create
        • Add an Attachment
      • Attachments
        • List
        • View
        • Create
        • Delete
      • Categories
        • List
      • Notes
        • List
        • View
        • Create
        • Update
        • Delete
        • Attachments
      • List
      • Create
      • View a specific ticket
    • Connect
      • Webhooks
        • Access Granted
        • Access Updated
        • Access Revoked
    • Misc
      • Address Checker
        • List Countries
        • List States
        • List Cities and Zip Codes
        • Filter by City and State
      • BIN Check
        • Get BIN Information
  1. View

View

GET
/api/reporting/chargeback/<id>
By utilizing this endpoint you can view detailed information for a specific chargeback
FieldsDescriptionType
idThe unique ID that is assigned by our system to every case.Integer
dbaObjectObject
dba.idThe ID of the DBAInteger
midThe Merchant Identification Number (MID)Integer
merchantRefIdA reference number provided by the merchant or their vendor for this transaction.String
merchantEmailMerchant email addressString
typeChargeback or RetrievalENUM
visaRDRYes or No - Identifies if the chargeback is Visa RDRENUM
authCodeThe authorization code passed with the settlement recordString
acquirerReferenceNumberAn identification number for a credit card transaction assigned by the acquirer.Object
gatewayObjectObject
gateway.idIf using our internal gateway this is the unique payment ID that is assigned to every transactionInteger
gateway.externalIDIf using our internal gateway this is the externalID of the transactionInteger
amountThe amount of the retrieval or chargeback. This is not always equal to the amount of the transaction.Number
transactionObjectObject
transaction.idThe unique payment ID that is assigned per transaction from the system.String
transaction.amountThe original transaction amount or case amount if unable to find the original transactionNumber
transaction.dateTransaction DateDate
transaction.cardObjectObject
transaction.card.brandCard BrandString
transaction.card.numberCard NumberString
transaction.reasonObjectObject
transaction.reason.codeTransaction Auth reason codeString
transaction.reason.descriptionTransaction Auth reason descriptionString
dateObjectObject
date.postedThe post date as reported by the issuer.Date
date.loadedThe date the retrieval request or chargeback was loaded in the system.Date
date.lastLoadedThe date of the last case loaded in the system for the chargeback.Date
date.disputedDate when the dispute was submitted.Date
date.receivedDateDate the retrieval request or chargeback was submitted by the Issuer.Date
date.lastActionDateDate the case needs to be resolved.Date
reasonObjectObject
reason.codeChargeback reason codeString
reason.descriptionChargeback reason descriptionString
fraudYes or NoENUM
attentionYes or No If the merchant's attention is requiredENUM
casesArray of objectsArray
cases.idUnique case ID assigned by our systemInteger
cases.typeChargeback or RetrievalENUM
cases.numberUnique case number assigned by the external system(bank)Integer
cases.descriptionCase descriptionString
cases.dateObjectObject
cases.date.loadedThe date the case was loaded in the system.Date
cases.date.disputedThe date and time of the last dispute uploaded to the caseDatetime
cases.fraudYes or No if the case is considered fraudENUM
cases.attentionYes or No if the case requires merchants' attentionENUM
cases.statusProcessed, Won, LostENUM
cases.attachmentsArray of objects listing information for the last uploaded disputeArray
statusProcessed, Won, LostENUM

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/reporting/chargeback/<id>' \
--header 'Authorization: Bearer <token>'

Responses

🟢200View
application/json
Body

Example
{
    "id": 5545,
    "dba": {
        "id": 9
    },
    "mid": 40111950369,
    "merchantRefId": "SSS-2023040518402732",
    "merchantEmail": "",
    "type": "Chargeback",
    "visaRDR": "No",
    "authCode": "049684",
    "acquirerReferenceNumber": "12345063096900012627661",
    "gateway": {
        "id": null,
        "externalId": null
    },
    "amount": "39.00",
    "transaction": {
        "id": "445595672279437",
        "amount": "39.00",
        "date": "2023-04-06",
        "card": {
            "number": "434257******9716",
            "brand": "Visa"
        },
        "reason": null
    },
    "date": {
        "posted": "2023-04-06",
        "loaded": "2023-04-12",
        "lastLoaded": "2023-04-12",
        "disputed": "2023-04-13 17:44:59",
        "receivedDate": "2023-04-11",
        "lastActionDate": "2023-05-07"
    },
    "reason": {
        "code": "10.4",
        "description": "Fraud Card Absent Environment"
    },
    "fraud": "Yes",
    "attention": "Yes",
    "cases": [
        {
            "id": 6233665,
            "type": "Chargeback",
            "number": 2023102015720,
            "description": "Visa Allocation case loaded into the system",
            "reason": {
                "code": "10.4",
                "description": "Fraud Card Absent Environment"
            },
            "date": {
                "loaded": "2023-04-12",
                "disputed": null,
                "receivedDate": "2023-04-11",
                "lastActionDate": "2023-05-07"
            },
            "fraud": "Yes",
            "attention": "Yes",
            "status": "Lost",
            "attachments": []
        }
    ],
    "status": "Lost"
}
Modified at 2025-08-09 05:39:41
Previous
List
Next
List
Built with