Capabilities

Capability Requests in Straddle allow you to enable specific features and functionalities for an account. Understanding how to manage capability requests is crucial for tailoring an account’s abilities to meet business needs while ensuring compliance with regulatory requirements.

​

Overview

Capability Requests serve several key purposes in the Straddle ecosystem:

1. Feature Activation: They allow accounts to access specific Straddle features and services.
2. Compliance Management: They ensure accounts only have access to capabilities they’re approved for.
3. Customization: They enable tailoring of account functionalities to specific business needs.
4. Risk Management: They help Straddle manage risk by controlling access to certain features.

​

Types of Capabilities

Straddle offers various capabilities that can be requested for an account. These are categorized into three main groups:

​

Creating a Capability Request

To request a new capability for an account, use the Create Capability Request endpoint.

​

Attributes

When creating a capability request, you need to specify the following attributes:

​

Type Enum

​

Category Enum

​

Example Request

Here’s how you might create a new capability request:

curl https://api.straddle.com/v1/accounts/acct_1234567890abcdef/capability_requests \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "charges",
    "category": "payment_type",
    "settings": {
      "max_transaction_amount": 10000,
      "currency": "USD"
    }
  }'

​

Capability Request Statuses

Capability requests go through different statuses as they are processed. Understanding these statuses is crucial for managing capability requests effectively.

​

Status Enum

​

Managing Capability Requests

Once you’ve submitted a capability request, you can check its status and retrieve details about it.

​

Retrieving Capability Request Details

To view the details of a specific capability request, use the Get Capability Request endpoint

​

Example Request

curl https://api.straddle.com/v1/accounts/acct_1234567890abcdef/capability_requests/cap_req_9876543210fedcba \
  -H "Authorization: Bearer YOUR_API_KEY"

​

Listing Capability Requests

You can retrieve a list of all capability requests for an account using the List Capability Requests endpoint.

​

Example Request

curl https://api.straddle.com/v1/accounts/acct_1234567890abcdef/capability_requests \
  -H "Authorization: Bearer YOUR_API_KEY"

​

Best Practices

When working with capability requests in Straddle, consider the following best practices:

​

Handling Capability Request Outcomes

Different outcomes of capability requests require different actions:

​

Approved Requests

When a capability request is approved:

1. Update your systems to reflect the new capability.
2. Inform the account holder about the new capability and any associated responsibilities.
3. Ensure your integration is ready to use the new capability.

​

Reviewing Requests

While a request is under review:

1. Monitor the request status regularly.
2. Be prepared to provide additional information if requested by Straddle.
3. Avoid making duplicate requests for the same capability.

​

Rejected Requests

If a capability request is rejected:

1. Review the rejection reason carefully.
2. Address any issues or concerns mentioned in the rejection.
3. Consider if you need to adjust your business model or processes.
4. If appropriate, prepare a new request with additional information or changes.