Issuance API overview

Heads up: Stablecoin issuance is a permissioned product and must be explicitly enabled by our team before use. If you’re interested in accessing our stablecoin issuance APIs, please contact us to request activation and discuss eligibility and setup.

Prerequisites

To mint or redeem, create a BUSINESS identity and submit compliance data for that entity. See this page for more details.

Mint workflow

This flow enables minting stablecoin tokens to an address on a supported blockchain. At this time, the only supported blockchain is SOLANA_DEVNET

Step 1: Register a mint destination address

Endpoint: POST /v2/issuance/mint-addresses Registers an on-chain address as an eligible destination for minted tokens. Tokens cannot be minted to an address that has not been successfully registered.

Request

{
  "request_id": "123e4567-e89b-12d3-a456-426655440000",
  "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
  "address": "8DwKActJ8swmNXGLyfdaoe6vmD2TxX19bhyE3txsmwfj",
  "chain": "SOLANA_DEVNET",
  "label": "treasury hot wallet"
}

Response

{
    "id": "addr_30CKPHEXdXjb91BZ4FWh5DkLul4",
    "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
    "address": "8DwKActJ8swmNXGLyfdaoe6vmD2TxX19bhyE3txsmwfj",
    "chain": "SOLANA_DEVNET",
    "label": "treasury hot wallet"
}

Step 2: Create mint instructions

Endpoint: POST /v2/issuance/mint-instructions Creates a mint instruction for a given identity. This endpoint will return the following information, which will be needed to trigger a mint:

Details about the bank account that funds must be transferred to in order to trigger a mint
A memo_id, which must be attached to the memo field of any wire transfer sent to the returned bank account in order to trigger a mint

Request

{
  "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
  "request_id": "123e4567-e89b-12d3-a456-426655440000",
  "stablecoin_symbol": "USDX",
  "mint_destination_address_id": "34enYhNwqK0rpKeZA1jnEzW3SFt",
  "payment_rail": "WIRE",
  "fiat_currency_symbol": "USD"
}

Response

{
  "mint_instructions": {
    "id": "34eo2o437kfJDk0QfKYXPmHZ4Ik",
    "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
    "request_id": "123e4567-e89b-12d3-a456-426655440000",
    "stablecoin_symbol": "USDX",
    "chain": "SOLANA_DEVNET",
    "mint_destination_address_id": "34enYhNwqK0rpKeZA1jnEzW3SFt",
    "payment_rail": "WIRE",
    "fiat_currency_symbol": "USD",
    "memo_id": "4Q1EBF3HXY5WD30L",
    "bank_account_details": {
      "name": "Bastion Bank",
      "account_holder_name": "Bastion Bank Account Holder",
      "account_number": "123456789",
      "routing_number": "123456789",
      "type": "CHECKING",
      "address": {
        "street_line_1": "123 Main St",
        "street_line_2": "Apt 1",
        "city": "New York",
        "postal_code": "10001",
        "country": "US",
        "region_code": "NY"
      }
    }
  }
}

Step 3: Send a wire transfer

Send a wire transfer following the mint instructions generated in step 2. Alternatively, in sandbox you may simulate a wire transfer via the Simulate Fiat Deposit endpoint. Calling this endpoint with the request body provided below will trigger a test mint. The ID of the triggered mint will be returned in the response.

Request

{
	"amount": "1234",
  "memo_id": "4Q1EBF3HXY5WD30L",
  "currency": "USD",
	"payment_rail": "WIRE"
}

Response

{
	"mint_id": "mint_3xcfXpYaLMLg22TxP1ZEQ09tOq9"
}

Step 4: View mint history

Endpoint: GET /v2/issuance/mints List mints and their statuses.

Sample call

GET /v2/issuance/mints?identity_id=34ekQKpGgpmjAZ4DNu9KiTfGmxk&status=ACCEPTED

Response

{
  "mints": [
    {
      "id": "mint_3xcfXpYaLMLg22TxP1ZEQ09tOq9",
      "amount": "1000",
      "chain": "SOLANA_DEVNET",
      "mint_address_id": "addr_30CKPHEXdXjb91BZ4FWh5DkLul4",
      "status": "ACCEPTED",
      "external_tx_id": "",
      "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
      "stablecoin_symbol": "USDX"
    }
  ],
  "cursor": null
}

Redemption workflow

Allows customers to redeem tokens for fiat through supported bank rails.

Step 1: Register a bank account

Endpoint: POST /v2/issuance/bank-account Registers a bank account with Bastion. Only registered bank accounts can receive the proceeds of any redemptions.

Request

{
  "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
  "bank_account_details": {
    "name": "Bastion LLC",
    "account_holder_name": "Bastion LLC",
    "account_number": "123456789",
    "routing_number": "123456789",
    "type": "CHECKING",
    "address": {
      "street_line_1": "1234 Main St",
      "city": "San Francisco",
      "country": "US",
      "region_code": "CA",
      "postal_code": "94101"
    }
  }
}

Response

{
  "id": "34exkPlHJyLpOUtxXDdKFPXvQzh",
  "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
  "bank_account_details": {
    "name": "Bastion LLC",
    "account_holder_name": "Bastion LLC",
    "account_number": "123456789",
    "routing_number": "123456789",
    "type": "CHECKING",
    "address": {
      "street_line_1": "1234 Main St",
      "street_line_2": "",
      "city": "San Francisco",
      "postal_code": "94101",
      "country": "US",
      "region_code": ""
    }
  }
}

Step 2: Create redemption instructions

Endpoint: POST /v2/issuance/redemption-instructions Creates a blockchain-to-bank redemption path for a customer. Each redemption instruction is tied to a bank account and fiat payout method and provides a redemption address. When a deposit to this redemption address is detected, a redemption will be initiated.

Request

{
  "request_id": "323e4567-e89b-12d3-a456-426655440000",
  "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
  "bank_account_id": "34exkPlHJyLpOUtxXDdKFPXvQzh",
  "chain": "SOLANA_DEVNET",
  "label": "default redemption",
  "payment_rail": "WIRE",
  "stablecoin_symbol": "USDX"
}

Response

{
  "id": "6xcfXpYaLMLg22TxP1ZEQ09tOq9",
  "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "bank_account_id": "34exkPlHJyLpOUtxXDdKFPXvQzh",
  "chain": "SOLANA_DEVNET",
  "label": "default redemption",
  "payment_rail": "WIRE",
  "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
  "stablecoin_symbol": "USDX"
}

Step 3: Deposit to the redemption address

Transfer the stablecoin you would like to redeem to the redemption address generated in step 2.

Step 4: View redemption history

Endpoint: GET /v2/issuance/redemptions

Sample call

GET /v2/issuance/redemptions?identity_id=34ekQKpGgpmjAZ4DNu9KiTfGmxk&status=ACCEPTED

Response

{
  "redemptions": [
    {
      "id": "red_3xcfXpYaLMLg22TxP1ZEQ09tOq8",
      "amount": "1000",
      "chain": "SOLANA_DEVNET",
      "redemption_address_id": "raddr_6xcfXpYaLMLg22TxP1ZEQ09tOq9",
      "from_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "status": "ACCEPTED",
      "deposit_external_tx_id": "",
      "burn_external_tx_id": "",
      "identity_id": "34ekQKpGgpmjAZ4DNu9KiTfGmxk",
      "stablecoin_symbol": "USDX"
    }
  ],
  "cursor": null
}

Authentication

API Reference

Webhooks

Issuance API overview

Prerequisites

Mint workflow

Step 1: Register a mint destination address

Request

Response

Step 2: Create mint instructions

Request

Response

Step 3: Send a wire transfer

Request

Response

Step 4: View mint history

Sample call

Response

Redemption workflow

Step 1: Register a bank account

Request

Response

Step 2: Create redemption instructions

Request

Response

Step 3: Deposit to the redemption address

Step 4: View redemption history

Sample call

Response

​Prerequisites

​Mint workflow

​Step 1: Register a mint destination address

​Request

​Response

​Step 2: Create mint instructions

​Request

​Response

​Step 3: Send a wire transfer

​Request

​Response

​Step 4: View mint history

​Sample call

​Response

​Redemption workflow

​Step 1: Register a bank account

​Request

​Response

​Step 2: Create redemption instructions

​Request

​Response

​Step 3: Deposit to the redemption address

​Step 4: View redemption history

​Sample call

​Response

Prerequisites

Mint workflow

Step 1: Register a mint destination address

Request

Response

Step 2: Create mint instructions

Request

Response

Step 3: Send a wire transfer

Request

Response

Step 4: View mint history

Sample call

Response

Redemption workflow

Step 1: Register a bank account

Request

Response

Step 2: Create redemption instructions

Request

Response

Step 3: Deposit to the redemption address

Step 4: View redemption history

Sample call

Response