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.

Multiple Capabilities

Request multiple capabilities for an account to customize functionality

Status Tracking

Track the status of capability requests throughout the approval process

Scalable Growth

Gradually expand account functionalities as business needs grow

Regulatory Compliance

Ensure compliance with regulatory requirements automatically

​
Types of Capabilities

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

​
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:
FieldTypeDescription
typestring (enum)The specific type of capability being requested.
categorystring (enum)The category of the capability being requested.
settingsobjectAny specific settings or configurations needed for the requested capability.

​
Type Enum

​
type
enum
Possible values:
  • charges
  • payouts
  • individuals
  • businesses
  • signed_agreement
  • internet

​
Category Enum

​
category
enum
Possible values:
  • payment_type
  • customer_type
  • consent_type

​
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

​
status
enum
Possible values:
  • approved: The capability request has been approved and the capability is now active.
  • rejected: The capability request has been rejected.
  • reviewing: The capability request is currently under review.

​
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.
Capability management is an ongoing process. Regularly review your account’s capabilities to ensure they align with your current business needs and compliance requirements.