Durably accept a signed Accounts v2 thin notification
Customer Payments · receiveMerchantAccountEvent
POST
/customer-payments/stripe/webhook/account-eventsBase URL: https://api.businessmode.io/v1
Authentication
Public
The requirement above comes from this operation's OpenAPI security declaration. See Authentication.
Parameters
| Name | In | Required | Type and constraints |
|---|---|---|---|
Stripe-Signature | header | Yes | stringStripe webhook signature calculated over the exact raw request bytes.Minimum length: 1 |
Request body
No request body is defined.
Responses
For status codes, request IDs, and safe retry decisions, see Errors & recovery. Known-code descriptions below are operation-specific, not a complete global error enum.
200 Successful response.
Content type: application/json
object · StripeWebhookResponse
- No additional properties
| Field | Type | Required | Description / constraints |
|---|---|---|---|
received | boolean | Yes | Constant: true |
400 Invalid request. Known error codes: invalid_merchant_webhook.
Content type: application/json
object · ErrorResponse
- No additional properties
| Field | Type | Required | Description / constraints | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
error | object | Yes | No additional propertiesView nested schemaobject
|
500 An unexpected server error occurred.
Content type: application/json
object · ErrorResponse
- No additional properties
| Field | Type | Required | Description / constraints | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
error | object | Yes | No additional propertiesView nested schemaobject
|
503 A required operation-specific provider or PostgreSQL is unavailable. Known error codes: customer_payments_not_configured, customer_payments_unavailable.
Content type: application/json
object · ErrorResponse
- No additional properties
| Field | Type | Required | Description / constraints | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
error | object | Yes | No additional propertiesView nested schemaobject
|