Update Stripe Configuration

curl --request PUT \
  --url https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "test_secret_key": "<string>",
  "test_publishable_key": "<string>",
  "test_webhook_secret": "<string>",
  "live_secret_key": "<string>",
  "live_publishable_key": "<string>",
  "live_webhook_secret": "<string>"
}
'

import requests

url = "https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config"

payload = {
    "test_secret_key": "<string>",
    "test_publishable_key": "<string>",
    "test_webhook_secret": "<string>",
    "live_secret_key": "<string>",
    "live_publishable_key": "<string>",
    "live_webhook_secret": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    test_secret_key: '<string>',
    test_publishable_key: '<string>',
    test_webhook_secret: '<string>',
    live_secret_key: '<string>',
    live_publishable_key: '<string>',
    live_webhook_secret: '<string>'
  })
};

fetch('https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'test_secret_key' => '<string>',
    'test_publishable_key' => '<string>',
    'test_webhook_secret' => '<string>',
    'live_secret_key' => '<string>',
    'live_publishable_key' => '<string>',
    'live_webhook_secret' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config"

	payload := strings.NewReader("{\n  \"test_secret_key\": \"<string>\",\n  \"test_publishable_key\": \"<string>\",\n  \"test_webhook_secret\": \"<string>\",\n  \"live_secret_key\": \"<string>\",\n  \"live_publishable_key\": \"<string>\",\n  \"live_webhook_secret\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"test_secret_key\": \"<string>\",\n  \"test_publishable_key\": \"<string>\",\n  \"test_webhook_secret\": \"<string>\",\n  \"live_secret_key\": \"<string>\",\n  \"live_publishable_key\": \"<string>\",\n  \"live_webhook_secret\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"test_secret_key\": \"<string>\",\n  \"test_publishable_key\": \"<string>\",\n  \"test_webhook_secret\": \"<string>\",\n  \"live_secret_key\": \"<string>\",\n  \"live_publishable_key\": \"<string>\",\n  \"live_webhook_secret\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_active": true,
  "has_test_credentials": true,
  "has_live_credentials": true,
  "created_at": "2023-11-07T05:31:56Z",
  "test_secret_key_masked": "<string>",
  "test_publishable_key_masked": "<string>",
  "test_webhook_secret_masked": "<string>",
  "live_secret_key_masked": "<string>",
  "live_publishable_key_masked": "<string>",
  "live_webhook_secret_masked": "<string>",
  "test_configured_at": "2023-11-07T05:31:56Z",
  "live_configured_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

PUT

api

payments

stripe

projects

{project_id}

config

Update Stripe Configuration

curl --request PUT \
  --url https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "test_secret_key": "<string>",
  "test_publishable_key": "<string>",
  "test_webhook_secret": "<string>",
  "live_secret_key": "<string>",
  "live_publishable_key": "<string>",
  "live_webhook_secret": "<string>"
}
'

import requests

url = "https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config"

payload = {
    "test_secret_key": "<string>",
    "test_publishable_key": "<string>",
    "test_webhook_secret": "<string>",
    "live_secret_key": "<string>",
    "live_publishable_key": "<string>",
    "live_webhook_secret": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    test_secret_key: '<string>',
    test_publishable_key: '<string>',
    test_webhook_secret: '<string>',
    live_secret_key: '<string>',
    live_publishable_key: '<string>',
    live_webhook_secret: '<string>'
  })
};

fetch('https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'test_secret_key' => '<string>',
    'test_publishable_key' => '<string>',
    'test_webhook_secret' => '<string>',
    'live_secret_key' => '<string>',
    'live_publishable_key' => '<string>',
    'live_webhook_secret' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config"

	payload := strings.NewReader("{\n  \"test_secret_key\": \"<string>\",\n  \"test_publishable_key\": \"<string>\",\n  \"test_webhook_secret\": \"<string>\",\n  \"live_secret_key\": \"<string>\",\n  \"live_publishable_key\": \"<string>\",\n  \"live_webhook_secret\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"test_secret_key\": \"<string>\",\n  \"test_publishable_key\": \"<string>\",\n  \"test_webhook_secret\": \"<string>\",\n  \"live_secret_key\": \"<string>\",\n  \"live_publishable_key\": \"<string>\",\n  \"live_webhook_secret\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"test_secret_key\": \"<string>\",\n  \"test_publishable_key\": \"<string>\",\n  \"test_webhook_secret\": \"<string>\",\n  \"live_secret_key\": \"<string>\",\n  \"live_publishable_key\": \"<string>\",\n  \"live_webhook_secret\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_active": true,
  "has_test_credentials": true,
  "has_live_credentials": true,
  "created_at": "2023-11-07T05:31:56Z",
  "test_secret_key_masked": "<string>",
  "test_publishable_key_masked": "<string>",
  "test_webhook_secret_masked": "<string>",
  "live_secret_key_masked": "<string>",
  "live_publishable_key_masked": "<string>",
  "live_webhook_secret_masked": "<string>",
  "test_configured_at": "2023-11-07T05:31:56Z",
  "live_configured_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Create or update the Stripe payment configuration for a project. Supports both test and live credentials. This endpoint creates a new configuration if none exists, or updates the existing one.

Authentication

This endpoint requires developer authentication via OAuth2 Bearer Token. You must own the project.

Path Parameters

string (UUID)

required

The unique identifier of the project

Request Body

All fields are optional. Only provide the credentials you want to configure or update.

string

Stripe test mode secret key (starts with sk_test_)

string

Stripe test mode publishable key (starts with pk_test_)

string

Stripe test mode webhook signing secret (starts with whsec_)

string

Stripe live mode secret key (starts with sk_live_)

string

Stripe live mode publishable key (starts with pk_live_)

string

Stripe live mode webhook signing secret (starts with whsec_)

Example Request

Configure test mode credentials:

curl -X PUT "https://api.devkit4ai.com/api/v1/payments/stripe/projects/550e8400-e29b-41d4-a716-446655440000/config" \
  -H "Authorization: Bearer {developer_jwt}" \
  -H "Content-Type: application/json" \
  -d '{
    "test_secret_key": "sk_test_51ABC...",
    "test_publishable_key": "pk_test_51ABC...",
    "test_webhook_secret": "whsec_ABC..."
  }'

Example Response

{
  "id": "770e8400-e29b-41d4-a716-446655440000",
  "project_id": "550e8400-e29b-41d4-a716-446655440000",
  "is_active": true,
  "has_test_credentials": true,
  "has_live_credentials": false,
  "test_secret_key_masked": "sk_test_...aBcD",
  "test_publishable_key_masked": "pk_test_...eFgH",
  "test_webhook_secret_masked": "whsec_...iJkL",
  "live_secret_key_masked": null,
  "live_publishable_key_masked": null,
  "live_webhook_secret_masked": null,
  "test_configured_at": "2026-01-24T10:00:00Z",
  "live_configured_at": null,
  "created_at": "2026-01-24T10:00:00Z",
  "updated_at": "2026-01-24T10:00:00Z"
}

Configuration Flow

Getting Stripe Credentials

Create Stripe Account

Get API Keys

Navigate to Developers > API keys in the Stripe Dashboard.(((REPLACE_THIS_WITH_IMAGE: stripe-dashboard-api-keys.png: Stripe Dashboard showing API keys section with publishable and secret keys)))

Create Webhook Endpoint

Navigate to Developers > Webhooks and create an endpoint using the URL from Get Webhook URLs.

Get Webhook Secret

After creating the webhook, reveal and copy the signing secret.

Credential Validation

Before saving, validate your credentials using the Validate Credentials endpoint to ensure they work correctly.

Partial Updates

You can update credentials incrementally. For example, to add live credentials to an existing test configuration:

curl -X PUT "https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config" \
  -H "Authorization: Bearer {developer_jwt}" \
  -H "Content-Type: application/json" \
  -d '{
    "live_secret_key": "sk_live_51ABC...",
    "live_publishable_key": "pk_live_51ABC...",
    "live_webhook_secret": "whsec_XYZ..."
  }'

Error Responses

Status	Description
`401`	Unauthorized - Invalid or missing authentication
`403`	Forbidden - You don’t own this project
`404`	Project not found
`422`	Validation error - Invalid key format

Security

Never commit Stripe secret keys to version control
Use environment variables in your application
Rotate keys immediately if they are exposed
Use test mode keys for development and testing

Get Stripe Config

View current configuration

Validate Credentials

Test credentials before saving

Get Webhook URLs

Get webhook endpoint URLs

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

project_id

string<uuid>

required

Body

application/json

Request to create/update Stripe configuration.

test_secret_key

string | null

test_publishable_key

string | null

test_webhook_secret

string | null

live_secret_key

string | null

live_publishable_key

string | null

live_webhook_secret

string | null

Response

Successful Response

Stripe configuration response with masked credentials.

string<uuid>

required

project_id

string<uuid>

required

is_active

boolean

required

has_test_credentials

boolean

required

has_live_credentials

boolean

required

created_at

string<date-time>

required

test_secret_key_masked

string | null

test_publishable_key_masked

string | null

test_webhook_secret_masked

string | null

live_secret_key_masked

string | null

live_publishable_key_masked

string | null

live_webhook_secret_masked

string | null

test_configured_at

string<date-time> | null

live_configured_at

string<date-time> | null

updated_at

string<date-time> | null

API documentation

Health Check

Authentication

Project Management

AI Generation

Payments

Stripe Configuration

Stripe Checkout

Stripe Webhooks

Stripe Subscriptions

Health Check API

Authentication

Project Management

AI Generation API

Stripe Configuration

Stripe Checkout

Stripe Webhooks

Stripe Subscriptions

Payments

Default

Update Stripe Configuration

Authentication

Path Parameters

Request Body

Example Request

Example Response

Configuration Flow

Getting Stripe Credentials

Credential Validation

Partial Updates

Error Responses

Security

Get Stripe Config

Validate Credentials

Get Webhook URLs

Authorizations

Path Parameters

Body

Response

​Authentication

​Path Parameters

​Request Body

​Example Request

​Example Response

​Configuration Flow

​Getting Stripe Credentials

​Credential Validation

​Partial Updates

​Error Responses

​Security

​Related Pages

Get Stripe Config

Validate Credentials

Get Webhook URLs

Authorizations

Path Parameters

Body

Response

Authentication

Path Parameters

Request Body

Example Request

Example Response

Configuration Flow

Getting Stripe Credentials

Credential Validation

Partial Updates

Error Responses

Security

Related Pages