Agentic Payments

Overview

This documentation will help you integrate with Custodia for agentic payments. Follow the guides below to get started with your integration.

Getting Started

To get started with agentic payments, follow these steps in order:

1. Obtain API credentials
   Contact Custodia to request your clientId and clientSecret. These credentials are required to authenticate. See the Authentication guide for details on how to use these credentials.
2. Create a user (agent)
   Create a user account that will represent your agent. This user will be associated with payment intents and will make transactions. See the Users documentation for how to create users.
3. Order a card for the agent
   Order a card for the user (agent) you created. The card will be used to make payments. You will need to know the card product ID, which you can retrieve from the Card Products documentation. See the Order Card endpoint in the Users documentation.
4. Create a payment intent
   Create a payment intent that defines the spending parameters for your agent. This includes the budget amount, time period, spending limits, and purpose. See the Payment Intents documentation for details.
5. Process payments
   Once the payment intent is approved and active, your agent can use the associated card to make payments. Transactions will be automatically recorded and can be retrieved using the Transactions documentation.

API Guides in This Track

Explore the detailed documentation below:

• Authentication

  Learn how to authenticate with Custodia using your client ID and secret. This is the first step to accessing all endpoints.

• Card Products

  Retrieve card product information including available card types, configurations, and ordering options.

• Payment Intents

  Create and submit payment intents for agentic payments with spending parameters and budgets.

• Transactions

  Retrieve transaction and payment data with filtering and query options.

• Users

  Create users, update user information, and order cards for users in your system.

Return to the Partner Hub to choose a different integration path.