Skip to main content
GET
/
api
/
v1
/
payments
/
stripe
/
projects
/
{project_id}
/
config
Get Stripe Configuration
curl --request GET \
  --url https://api.devkit4ai.com/api/v1/payments/stripe/projects/{project_id}/config \
  --header 'Authorization: Bearer <token>'
{
  "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"
}
Retrieve the current Stripe payment configuration for a specific project. Returns masked credential information for security - full credentials are never exposed through the API.

​
Authentication

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

​
Path Parameters

​
project_id
string (UUID)
required
The unique identifier of the project

​
Response

Returns the Stripe configuration with masked credentials, or null if no configuration exists.
​
id
string (UUID)
Configuration ID
​
project_id
string (UUID)
Project ID
​
is_active
boolean
Whether the configuration is active
​
has_test_credentials
boolean
Whether test mode credentials are configured
​
has_live_credentials
boolean
Whether live mode credentials are configured
​
test_secret_key_masked
string
Masked test secret key (e.g., sk_test_...xxxx)
​
test_publishable_key_masked
string
Masked test publishable key
​
test_webhook_secret_masked
string
Masked test webhook secret
​
live_secret_key_masked
string
Masked live secret key
​
live_publishable_key_masked
string
Masked live publishable key
​
live_webhook_secret_masked
string
Masked live webhook secret
​
test_configured_at
string (datetime)
When test credentials were configured
​
live_configured_at
string (datetime)
When live credentials were configured
​
created_at
string (datetime)
When the configuration was created
​
updated_at
string (datetime)
When the configuration was last updated

​
Example Request

curl "https://api.devkit4ai.com/api/v1/payments/stripe/projects/550e8400-e29b-41d4-a716-446655440000/config" \
  -H "Authorization: Bearer {developer_jwt}"

​
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-10T14:30:00Z",
  "live_configured_at": null,
  "created_at": "2026-01-10T14:30:00Z",
  "updated_at": "2026-01-10T14:30:00Z"
}

​
No Configuration Response

If no Stripe configuration exists for the project, the response is null: 
null

​
Credential Masking

Credentials are masked for security. Only the last 4 characters are visible:
Key TypeFormat
Secret Keysk_test_...xxxx or sk_live_...xxxx
Publishable Keypk_test_...xxxx or pk_live_...xxxx
Webhook Secretwhsec_...xxxx
Full credentials are never returned by the API. If you need to update credentials, use the Update Stripe Config endpoint.

​
Error Responses

StatusDescription
401Unauthorized - Invalid or missing authentication
403Forbidden - You don’t own this project
404Project not found

Update Stripe Config

Configure Stripe credentials

Delete Stripe Config

Remove Stripe configuration

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

Response

StripeConfigResponse · object | null

Successful Response

Stripe configuration response with masked credentials.

​
id
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