Manage alerts
Get in touch
Sign in
Manage alerts
Set up and handle chargeback alerts in Chargebackhit

Chargeback alerts help you avoid disputes and prevent fees, reduce processing costs, and protect your merchant account health. To start receiving alerts, you need to connect your Merchant IDs (MIDs) and select the alert products that match your needs.

Step 1. Connect MIDs

To connect MIDs, log in to your Chargebackhit HUB account and go to the MIDs section.

Use the guidance on adding MIDs to specify products you want to enable and fill in the required alert parameters to ensure connection to the selected products.

When adding MIDs and filling in parameters, the following resources might be helpful:

  • Product overview: provides information about the available products and alert types
    Prevent product requires integration since alerts must be processed within seconds.
  • Onboarding parameters: explains the alert parameters
    • For RDR alerts, descriptor-BIN-CAID or descriptor-VISA ARNs are mandatory.
    • For CDRN and Ethoca alerts, descriptors are mandatory.

If you use Stripe, find your descriptor by going to Settings and selecting Public details in your Stripe account.

To find ARNs on the Stripe side

  1. Go to Stripe > Transactions > Refunds.
  2. Apply the following filters:
    • Date: Last 120 days
    • Card brand: Visa
    • Refunded: At least 3 days ago
  3. Select the needed transaction.
  4. Find the ARN in the Payment breakdown section.

Step 2. Handle alerts

You can handle alerts manually, automatically via webhooks, or by using the payment platform integrations.

Manual alert handling

To handle alerts manually

  1. Open the received alert in Chargebackhit HUB .
  2. Find the transaction in your system using the alert parameters.
  3. Make a refund.
  4. Submit your response in Chargebackhit HUB.

Refer to the outcome types to learn which response to use for each alert type.

RDR alerts with the resolved type do NOT require any further action such as matching or refunds. Refunds must be processed for:

  • CDRN alerts (init-refund type): response time is 72 hours
  • Ethoca alerts (init-refund type): response time is 48 hours

Automatic handling via webhooks

To handle alerts automatically via webhooks

  1. Connect to Chargebackhit Webhook API .
  2. Set up the automatic alert matching algorithm on your side.

Handling via integration

If you use a payment platform supported by Chargebackhit, you can connect it to automate alert handling. Check the available integrations in Chargebackhit HUB and follow the integration setup instructions to implement automatic handling.

PayPal alerts

PayPal alerts are processed automatically and do not require manual handling.

To activate PayPal alerts

  1. Provide your descriptor.
  2. Provide your PayPal Merchant ID, which is unique for each account.

You can find your PayPal Merchant ID by going to Account settings in PayPal, then selecting Business information.


Looking for help? Contact us
Stay informed with Changelog