Dashboard
APIList All Payment Providers API - GET /merchant-accounts | BotSubscription
api.botsubscription.com
GET/v1/endpoint
AuthenticationBearer
Token
Stays in this tab. Required for this endpoint — the value below is what gets sent.
Examples
curl --request GET \
  --url https://api.botsubscription.com/v1/endpoint \
  --header 'Authorization: Bearer sk_live_•••'

List Merchant Accounts

Discover the payment providers available to your project, their installation fields and installed accounts. Use this result to populate provider choices; availability is project-specific.

Each key in data is an available provider ID. Use the returned catalog to build provider choices and credential forms. See Install Provider for how to send those fields when connecting an account.

Read required_params together with optional_params, when present. Despite its name, required_params includes declared optional credential fields; optional_params identifies which can be omitted. credential_help, when supplied, provides translated credential instructions. The response also advertises provider capabilities and installed_merchant_accounts.

supports_saved_payment_methods is a required boolean. Optional capability fields include supports_standalone_setup, supports_offsession_charge and configuration_editable. These describe provider features; they do not authorize project API keys to charge a customer's saved payment method. platform_restriction, when supplied, is a platform identifier string or null.

When an installed account includes webhook_verification, use can_mark_verified to decide whether this caller can mark it verified; pending alone does not grant that ability. Status is verified, pending or not_required; mode is auto, manual, per_request or none. The verification method is webhook_arrival, signature_check, manual_only or null. Verification metadata may be omitted, and stripe_managed_payments_enabled applies only to applicable Stripe accounts.

GET/v2/projects/{project_id}/merchant-accounts

Authorization

Bearer API KeyRequired

API key scope: merchant-accounts:read (required for restricted keys).

Path Parameters

project_idstringrequired

The unique identifier of the project.

Last updated: