For Agents
Read pre-dispute chargeback alerts, manage descriptor enrollments, upload order data for matching, and issue credit requests to deflect chargebacks before they post. Useful for fraud and dispute operations agents.
Get started with Chargeblast API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"list and deflect chargeback alerts"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Chargeblast API API.
List incoming chargeback alerts with /api/v2/alerts and pull a single alert detail by ID
Update an alert's outcome (refund, representment, decline) via PUT /api/v2/alerts/{id}/update
Enroll and unenroll merchants and their card descriptors into the alert network through /api/enroll_merchant and /api/unenroll_merchant
List the descriptors and merchants currently registered against the account for reconciliation
GET STARTED
Use for: List all open chargeback alerts from the last 24 hours, Get the details of alert ID 12345, Mark an alert as resolved with a refund outcome, Enroll a new merchant descriptor into the alert network
Not supported: Does not handle payment authorisation, refund settlement, or representment of posted chargebacks — use for pre-dispute alert deflection and descriptor enrollment only.
Chargeblast is a chargeback prevention platform that lets merchants enroll their card descriptors into pre-dispute alert networks (Verifi CDRN, Ethoca, RDR), receive alerts when a cardholder initiates a dispute, and resolve them with a refund or representment before they become a chargeback. The v2 API exposes alerts, merchant enrollment, descriptor management, deflection logs, credit requests, and order data uploads. It is intended for risk teams, payment processors, and high-risk merchants who need to act on disputes within minutes of cardholder action.
Push order metadata in bulk with POST /api/upload_orders so alerts can be matched back to the originating transaction
Submit a credit request for a flagged transaction via POST /api/credit_requests to deflect the dispute
Pull deflection logs to verify that submitted credits successfully prevented chargebacks
Patterns agents use Chargeblast API API for, with concrete tasks.
★ Real-Time Chargeback Deflection
Risk operations teams poll /api/v2/alerts for new pre-dispute notifications coming from CDRN, Ethoca, and RDR networks. When an alert matches an order they want to refund rather than dispute, they call POST /api/credit_requests within minutes, which Chargeblast forwards to the issuer and which prevents the dispute from becoming a chargeback. Deflection cost is far lower than the chargeback fee plus lost goods.
List /api/v2/alerts with state=open, match each to a recent order, and POST /api/credit_requests for any over the deflection threshold
Descriptor and Merchant Onboarding
Payment processors and merchant aggregators onboard new descriptors into the chargeback alert networks through POST /api/enroll_merchant. Each enrolled descriptor begins receiving alerts when issuers flag transactions, and unenrolling via POST /api/unenroll_merchant cleanly removes coverage when a merchant offboards. The /api/merchants and /api/descriptors endpoints provide the read side for reconciliation.
POST /api/enroll_merchant for a new merchant with their MID and descriptors, then GET /api/merchants to verify enrollment status
Order Data Matching
Pre-dispute alerts arrive with cardholder details but limited transaction context, so merchants upload order metadata via POST /api/upload_orders so Chargeblast can match alerts back to the originating order. Better matching means faster resolution decisions and clearer refund evidence. Bulk uploads run nightly or on order completion.
POST /api/upload_orders with the last 24 hours of completed orders so subsequent alerts can be matched automatically
Agent-Managed Dispute Operations via Jentic
An AI agent given a directive like 'refund any open chargeback alerts over $50' can resolve the workflow through Jentic. The agent searches for the list-alerts and credit-requests operations, iterates the open alerts, and issues credit requests against ones that meet the rule, all without holding the API key.
Search Jentic for 'list chargeback alerts', filter to open alerts over $50, and post credit requests for each
14 endpoints — chargeblast is a chargeback prevention platform that lets merchants enroll their card descriptors into pre-dispute alert networks (verifi cdrn, ethoca, rdr), receive alerts when a cardholder initiates a dispute, and resolve them with a refund or representment before they become a chargeback.
METHOD
PATH
DESCRIPTION
/api/v2/alerts
List chargeback alerts
/api/v2/alerts/{id}
Retrieve a single alert by ID
/api/v2/alerts/{id}/update
Update an alert outcome
/api/enroll_merchant
Enroll a merchant descriptor in the alert network
/api/credit_requests
Submit a credit request to deflect an alert
/api/upload_orders
Bulk upload order metadata for matching
/api/deflection_logs
Audit log of deflected alerts
/api/v2/alerts
List chargeback alerts
/api/v2/alerts/{id}
Retrieve a single alert by ID
/api/v2/alerts/{id}/update
Update an alert outcome
/api/enroll_merchant
Enroll a merchant descriptor in the alert network
/api/credit_requests
Submit a credit request to deflect an alert
Three things that make agents converge on Jentic-routed access.
Credential isolation
Chargeblast uses an X-API-Key header for authentication. Jentic stores the key encrypted in the MAXsystem vault, isolating it from the agent context, and only injects it server-side at execution time.
Intent-based discovery
Agents query Jentic with intents like 'list chargeback alerts' or 'submit a credit request', and Jentic returns the matching Chargeblast operations with the alert ID and amount schema fully resolved.
Time to first call
Direct Chargeblast integration: 2-4 days to handle alert polling, order matching, and deflection workflows. Through Jentic: under an hour — search, load, execute against the right alert IDs.
Alternatives and complements available in the Jentic catalogue.
Chargeflow API
Chargeflow automates chargeback representment and evidence; Chargeblast focuses on pre-dispute alert deflection.
Choose Chargeflow when the dispute has already become a chargeback that needs to be fought; choose Chargeblast to prevent it before it posts.
Sift API
Sift scores transactions for fraud risk before authorisation; Chargeblast deflects post-authorisation disputes.
Use Sift to block fraudulent transactions up-front, then layer Chargeblast to handle disputes that still slip through.
Stripe API
Stripe is the underlying payment processor that funds the credits Chargeblast instructs you to issue.
Pair Stripe and Chargeblast when the agent needs to look up the original payment in Stripe and refund it in response to a Chargeblast alert.
Specific to using Chargeblast API API through Jentic.
What authentication does the Chargeblast API use?
Chargeblast uses an API key passed in the X-API-Key header on every request. Through Jentic, the key stays encrypted in the MAXsystem vault and the agent receives a scoped execution token instead of the raw secret.
Can I deflect a chargeback alert before it becomes a chargeback with the Chargeblast API?
Yes. POST /api/credit_requests against the alert ID with the credit amount and Chargeblast forwards the credit instruction to the issuer through the alert network. If accepted in time, the dispute does not progress to a chargeback.
How do I match alerts to my own order records?
Bulk-upload order metadata to POST /api/upload_orders so Chargeblast can match incoming alerts by descriptor, amount, and date. Orders with richer matching data resolve faster and reduce manual review time.
What are the rate limits for the Chargeblast API?
Chargeblast does not publish a fixed public rate limit. As a real-time alert API, it favours short polling on /api/v2/alerts and bulk uploads on /api/upload_orders rather than high-frequency individual writes; back off on HTTP 429 responses.
How do I list open chargeback alerts through Jentic?
Install jentic with pip install jentic, search for 'list chargeback alerts', load the schema for GET /api/v2/alerts, and execute. Sign up at https://app.jentic.com/sign-up to get an agent API key.
Does the Chargeblast API support enrolling descriptors into both Verifi and Ethoca networks?
Yes. POST /api/enroll_merchant accepts the merchant identifiers and descriptors and Chargeblast handles enrollment into the supported pre-dispute networks (CDRN, Ethoca, RDR) on the back end. GET /api/descriptors confirms what is currently registered.
/api/upload_orders
Bulk upload order metadata for matching
/api/deflection_logs
Audit log of deflected alerts