---
title: "Create provider credential"
method: POST
path: "/banking-auth/v1/credentials"
tags: ["Provider credentials"]
---

# Create provider credential

`POST /banking-auth/v1/credentials`

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](https://developers.pismo.io/pismo-docs/docs/banking-as-a-service)

## Headers

- `account_token` string, required
- `tracking_id` string

## Request body

- PostCreateRequest
  - `key` string, 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.
  - `provider_data` ProviderData
    - `client_id` string — The client ID you used to obtain a provider access token.

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error
- `502` — Bad Gateway
- `504` — Gateway Timeout

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)
