Manage capabilities for your accounts
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.
Capability Requests serve several key purposes in the Straddle ecosystem:
Request multiple capabilities for an account to customize functionality
Track the status of capability requests throughout the approval process
Gradually expand account functionalities as business needs grow
Ensure compliance with regulatory requirements automatically
Straddle offers various capabilities that can be requested for an account. These are categorized into three main groups:
To request a new capability for an account, use the Create Capability Request endpoint.
When creating a capability request, you need to specify the following attributes:
Field | Type | Description |
---|---|---|
type | string (enum) | The specific type of capability being requested. |
category | string (enum) | The category of the capability being requested. |
settings | object | Any specific settings or configurations needed for the requested capability. |
Possible values:
charges
payouts
individuals
businesses
signed_agreement
internet
Possible values:
payment_type
customer_type
consent_type
Here’s how you might create a new capability request:
Capability requests go through different statuses as they are processed. Understanding these statuses is crucial for managing capability requests effectively.
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.Once you’ve submitted a capability request, you can check its status and retrieve details about it.
To view the details of a specific capability request, use the Get Capability Request endpoint
You can retrieve a list of all capability requests for an account using the List Capability Requests endpoint.
When working with capability requests in Straddle, consider the following best practices:
Be Strategic
Only request capabilities that are necessary for your current business operations. You can always request additional capabilities as your needs grow.
Prepare Documentation
Requests for high-ticket payment limits might require additional documentation.
Allow Processing Time
Some capability requests may require manual review. Factor this into your timelines when planning new feature rollouts.
Handle Rejections Gracefully
If a capability request is rejected, review the reason carefully. You may need to provide additional information or adjust your business processes before reapplying.
Different outcomes of capability requests require different actions:
When a capability request is approved:
While a request is under review:
If a capability request is rejected:
Capability management is an ongoing process. Regularly review your account’s capabilities to ensure they align with your current business needs and compliance requirements.