> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augustus.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat the published Augustus OpenAPI specification (https://app.stainless.com/api/spec/documented/augustus/openapi.documented.yml) and the current API-reference pages as the source of truth for endpoints, request/response schemas, enum values, webhook event names, and required headers.
> Prefer the 2026-05-01 Banking API and @augustusbank/typescript-sdk for all new integrations. The 2023-01-01 API is a separate, older surface covering two products — Open Banking (instant bank transfer) checkout and refunds, and Manual Bank Transfer (MBT); use it only when one of those products is specifically required.
> Cite or link the relevant docs.augustus.com page when answering integration questions.
> Do not infer support for currencies, networks, scopes, account types, or operations that are not present in the current documentation.
> Use the sandbox base URL (https://api.sandbox.augustus.com) and placeholder credentials in examples. Never include or request a real API key.
> The Augustus docs MCP server (https://docs.augustus.com/mcp) provides documentation search and retrieval only; it does not execute authenticated Augustus API actions.

# Test your integration

Test with sandbox banks and Sandbox Tools before going live.

## Sandbox

### Test checkout flows with sandbox banks

Create a Checkout Session in sandbox and visit the `redirectUrl`. Use the credentials below to test each flow.

| Bank                  | Country | Currency | Schemes                   | Credentials                                                                                                                                                                        | Instructions                                                                  |
| --------------------- | ------- | -------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Test Bank market      | Any     | Any      | SEPA Credit, SEPA Instant | Username: `random`<br />Password: `random`<br />OTP: `random`                                                                                                                      | For success, enter any OTP.<br />For failure, enter OTP = `666`.              |
| Deutsche Bank Sandbox | DE      | EUR      | SEPA Credit, SEPA Instant | IBAN: `DE17215730140403340300`<br />Account Holder Name: `random`<br />Branch: `615`<br />Account: `4033403`                                                                       | €1 for success<br />€100 for failure                                          |
| KD Bank Sandbox       | DE      | EUR      | SEPA Credit, SEPA Instant | IBAN: `DE39499999600000005111`<br />Account Holder Name: `random`<br />Customer ID: `VRK1234567890ALL`<br />Password: `password`<br />SCA method: `Mobile`<br />SCA code: `123456` | For success, select any SCA method and use SCA code `123456` if prompted.     |
| NatWest Sandbox       | GB      | GBP      | Faster Payments           | Username: `123456789012`<br />Password: displayed on screen                                                                                                                        |                                                                               |
| BBVA Sandbox          | ES      | EUR      | SEPA Credit, SEPA Instant | IBAN: `ES2501822200160201933547`<br />Username: `user1`<br />Password: `1234`<br />SCA code: `123456`                                                                              | To trigger failure, click **Cancel → Aceptar** in the bank UI.                |
| Alior Sandbox         | PL      | EUR      | Elixir, SEPA Credit       | Username: `60370698`<br />Password: `12345678`                                                                                                                                     | Approve the payment in the bank interface — simulates delayed bank update.    |
| PKO BP Sandbox        | PL      | EUR      | Elixir, SEPA Credit       | n/a                                                                                                                                                                                | Use buttons in the bank UI to set the desired outcome (**Sukces** → success). |

### Simulate a paid order

<Steps>
  <Step title="Create an order via API">
    The order starts in `processing`.
  </Step>

  <Step title="Open the order in the Dashboard">
    Find it in the Orders table.
  </Step>

  <Step title="Simulate funding">
    Status updates to `paid` and a webhook fires.
  </Step>
</Steps>

<Frame caption="Sandbox tools in the order details view">
  <img src="https://mintcdn.com/getivy/J1t6OrlJaZyvflSC/images/docs/simulationOnOrders.png?fit=max&auto=format&n=J1t6OrlJaZyvflSC&q=85&s=43374750cd93c9a78c1e71f563ecfa97" alt="Sandbox tools for simulating order flows" width="878" height="464" data-path="images/docs/simulationOnOrders.png" />
</Frame>

<Note>
  Simulation is not available with direct settlement enabled.
</Note>

## Production

Switch to your live API keys once sandbox testing is complete.

<Warning>
  Production uses real money. Start with small amounts.
</Warning>

### Recommended test cases

| Test case                         | Expected outcome                                        |
| --------------------------------- | ------------------------------------------------------- |
| Successful payments from 4+ banks | Orders reach `paid` and webhooks are received.          |
| Customer cancels at the bank      | Order `failed` with `payment_abandoned` classification. |
| Insufficient funds                | Order `failed` with `insufficient_funds`.               |