Sandbox

Create test users and credit them with funds using the Bipa Console in sandbox mode.

Overview

The sandbox environment lets you build and test your integration without moving real money or requiring real KYC. In sandbox mode you get:

• Test users — create users instantly, no KYC required
• Fake BRL funds — credit any amount to test balances
• Bacen staging Pix — Pix payments execute against the central bank staging environment
• Testnet crypto — crypto transactions run on testnets

To get your sandbox API keys, see Authentication.

Creating test users

1. Log in to Console

   Go to infra.bipa.app and sign in with your account.

2. Open Partner Users

   In the sidebar, click Partner Users.

3. Create a user

   Click Create User and fill in the required fields:

   Field	Format	Example
   CPF	11 digits	12345678900
   Full Name	Text	Maria Silva
   Birth Date	YYYY-MM-DD	1990-01-15
   Mother’s Name	Text	Ana Silva

4. Get the user ID

   Submit the form. The user is created instantly with no KYC verification, and a user_id is returned.

The Partner Users menu is only visible when you are in sandbox mode. If you don’t see it, make sure you are using a test API key (bipa_test_).

Crediting test users

1. Find the user

   From the Partner Users page, locate the user you want to credit.

2. Add funds

   Click Add Funds and enter the amount in BRL.

   • Minimum: greater than R$0
   • Maximum: R$1,000,000.00
3. Confirm

   Funds are added instantly to the user’s sandbox BRL balance.

Next steps

Authentication

Set up your sandbox and production API keys.

API Reference

Explore the full API to start building your integration.