Connected Account Lookup

Look up the Stripe connected account for an organization. Use this when you have an organization_id and need the Stripe account ID for Connect payment routing.

---

Get Connected Account

GET /v1/ecommerce/connected-account

Authentication: OAuth Token

Scope: transactcore:connected-accounts.read

Rate Limit: 100/min per IP

Query Parameters

Parameter	Type	Required	Description
organization_id	string	Yes	The organization hashkey to look up

Response

{
  "connected_account_id": "cct_00000k1L2m3N4o5",
  "stripe_account_id": "acct_1234567890",
  "status": "active",
  "charges_enabled": true,
  "payouts_enabled": true
}

Response Fields

Field	Type	Description
connected_account_id	string	TransactCore connected account hashkey
stripe_account_id	string	Stripe Connect account ID for use with Stripe.js
status	string	Account status: pending, active, restricted, or disabled
charges_enabled	boolean	Whether the account can accept payments
payouts_enabled	boolean	Whether the account can receive payouts

Examples

curl "https://api.transactcore.retailsuccessplatform.com/api/v1/ecommerce/connected-account?organization_id=org_00000k1L2m3N4o5" \
  -H "Authorization: Bearer ${TOKEN}"

Error Responses

404 Not Found — No connected account exists for the organization:

{
  "error": "No connected account found for this organization."
}

422 Unprocessable Entity — Missing organization_id:

{
  "message": "The organization id field is required.",
  "errors": {
    "organization_id": ["The organization id field is required."]
  }
}

Notes

• Returns the first connected account for the organization regardless of status — check charges_enabled before routing payments
• Use the returned stripe_account_id with Stripe Elements on_behalf_of for Connect mode
• Use the returned connected_account_id hashkey with other TransactCore endpoints (e.g., /config/stripe, /payment-intents)

---

Changelog

Date	Change
2026-03-19	Initial publication.