Skip to main content
POST
/
organizations
/
{organization_id}
/
external_payment_instruments
Create External Payment Instrument
curl --request POST \
  --url https://api-sandbox.stablesea.com/v1/organizations/{organization_id}/external_payment_instruments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "alias": "My Primary Wallet",
  "currency": "USDC",
  "method": "SOLANA_ADDRESS",
  "details": {
    "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
  }
}
'
{
  "data": {
    "id": "mnyacctcop_01k4r01nkxf41vpxc3nekphrx8",
    "alias": "My COP Bank Account",
    "currency": "COP",
    "method": "COP_BANK_ACCOUNT",
    "status": {
      "current_status": "COMPLIANCE_HOLD",
      "status_history": [
        {
          "status": "COMPLIANCE_HOLD",
          "created_at": "2024-01-15T10:00:00Z"
        }
      ]
    },
    "details": {
      "bank_account_number": "1234567890",
      "bank_code": "001",
      "account_holder_first_name": "John",
      "account_holder_last_name": "Doe",
      "legal_entity_name": "Acme Corporation",
      "doc_type": "CC",
      "doc_id": "1234567890",
      "physical_address": "123 Main St, Bogota, Colombia",
      "account_type": "CHECKING"
    },
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}
This endpoint is used to create an external account for an organization. External accounts are used to receive payouts from Stable Sea.
Stable Sea will perform diligence on the external account to ensure it is valid and compliant with regulations prior to approving it for usage.

​
Common Headers

HeaderValueRequiredDescription
AuthorizationBearer <api-key>trueYour API key for authentication
Content-Typeapplication/jsontrueContent type of the request
Idempotency-Key<unique-uuid>trueUnique key to prevent duplicate operations

​
Path

​
organization_id
string
required
ID of organization

​
Body

​
alias
string
required
A descriptive name for the payment instrument
​
currency
string
required
Currency of the payment instrument (see Currency Symbols in Resources)
​
method
string
required
Payment method (see Payment Methods in Resources)
​
details
object
required
Payment instrument details - structure varies by method
The method field will be used to determine the details object schema

​
Response

{
  "data": {
    "id": "mnyacctcop_01k4r01nkxf41vpxc3nekphrx8",
    "alias": "My COP Bank Account",
    "currency": "COP",
    "method": "COP_BANK_ACCOUNT",
    "status": {
      "current_status": "COMPLIANCE_HOLD",
      "status_history": [
        {
          "status": "COMPLIANCE_HOLD",
          "created_at": "2024-01-15T10:00:00Z"
        }
      ]
    },
    "details": {
      "bank_account_number": "1234567890",
      "bank_code": "001",
      "account_holder_first_name": "John",
      "account_holder_last_name": "Doe",
      "legal_entity_name": "Acme Corporation",
      "doc_type": "CC",
      "doc_id": "1234567890",
      "physical_address": "123 Main St, Bogota, Colombia",
      "account_type": "CHECKING"
    },
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

Authorizations

​
Authorization
string
header
default:DEFAULT-TOKEN-HERE
required

Use your API key as the bearer token

Headers

​
Idempotency-Key
string
required

Unique key to prevent duplicate operations

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

​
organization_id
string
required

ID of organization

Example:

"org_01k2cm4r59e5z8k5ggrbbxjcwy"

Body

application/json

External payment instrument to create

​
alias
string
required
Example:

"My Primary Wallet"

​
currency
enum<string>
required
Available options:
USDC,
COP,
...more to come...
​
method
enum<string>
required
Available options:
SOLANA_ADDRESS,
COP_BANK_ACCOUNT,
...more to come...
​
details
SOLANA_ADDRESS · object
required

Response

201 - application/json

External payment instrument created successfully

​
data
object