ceven

Fidel API

Links customer payment cards to your app to trigger workflows based on real time spending and creates targeted rewards programs based on transaction data.

Try Fidel API in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Fidel API integration

    • Describe the outcome and Ceven picks the right Fidel API calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Fidel API data, across all 39 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Fidel API access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Fidel API, when, and on whose behalf.
    • The agent pauses and asks when Fidel API is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Fidel API.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Fidel API action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Fidel API, and when to use it.

Create Brand
Use this when you need to register a new merchant brand to track spending against specific company identifiers.
Create Program
Use this to set up a new loyalty or rewards program for online or offline stores.
Create Program Webhook
Register a webhook to receive real time notifications when specific program events occur in your app.
Delete Offer
Remove a specific offer from the system using the offer ID. Use this for expired promotions.
Delete Program Webhook
Remove a program webhook after confirming the program ID and hook ID to stop event notifications.
Delete Webhook
Permanently remove a webhook by its ID to clean up old event listeners.
Get Brand
Pull full details for a specific brand using its unique brand ID.
Get Offer
Fetch the full details and configuration of a specific offer by ID.
Get Program
Retrieve the configuration and metadata for a specific rewards program.
Get Webhook
Pull the current settings and status of a specific webhook by its ID.
List Brands
Retrieve a paginated list of all registered brands to audit your merchant library.
List Cards
Pull all card records associated with a specific program ID.
List Locations
Retrieve a paginated list of store locations linked to a specific program.
List Offers
Pull all active offers, optionally filtered by specific criteria.
List Programs
Retrieve all available programs with optional pagination for high volume accounts.
List Transactions
Page through and filter card transactions to analyze spending patterns.
List Program Webhooks
Tool to list all registered webhooks for a specific program. use when you need to retrieve existing webhooks after confirming the programid.
Update Program
Tool to update a program's name, icon, metadata, or status. use after confirming the program id and desired updates.

18 actions · scroll to see them all

Frequently asked questions

Ceven connects to Fidel API via webhooks to ensure that transaction events are processed the instant they occur. When a customer swipes their card, Fidel API sends a payload to the registered webhook, which Ceven intercepts and parses. The agent then evaluates the transaction against your predefined workflow rules, such as checking if the merchant matches a specific brand ID. If the conditions are met, Ceven triggers the downstream action, such as sending a push notification or updating a database. This process happens in milliseconds, allowing your business to provide a truly real time response to consumer spending behavior without any manual polling of the API.
Yes, Fidel API allows you to monitor transactions across the global card network. However, the level of detail depends on the merchant data provided by the issuing bank. Some merchants provide clean brand names while others provide raw transaction strings. Ceven helps solve this by allowing you to create specific Brand objects in Fidel API. By mapping a raw merchant string to a clean Brand ID, the agent can consistently identify when a user spends money at a specific chain or store regardless of how the bank formats the transaction text, ensuring your rewards trigger every single time.
Fidel API employs a tiered rate limiting system based on your specific account plan. If a workflow triggers a massive burst of requests, such as listing thousands of transactions for a large cohort, you may encounter a 429 Too Many Requests error. Ceven handles this by implementing an exponential backoff strategy. The agent will automatically pause and retry the request after a short delay to stay within your plan limits. For enterprise users with higher throughput needs, we recommend optimizing your workflows to use webhooks instead of frequent polling to reduce the total number of API calls made to the Fidel servers.
Ceven never stores raw primary account numbers or sensitive PCI data. Fidel API acts as the secure vault and tokenization layer. When Ceven interacts with the API, it uses secure tokens to reference cards and transactions. The workflow only sees the metadata necessary to execute the business logic, such as the transaction amount, date, and merchant ID. All communications between Ceven and Fidel API are encrypted using TLS 1.2 or higher, and we adhere to strict data minimization principles to ensure that no sensitive financial identifiers are ever logged in plain text within your workflow history.
You can simply tell the Ceven agent to create a new program and provide the necessary metadata. The agent will call the Create Program endpoint to establish the program in Fidel API. Once the program is created, you can instruct the agent to link specific brands or create offers associated with that program. To make it fully automated, you should also have the agent create a Program Webhook. This ensures that any activity within that specific loyalty program is pushed back to Ceven in real time, allowing the agent to manage the reward fulfillment process without any further manual input.
Yes, the agent can list, create, and delete webhooks across your entire account. If you are rotating your endpoints or migrating your backend, you can ask Ceven to list all registered program webhooks and update them to the new URL. The agent can also audit your webhooks to see which ones are still active and delete those that are no longer needed. This prevents your system from receiving redundant data and helps maintain a clean integration architecture. You can manage these via simple natural language commands rather than manually navigating the API documentation and making individual curl requests.
Fidel API provides transaction updates that reflect changes in the state of a charge. When a refund or reversal occurs, a new event is fired. You can configure your Ceven workflow to listen for these specific event types. For example, if a user earns a reward based on a purchase but then returns the item, the agent can detect the refund event and automatically deduct the loyalty points or revoke the discount code from the user's account. This ensures that your rewards program remains fraud proof and that users cannot game the system by making and then reversing large purchases.
When a transaction comes through that does not match an existing brand, you can use the List Transactions action to find the raw merchant string. Once you identify the merchant you want to track, use the Create Brand action to register it in Fidel API. After the brand is created, the agent can then associate that brand with one or more programs. From that point forward, every transaction from that merchant will be correctly identified as belonging to that brand, triggering any associated workflows. This allows you to grow your partner network dynamically as you discover where your customers are spending their money.

Alternatives to Fidel API

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Plaid logoPlaidYodlee logoYodleeTink logoTink

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Fidel API and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free