Sandbox Environment

The sandbox is a fully functional test environment where you can develop and test your integration without using real money. All operations are simulated.

Sandbox vs Production

Aspect	Production	Sandbox
Base URL	https://api.minteo.finance/v1	https://api.sandbox.minteo.finance/v1
Dashboard	board.minteo.com	board.sandbox.minteo.com
Token	COPM	testCOPM
Banks (Payins)	Full list	Only OUTBANK
Banks (Payouts)	Full list	Only OUTBANK
Bank account numbers	Real account numbers	Test account numbers
Money	Real fiat	Simulated (no real transfers)
KYC	Full verification required	Auto-approved
Account creation	Requires approval	Instant access

Sandbox values cheat sheet

Use these values in all sandbox requests:

Field	Sandbox value
Token	testCOPM
Bank (Payins & Payouts)	OUTBANK
Bank account number	1111111111 (success) — see all
Bank account type	SAVINGS or CHECKING
Country	CO
Legal identifier type	CC, CE, NIT, or PP

Common mistakes

• Using COPM instead of testCOPM — sandbox requires testCOPM
• Using a real bank name like BANCOLOMBIA — sandbox only accepts OUTBANK
• These are the two most common errors when testing for the first time

Test bank account numbers

Use these account numbers to simulate different payout scenarios:

Account number	Result	Description
1111111111	Success	Payout completes successfully
2222222222	KYC failure	Recipient KYC validation fails
3333333333	Validation error	Fails due to ownership validation

Use 1111111111 for happy-path testing. Use 2222222222 and 3333333333 to test your error handling logic.

Sandbox-only features

Create Wallets

In sandbox, you can create wallets directly via the API. This is not available in production (wallets are provisioned by the Minteo team).

POST/v1/wallets

curl -X POST 'https://api.sandbox.minteo.finance/v1/wallets' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
  "custom_name": "My Test Wallet",
  "chain": "POLYGON",
  "currency_id": "testCOPM",
  "identifier": "0xYOUR_POLYGON_WALLET_ADDRESS"
}'

Sandbox limitations

• Only one bank — OUTBANK simulates any real bank for both payins and payouts
• Simulated processing — operations auto-process with simulated delays
• No real funds — no actual money moves; balances are simulated
• Webhook events — delivered with simulated delays to mimic real processing times

Quick test commands

1. Verify authentication

GET/v1/wallets

curl https://api.sandbox.minteo.finance/v1/wallets \
-H "Authorization: Bearer YOUR_API_KEY"

2. Create a Payin

POST/v1/payins

curl -X POST 'https://api.sandbox.minteo.finance/v1/payins' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
  "token": "testCOPM",
  "amount": "50000",
  "destination_wallet_id": "YOUR_WALLET_ID",
  "purpose": "Test payin",
  "final_url": "https://yoursite.com/callback",
  "payment": { "method": "PSE", "bank": "OUTBANK" },
  "third_party": {
    "full_name": "Test User",
    "legal_identifier_type": "CC",
    "legal_identifier": "1099075610",
    "country_iso": "CO",
    "email": "test@example.com",
    "phone_number": "3001234567"
  }
}'

3. Create a Payout

POST/v1/payouts

curl -X POST 'https://api.sandbox.minteo.finance/v1/payouts' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
  "fee_type": "DEDUCTED_FROM_ITEM_AMOUNT",
  "origin_source_id": "YOUR_WALLET_ID",
  "items": [{
    "amount": "20000",
    "full_name": "John Doe",
    "token": "testCOPM",
    "legal_identifier_type": "CC",
    "legal_identifier": "123456789",
    "country_iso": "CO",
    "network": "BANK",
    "bank_account_details": {
      "bank_name": "OUTBANK",
      "type": "SAVINGS",
      "number": "1111111111"
    }
  }]
}'

Moving to production

When you're ready to go live:

1. Create a production account at board.minteo.com
2. Complete business verification
3. Generate production API keys
4. Update your base URL from api.sandbox.minteo.finance to api.minteo.finance
5. Replace testCOPM with COPM in all requests
6. Replace OUTBANK with real bank names
7. Use real bank account numbers instead of test values