v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Provider credentials

Create provider credential

Create or update your credentials with a third-party banking partner (provider). Banking as a Service clients need to partner with a provider such as Celcoin, BTG, or JD Consultores.

When you call this endpoint with your authentication key and secret, Pismo saves and encrypts the information you provide, then uses it to obtain an access token from the provider.

For more information, see Banking as a Service overview

post/banking-auth/v1/credentials

Headers

account_tokenstring required

Account token - access token encoded with a Pismo account ID. This is the token you get from Pismo. Tokens can expire quickly, which can result in a 401 Unauthorized message.

tracking_idstring

Request tracking identifier, if you don't provide one, a random UUID is generated for you.

Request body

keystring required

Authentication secret. Your third-party banking partner provides this to you.

provider'BTG' | 'CELCOIN' | 'JDPI' required

Third-party banking service providers.

type'PIX' | 'BAAS' required

Payment integration type.

Example request

{
  "key": "Tc84Hi3CRyAHFBNIvbc8CuSuvHuGibjf",
  "provider": "BTG",
  "type": "PIX",
  "provider_data": {
    "client_id": "Your client ID"
  }
}

Response

Created