Mint Bastion-issued stablecoins with the Issuance API

Mint Bastion-issued stablecoins

This guide walks you through the process of minting stablecoins using Bastion’s Issuance API. Minting converts fiat currency (USD) into stablecoins that Bastion delivers to a specified blockchain address.

Overview

The minting process involves several steps:

Create a mint destination address - Register the blockchain address where Bastion sends minted stablecoins
Create mint instructions - Set up the minting configuration linking the identity, destination address, and payment details
Send a wire transfer - Initiate the mint by sending USD to the provided bank account with the memo ID
Monitor the mint - Track the status of your mint request

Prerequisites

Before you begin, ensure you have:

A valid API key with issuance permissions
An approved Business identity created for the minting entity
- Note that Issuance is not supported for Individual identities at this moment
A blockchain wallet address on a supported chain (Solana Mainnet, Solana Devnet, or Base Sepolia)

Step 1: create a mint destination address

First, register the blockchain address where Bastion delivers minted stablecoins.

Request

curl -X POST https://api.prod.bastion.com/v2/issuance/mint-addresses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "address": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV",
    "chain": "SOLANA_DEVNET",
    "label": "Treasury Wallet",
    "identity_id": "id_123456789"
  }'

Request parameters

Parameter	Type	Required	Description
`request_id`	string (UUID)	Yes	Idempotency key in UUID format
`address`	string	Yes	The blockchain wallet address to receive minted stablecoins
`chain`	enum	Yes	Blockchain network: `SOLANA_DEVNET`
`label`	string	Yes	A human-readable label for the address
`identity_id`	string	Yes	The identity ID that owns this mint address

Response

{
  "id": "mda_abc123def456",
  "address": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV",
  "chain": "SOLANA_DEVNET",
  "label": "Treasury Wallet",
  "identity_id": "id_123456789"
}

Step 2: create mint instructions

Create mint instructions that specify how Bastion processes mints, including the destination address and payment details.

Request

curl -X POST https://api.prod.bastion.com/v2/issuance/mint-instructions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "identity_id": "id_123456789",
    "request_id": "660e8400-e29b-41d4-a716-446655440001",
    "stablecoin_symbol": "USDX",
    "mint_destination_address_id": "mda_abc123def456",
    "payment_rail": "WIRE",
    "fiat_currency_symbol": "USD",
    "label": "Primary Mint Instructions"
  }'

Request parameters

Parameter	Type	Required	Description
`identity_id`	string	Yes	The identity ID for this mint instruction
`request_id`	string (UUID)	Yes	Idempotency key in UUID format
`stablecoin_symbol`	string	Yes	Symbol of the stablecoin to mint (e.g., `USDX`). Confirm the symbol to be used with your Bastion representative
`mint_destination_address_id`	string	Yes	ID of the mint destination address created in Step 1
`payment_rail`	enum	Yes	Payment method (currently only `WIRE` is supported)
`fiat_currency_symbol`	enum	Yes	Fiat currency (currently only `USD` is supported)
`label`	string	No	A human-readable label for the instruction

Response

{
  "mint_instructions": {
    "id": "mi_xyz789abc123",
    "identity_id": "id_123456789",
    "request_id": "660e8400-e29b-41d4-a716-446655440001",
    "stablecoin_symbol": "USDX",
    "chain": "SOLANA_DEVNET",
    "mint_destination_address_id": "mda_abc123def456",
    "payment_rail": "WIRE",
    "fiat_currency_symbol": "USD",
    "memo_id": "BSTN-MI-12345",
    "bank_account_details": {
      "bank_name": "Partner Bank",
      "account_holder_name": "Bastion Treasury Services",
      "account_number": "123456789012",
      "routing_number": "021000021",
      "type": "checking",
      "address": {
        "street_line_1": "123 Financial District",
        "city": "New York",
        "postal_code": "10004",
        "country": "US",
        "region_code": "NY"
      }
    },
    "label": "Primary Mint Instructions"
  }
}

Important: Save the memo_id and bank_account_details from the response. You’ll need these to initiate the wire transfer.

Step 3: initiate the mint (wire transfer)

To mint stablecoins, send a wire transfer to the bank account provided in the mint instructions response. Critical requirements:

Include the memo ID: The wire transfer must include the memo_id from Step 2 in the memo/reference field. Without this, Bastion cannot process the mint.
Use the correct bank details: Send funds to the exact bank account details provided in bank_account_details.
Supported currency: Only USD wire transfers are currently supported.

Once Bastion receives and verifies the wire transfer, it automatically mints the equivalent amount of stablecoins and sends them to your registered mint destination address.

Initiating test mints in sandbox

In sandbox you can simulate a wire transfer via the Simulate Fiat Deposit endpoint. Call this endpoint with the request body below to trigger a test mint. The response returns the ID of the triggered mint.

Request

{
	"amount": "1234",
  "memo_id": "BSTN-MI-12345",
  "currency": "USD",
	"payment_rail": "WIRE"
}

Response

{
	"mint_id": "mint_001abc"
}

Step 4: monitor mint status

List all mints

curl -X GET "https://api.prod.bastion.com/v2/issuance/mints?identity_id=id_123456789&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query parameters

Parameter	Type	Required	Description
`status`	enum	No	Filter by status: `ACCEPTED`, `SUBMITTED`, `COMPLETED`, `DENIED`, `FAILED`, `CANCELLED`
`limit`	integer	No	Max results per page (1-25, default: 10)
`cursor`	string	No	Pagination cursor for next page
`identity_id`	string	No	Filter by identity ID

Response

{
  "mints": [
    {
      "id": "mint_001abc",
      "amount": "10000.00",
      "chain": "SOLANA_DEVNET",
      "mint_address_id": "mda_abc123def456",
      "status": "COMPLETED",
      "external_tx_id": "5wHu2hC7rnP3YqKf...",
      "identity_id": "id_123456789",
      "stablecoin_symbol": "USDC"
    }
  ],
  "cursor": "eyJsYXN0X2lkIjoibWludF8wMDFhYmMifQ=="
}

Get a specific mint

curl -X GET https://api.prod.bastion.com/v2/issuance/mints/mint_001abc \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "mint_001abc",
  "amount": "10000.00",
  "chain": "SOLANA_DEVNET",
  "mint_address_id": "mda_abc123def456",
  "status": "COMPLETED",
  "external_tx_id": "5wHu2hC7rnP3YqKf...",
  "identity_id": "id_123456789",
  "stablecoin_symbol": "USDC"
}

Mint status values

Status	Description
`ACCEPTED`	Wire transfer received and mint request accepted
`SUBMITTED`	Mint transaction submitted to the blockchain
`COMPLETED`	Stablecoins successfully minted and delivered
`DENIED`	Mint request was denied (compliance or other reasons)
`FAILED`	Mint transaction failed
`CANCELLED`	Mint request was cancelled

Additional endpoints

List mint destination addresses

curl -X GET "https://api.prod.bastion.com/v2/issuance/mint-addresses?identity_id=id_123456789" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get mint destination address

curl -X GET https://api.prod.bastion.com/v2/issuance/mint-addresses/mda_abc123def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

List mint instructions

curl -X GET "https://api.prod.bastion.com/v2/issuance/mint-instructions?identity_id=id_123456789" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get mint instructions

curl -X GET https://api.prod.bastion.com/v2/issuance/mint-instructions/mi_xyz789abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Supported chains

Chain	Enum value
Solana Devnet	`SOLANA_DEVNET`
Base Sepolia (Currently not available)	`BASE_SEPOLIA`

Error handling

HTTP status	Description
`400`	Bad request - Check request parameters
`401`	Unauthorized - Invalid or missing API key
`404`	Resource not found
`409`	Conflict - Resource already exists (check idempotency key)
`500`	Internal server error

Webhooks

Configure webhooks to receive real-time notifications when mint status changes. See the Webhooks documentation for setup instructions.

Best practices

Use unique request IDs: Always generate a new UUID for each request_id to ensure idempotency.
Verify bank details: Double-check the bank account details before initiating wire transfers.
Include memo ID: Always include the exact memo_id in your wire transfer memo field.
Monitor status: Use webhooks or polling to track mint progress.
Test on Devnet: Use Solana Devnet or Base Sepolia for testing before moving to production.

Getting Started

Concepts

Quickstarts

Compliance

Security

Bastion Dashboard

LLMs and MCP Server

Mint Bastion-issued stablecoins with the Issuance API