Skip to main content
Add Straddle to your application with your coding agent. The Wizard guides the work from a plan you review to code changes and recorded sandbox test results.

​
Before you begin

Prepare the following:
  • An application repository and Node.js 22.18 or later.
  • Claude Code, Codex, or Cursor. For Auto mode, install and sign in to the client’s command-line tool: claude, codex, or cursor-agent.
  • A sandbox API key from the Straddle Dashboard, available as STRADDLE_API_KEY in the environment that starts your agent.
Use your secret manager or shell configuration to supply the API key. The plugin installation guide covers client setup and connection checks.

​
Build and verify

1

Open your application repository

In a terminal at the repository root, select sandbox:
If you set STRADDLE_BASE_URL, use https://sandbox.straddle.com. The Wizard reports conflicting environment settings before the request steps start.
2

Start the Wizard

Launch the guided integration:
Confirm the detected language and framework. Choose charges, payouts, or both; your integration type; an SDK; and a notification path. Select Not decided yet for a choice you want to work through with the agent.Choose your client and Auto to let the Wizard start it. In Manual, follow the displayed setup steps and paste the Wizard’s generated message into your agent. Review and accept any plugin download or installation needed for the run.
3

Review the integration plan

The agent checks the project and writes straddle-integration-plan.md. Give it the application context it asks for. For a charge integration, adapt this request in the agent session:

Describe a Pay by Bank integration

Read the plan’s application changes, account rules, and test scenarios. Approve the plan when it matches the integration you want. If the repository already uses another payment provider, the Wizard also includes a migration step.
4

Build and test in sandbox

The agent implements the approved plan, then runs its test workflow. Review each sandbox write preview, including the environment, acting account, operation, and payload, before approving it.Complete any application interaction the agent needs, such as connecting a bank through the Bridge widget. The agent records the checks it ran and any scenario that still needs attention in straddle-test-evidence.md.
5

Read the evidence and next steps

Inspect the saved run:
Open straddle-integration-report.md for the code changes and straddle-test-evidence.md for the results. A finished Test step has Status: complete for the current approved plan. Review the latest run’s scenario table and its live-observed evidence for sandbox behavior.Read straddle-go-live-report.md for the production readiness review and any remaining gaps. Review the changed files and the agent’s Verify before merging checklist before merging your integration.

​
Continue an unfinished run

After resolving a missing setting, unanswered question, or failed check, continue from the same repository:
The Wizard reads the plan and reports to find the first unfinished step. See Run and resume an integration for completion states, Manual mode, and finishing after sandbox testing.