---
title: "Configure a payment provider"
method: POST
path: "/api/payment-providers"
tags: ["Payment Providers"]
---

# Configure a payment provider

`POST /api/payment-providers`

Set up a payment provider (stripe, paystack, flutterwave, or mpesa) with encrypted credentials. The provider with the lowest priority number is used by default for checkout.

## Request body

- CreateProviderDto
  - `providerName` string, required — Provider name
  - `credentials` object, required — Provider credentials (will be encrypted)
  - `isActive` boolean
  - `priority` number — Priority (lower = higher)

## Response `201`

Provider configured successfully

- PaymentProviderResponse
  - `id` string, required
  - `providerName` string, required
  - `isActive` boolean, required
  - `priority` number, required
  - `createdAt` string, required
  - `updatedAt` string, required

## Other responses

- `409` — Provider already configured

---

[API](https://skmtc.net/novabilling/apis/novabilling-api.md) · [All operations](https://skmtc.net/novabilling/apis/novabilling-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novabilling/novabilling-api/versions/0e449a4e0dc8/schema)