Testing in Sandbox

Before You Start

Read the following guides before proceeding:

Guide	Why
Getting Started	Platform overview and setup
Api Basics	Required headers and request configuration
Authentication	How to obtain access tokens
Onboarding	User and wallet registration
KYC	KYC verification requirements

The Sandbox Helper API provides methods for simulating external events that cannot be triggered through the standard BaaS API. This includes bank deposits arriving, outbound transfers completing, and card transactions at merchants.

These endpoints allow you to test complete user flows without waiting for real banking infrastructure or card network events. The helper API triggers the same webhooks and state changes that would occur in production when external systems process transactions.

Important: The Sandbox Helper API is available only in the sandbox environment at https://ramc.wirexapp.tech. It does not exist in production.

Available Operations

Category	Operations
Token Minting	Mint test tokens to user wallets
SEPA (EUR)	Simulate deposits, complete/revert outbound transfers
ACH (USD)	Activate accounts, simulate deposits, complete/revert transfers
Card Transactions	Simulate POS, e-commerce, ATM, and refund transactions

Test Flow Examples

SEPA Deposit and Transfer

sequenceDiagram
    participant User
    participant App as Your App
    participant BaaS as Wirex BaaS
    participant Helper as Helper API

    Note over App,Helper: Simulate Deposit
    App->>Helper: POST /bank/sepa/deposit
    Helper-->>BaaS: Simulates bank event
    BaaS->>App: POST /v2/webhooks/activities<br/>(type: Sepa, Inbound)

    Note over User,BaaS: User Sends Transfer
    User->>App: Send EUR
    App->>BaaS: POST /api/v1/bank/transfer
    BaaS-->>App: activity_id

    Note over App,Helper: Complete Transfer
    App->>Helper: POST /bank/sepa/transfer/complete
    Helper-->>BaaS: Simulates completion
    BaaS->>App: POST /v2/webhooks/activities<br/>(status: Completed)

Card Transaction

sequenceDiagram
    participant User
    participant App as Your App
    participant BaaS as Wirex BaaS
    participant Helper as Helper API

    Note over User,BaaS: Issue Card
    User->>App: Request card
    App->>BaaS: POST /api/v2/cards
    BaaS-->>App: card_id

    Note over App,Helper: Simulate Purchase
    App->>Helper: POST /card/auth-and-clearing
    Helper-->>BaaS: Simulates auth + clearing
    BaaS->>App: POST /v2/webhooks/activities<br/>(type: CardTransaction)