Minteo API
The Minteo API lets you tokenize and move stablecoins programmatically. You can collect funds from end-users (Payins), send funds to third parties (Payouts), and convert between fiat and stablecoins (Orders).
Base URL
- Production
- Sandbox
https://api.minteo.finance/v1https://api.sandbox.minteo.finance/v1Authentication
All requests require a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEYGet your API key from the Minteo Dashboard (or Sandbox Dashboard for testing). See Authentication for details on creating and managing keys.
Make your first API call
List your wallets to verify your setup:
- Production
- Sandbox
GET/v1/wallets
curl https://api.minteo.finance/v1/wallets \-H "Authorization: Bearer YOUR_API_KEY"GET/v1/wallets
curl https://api.sandbox.minteo.finance/v1/wallets \-H "Authorization: Bearer YOUR_API_KEY"You should see a response like:
- Production
- Sandbox
RESPONSE
{ "output": [ { "id": "ffdda2d3-4278-45ac-b244-8499dc1a8906", "wallet_name": "Main Wallet", "chain": "POLYGON", "currency_id": "COPM", "address": "0xacf8D012Fb6245aFD475E3ecae90cFAfC2c601A3" } ], "code": "OK"}RESPONSE
{ "output": [ { "id": "ffdda2d3-4278-45ac-b244-8499dc1a8906", "wallet_name": "Main Wallet", "chain": "POLYGON", "currency_id": "testCOPM", "address": "0xacf8D012Fb6245aFD475E3ecae90cFAfC2c601A3" } ], "code": "OK"}You're connected. Now you can:
- Create a Payin — collect funds from an end-user
- Create a Payout — send funds to a third party
- Create an Order — tokenize or redeem between your own accounts
- Set up Webhooks — get notified when events happen
Key concepts
| Concept | Description |
|---|---|
| COPM | Colombian Peso stablecoin. The token used for all operations. |
| Wallet | A blockchain wallet that holds your COPM tokens. Each wallet has an address on Polygon. |
| Payin | Collect fiat from an end-user (via PSE) and tokenize it into COPM. |
| Payout | Send COPM tokens to a third party's bank account as fiat. |
| Order | Tokenize (fiat → COPM) or redeem (COPM → fiat) between your own accounts. |
| Bridge | Transfer tokens between wallets. |
| PSE | Pagos Seguros en Linea — Colombia's online bank transfer system. |
| BreB | Instant interbank transfer using recipient keys (phone, email, etc). |
| Sandbox | Test environment with fake money. Use testCOPM token and OUTBANK bank. |
Environments
| Production | Sandbox | |
|---|---|---|
| API | api.minteo.finance | api.sandbox.minteo.finance |
| Dashboard | board.minteo.com | board.sandbox.minteo.com |
| Token | COPM | testCOPM |
| Bank | See bank list | OUTBANK |