Create Embedded Account

POST

https://api-sandbox.coinflow.cash/api/merchant/accounts/embedded-accounts

POST

/api/merchant/accounts/embedded-accounts

curl -X POST https://api-sandbox.coinflow.cash/api/merchant/accounts/embedded-accounts \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "string",
  "managedType": "individual",
  "group": "string",
  "email": "string"
}'

200Successful

{
  "_id": "string",
  "wallet": "string",
  "blockchain": "solana",
  "email": "string",
  "availability": {
    "status": "Functional",
    "reason": "string",
    "editor": "string",
    "updatedAt": "2024-01-15T09:30:00Z"
  },
  "currency": "USD",
  "merchant": "string",
  "verification": {
    "reference": "string",
    "status": "pending",
    "vendor": "middesk",
    "name": "string",
    "attested": true,
    "shareToken": "string",
    "shareTokenStatus": "string",
    "sessionToken": "string",
    "rejectionReasons": [
      "string"
    ]
  },
  "riskScoreOverride": true,
  "country": "string",
  "originalCurrency": "USD",
  "geoBlockOverride": {
    "reason": "string",
    "setBy": "string",
    "setAt": "2024-01-15T09:30:00Z",
    "expiresAt": "2024-01-15T09:30:00Z"
  },
  "blockCardReuseExempt": true,
  "createdAt": "2024-01-15T09:30:00Z",
  "wallets": [
    {
      "wallet": "string",
      "blockchain": "solana"
    }
  ]
}

Authentication

Authorizationstring

The API key of the merchant - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

Request

This endpoint expects an object.

namestringRequired

managedTypeenumRequired

Allowed values:

groupstringRequired

emailstringRequired

Response

_idstring

walletstring

blockchainenum

emailstring

availabilityobject

currencyenum

merchantstring or object

verificationobject

riskScoreOverrideboolean

countrystring

originalCurrencyenumOptional

geoBlockOverrideobjectOptional

Per-customer exemption from real-time geographic enforcement.

When set and not expired, withdrawal blocking rules with method GEOLOCATION or IP are skipped for this withdrawer. KYC_ADDRESS rules still apply — KYC is the compliance floor and must remain enforceable.

Auditable by construction: reason and setBy are required so admins can review why a specific user was exempted. expiresAt is optional but strongly recommended; long-lived overrides should be avoided.

blockCardReuseExemptbooleanOptional

When true, this withdrawer is exempt from the merchant banDuplicateAccounts re-use check, so it may add an account that another withdrawer already uses without being blocked (423 PAYMENT_METHOD_IN_USE).

createdAtdatetimeOptional

walletslist of objectsOptionalDeprecated