Custodia Documentation

Welcome to Custodia

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'll 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 Documentation

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.

Support

If you have any questions or need assistance with the integration, please contact our support team:

Our support team is available to help you with:

• API integration questions
• Technical issues or errors
• Best practices and guidance
• Feature requests or feedback