Get Provider

Retrieves detailed information about a specific payment service provider (bank). Returns provider metadata and optionally its available payment methods.

Payment Methods

Set options.show_payment_methods: true to include payment method details. Each payment method includes:

Supported account types (retail/corporate)
Payment scheme (instant, domestic, SEPA)
Environment availability
Feature capabilities

Validation Schema

Set options.show_validation_schema: true to include the JSON schema for validating payment intents for each payment method.

Method access restrictions

An API client may be restricted to a subset of methods. The response only includes methods the client is allowed to use. If the client has no accessible method on the requested provider, the endpoint returns 400.

Set options.show_subscribed_methods: false to browse the full catalog as an informative tool, ignoring the client’s method-access restrictions.

Body Parameters

client_idstring Required

API client identifier

Max length

128

client_secretstring

API client secret for authentication. Required for internal (non-OAuth2) authentication mode (e.g., test-only). Not required when using OAuth2 (Bearer token) authentication.

Max length

128

provider_idstring Required

Public identifier for the payment provider. See Providers enum for available values.

optionsobject

Options for provider listing and details

Show child attributes

Response

200

Object

Provider retrieved successfully

Response Attributes

request_idstring

Unique identifier for the API request

providerobject

A payment service provider (bank or financial institution)

Show child attributes

400

Object

Validation error or invalid request

Response Attributes

error_idstring Required

Unique identifier for this error instance

request_idstring Required

Request identifier for tracking and correlation

codestring Required

Machine-readable error code for 400 errors:

bad_request: Generic validation or request error
validation_error: Request payload validation failed
invalid_input: Invalid input data provided
internal_error: AIS-side unexpected internal error
external_api_unavailable: External provider HTTP failure (timeout, connection refused, DNS, etc.). Surfaced as HTTP 400 instead of a gateway 504.
external_api_error: External provider returned a structured error during the AIS ...

Enum values:

bad_requestvalidation_errorinvalid_inputinternal_errorexternal_api_unavailableexternal_api_errorcooldown_failedconsent_not_activejob_in_progressmethod_selection_error

... 2 other enums

messagestring Required

Human-readable error message

401

Object

Authentication failed

Response Attributes

error_idstring Required

Unique identifier for this error instance

request_idstring Required

Request identifier for tracking and correlation

codestring Required

Machine-readable error code for 401 errors:

unauthorized: Authentication failed or insufficient permissions

Enum values:

unauthorized

messagestring Required

Human-readable error message

404

Object

Resource not found

Response Attributes

error_idstring Required

Unique identifier for this error instance

request_idstring Required

Request identifier for tracking and correlation

codestring Required

Machine-readable error code for 404 errors:

not_found: Generic resource not found
consent_not_found: Specified consent does not exist
job_not_found: Specified job does not exist or outside accessible date range

Enum values:

not_foundconsent_not_foundjob_not_found

messagestring Required

Human-readable error message

Sections

Get Provider

Payment Methods

Validation Schema

Method access restrictions

Body ParametersExpand all

ResponseExpand all

Response Attributes

Response Attributes

... 2 other enums

Response Attributes

Response Attributes

Response

Ask an AI

Code with AI

Body Parameters

Response