curl "https://api.telzino.com/v1/organizations/123e4567-e89b-12d3-a456-426614174000/payments/status?refresh=true" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const orgId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(
`https://api.telzino.com/v1/organizations/${orgId}/payments/status`,
{ headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN' } }
);
const status = await response.json();
if (status.can_accept_payments) {
// merchant is charge-ready
}
import requests
org_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.get(
f'https://api.telzino.com/v1/organizations/{org_id}/payments/status',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
status = response.json()
{
"organization_id": "123e4567-e89b-12d3-a456-426614174000",
"stripe_account_id": "acct_1AbC2DeFgHiJkLmN",
"account_status": "active",
"charges_enabled": true,
"payouts_enabled": true,
"details_submitted": true,
"can_accept_payments": true
}
{
"error": "Invalid organization_id"
}
{
"error": "unauthorized",
"error_description": "User payload not found"
}
{
"error": "Forbidden",
"error_description": "You do not have access to this organization"
}
{
"error": "Organization not found"
}
Payments
Get Merchant Payment Status
Check whether a merchant’s Stripe connected account can accept charges
GET
/
v1
/
organizations
/
{organization_id}
/
payments
/
status
curl "https://api.telzino.com/v1/organizations/123e4567-e89b-12d3-a456-426614174000/payments/status?refresh=true" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const orgId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(
`https://api.telzino.com/v1/organizations/${orgId}/payments/status`,
{ headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN' } }
);
const status = await response.json();
if (status.can_accept_payments) {
// merchant is charge-ready
}
import requests
org_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.get(
f'https://api.telzino.com/v1/organizations/{org_id}/payments/status',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
status = response.json()
{
"organization_id": "123e4567-e89b-12d3-a456-426614174000",
"stripe_account_id": "acct_1AbC2DeFgHiJkLmN",
"account_status": "active",
"charges_enabled": true,
"payouts_enabled": true,
"details_submitted": true,
"can_accept_payments": true
}
{
"error": "Invalid organization_id"
}
{
"error": "unauthorized",
"error_description": "User payload not found"
}
{
"error": "Forbidden",
"error_description": "You do not have access to this organization"
}
{
"error": "Organization not found"
}
Returns whether an organization’s Stripe connected account is onboarded and able to accept charges. Read-only. Serves the cached account status by default; pass
?refresh=true to re-sync live from Stripe (slower).
Path Parameters
string
required
UUID of the organization (merchant). Must belong to your account.Example:
123e4567-e89b-12d3-a456-426614174000Query Parameters
boolean
default:"false"
When
true, re-syncs the connected account’s capabilities from Stripe before responding instead of serving the cached row. Use sparingly (e.g. right after onboarding) — it adds a Stripe round trip.curl "https://api.telzino.com/v1/organizations/123e4567-e89b-12d3-a456-426614174000/payments/status?refresh=true" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const orgId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(
`https://api.telzino.com/v1/organizations/${orgId}/payments/status`,
{ headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN' } }
);
const status = await response.json();
if (status.can_accept_payments) {
// merchant is charge-ready
}
import requests
org_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.get(
f'https://api.telzino.com/v1/organizations/{org_id}/payments/status',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
status = response.json()
{
"organization_id": "123e4567-e89b-12d3-a456-426614174000",
"stripe_account_id": "acct_1AbC2DeFgHiJkLmN",
"account_status": "active",
"charges_enabled": true,
"payouts_enabled": true,
"details_submitted": true,
"can_accept_payments": true
}
{
"error": "Invalid organization_id"
}
{
"error": "unauthorized",
"error_description": "User payload not found"
}
{
"error": "Forbidden",
"error_description": "You do not have access to this organization"
}
{
"error": "Organization not found"
}
Response Fields
| Field | Type | Description |
|---|---|---|
organization_id | string | Merchant UUID |
stripe_account_id | string | null | The Stripe connected account id, or null if onboarding hasn’t started |
account_status | string | not_started, onboarding, active, or restricted — see Payments Overview |
charges_enabled | boolean | Whether Stripe allows this account to accept charges |
payouts_enabled | boolean | Whether Stripe allows payouts to the merchant’s bank |
details_submitted | boolean | Whether the merchant has finished submitting onboarding details |
can_accept_payments | boolean | Convenience flag: true only when account_status is active and charges_enabled |
⌘I
