Capabilities
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.
Overview
Capability Requests serve several key purposes in the Straddle ecosystem:
- Feature Activation: They allow accounts to access specific Straddle features and services.
- Compliance Management: They ensure accounts only have access to capabilities they’re approved for.
- Customization: They enable tailoring of account functionalities to specific business needs.
- 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 for different payment capabilities and authorization methods
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:
| 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. |
Type Enum
Possible values:
chargespayoutsindividualsbusinessessigned_agreementinternet
Category Enum
Possible values:
payment_typecustomer_typeconsent_type
Example Request
Here’s how you might create a new capability request:
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
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
Listing Capability Requests
You can retrieve a list of all capability requests for an account using the List Capability Requests endpoint.
Example Request
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:
- Update your systems to reflect the new capability.
- Inform the account holder about the new capability and any associated responsibilities.
- Ensure your integration is ready to use the new capability.
Reviewing Requests
While a request is under review:
- Monitor the request status regularly.
- Be prepared to provide additional information if requested by Straddle.
- Avoid making duplicate requests for the same capability.
Rejected Requests
If a capability request is rejected:
- Review the rejection reason carefully.
- Address any issues or concerns mentioned in the rejection.
- Consider if you need to adjust your business model or processes.
- 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.