Sign in
latestOpenAPI 3.0.32026-08-224982,0272.8 MB

e445c15e5bee

Stablecoin

Create issuer-direct stablecoin order

Creates a mint or burn order via the issuer-direct (Path 2) flow, bypassing the standard client deposit verification.

post/api/stablecoin/v1/enterprise/{enterpriseId}/issuer/orders

Path parameters

enterpriseIdstring required
Example:67bc4ae090e8af8f9b412d3d67e85252

Enterprise id

Request body

type'mint' | 'burn' required

Type of order operation (mint or burn)

assetstring required

Full asset identifier (e.g., "eth:usd1", "hteth:sofid")

amountstring required

Amount in base units. For burn, this is stablecoin base-units. For mint: stablecoin base-units when the enterprise has the stablecoins-issuer-mint-stablecoin-units flag enabled; otherwise USD base-units (e.g. cents) for legacy behavior.

destinationType'go_account' required

Type of destination for the order. Only go_account is supported for both mint and burn.

destinationWalletIdstring required

Destination wallet identifier. Required for all order types.

Example request

{
  "type": "mint",
  "asset": "eth:usd1",
  "amount": "100000000000000000000",
  "destinationType": "go_account",
  "destinationWalletId": "8iMXoeSpS1d1ziEJ"
}

Response

OK

assetstring

Full asset identifier (e.g., "eth:usd1", "hteth:sofid")

destinationWalletIdstring

Destination wallet identifier

destinationAddressstring

Destination blockchain address

userIdstring

User identifier who initiated the order

clientDepositTxHashstring

Transaction hash of the client deposit

memostring

Optional free-text memo or comment annotating the order.

createdAtstring date-time required

Timestamp when the order was created

updatedAtstring date-time required

Timestamp when the order was last updated

fromAssetIdstring uuid required

Source asset identifier (UUID)

toAssetIdstring uuid required

Destination asset identifier (UUID)

fromAssetstring required

Source asset token identifier

fromAmountstring required

Amount to be transferred from source asset, specified in its lowest denomination.

toAssetstring required

Destination asset token identifier

toAmountstring required

Amount to be received in destination asset

orderMethod'issuer_direct' | 'client_deposit'

How the order was initiated: issuer-direct or standard client deposit flow

idstring uuid required

Unique identifier for the order

type'mint' | 'burn' | 'reward' required

Type of order operation

status'created' | 'confirmed_fiat_deposit' | 'confirmed_token_deposit' | 'initiated_burn_token_transfer' | 'completed_burn_token_transfer' | 'approved_mint' | 'triggering_mint' | 'triggering_burn' | 'completed_burn' | 'approved_client_disbursal' | 'initiated_client_disbursal' | 'fulfilled' | 'failed_mint_initiation' | 'failed_mint_transaction' | 'failed_burn_transaction' | 'failed_burn_token_transfer' | 'failed_to_mint' | 'failed_to_burn' | 'failed_to_initiate_disbursal' | 'failed_to_complete_disbursal' | 'rejected' | 'failed' | 'expired' | 'triggering_mint_request' | 'completed_mint_request' | 'triggering_mint_offer' | 'completed_mint_offer' | 'triggering_mint_accept' | 'completed_mint_accept' | 'triggering_mint_transfer' | 'failed_to_mint_request' | 'failed_to_mint_offer' | 'failed_to_mint_accept' | 'failed_to_mint_transfer' | 'rejected_mint_transfer' | 'cancelled_mint_transfer' | 'expired_mint_transfer' | 'triggering_burn_request' | 'completed_burn_request' | 'triggering_burn_accept' | 'failed_to_burn_request' | 'failed_to_burn_accept' | 'pending_policy_approval' | 'policy_rejected' required

Current status of the order

enterpriseIdstring required

The Enterprise ID

Example response

{
  "asset": "eth:usd1",
  "destinationWalletId": "8iMXoeSpS1d1ziEJ",
  "destinationAddress": "d526909b2398a6d579c817dc07fc9d72",
  "userId": "test-user",
  "transactions": [
    {
      "type": "clientDeposit",
      "txHash": "512f64d10b5f358f6dbf3303f90013cfa46006b02a03282456d6bd6432cc5daf",
      "asset": "eth:usd1",
      "amount": "500",
      "status": "confirmed",
      "createdAt": "2025-04-04T09:26:21.600Z",
      "updatedAt": "2025-04-04T09:26:21.600Z"
    }
  ],
  "memo": "Payment for invoice #1234",
  "createdAt": "2025-04-04T09:25:48.216Z",
  "updatedAt": "2025-04-04T09:55:09.136Z",
  "fromAssetId": "08c1271e-b15d-4af8-8929-f75383903da4",
  "toAssetId": "49ff49ea-3355-4717-bbb0-5e8f5cae2202",
  "fromAsset": "eth:usd1",
  "fromAmount": "500",
  "toAsset": "eth:usd1",
  "toAmount": "5000000",
  "orderMethod": "issuer_direct",
  "id": "95bdbd9c-9cdc-41a4-ae70-165387b7aa51",
  "type": "mint",
  "status": "fulfilled",
  "enterpriseId": "67bc4ae090e8af8f9b412d3d67e85252"
}