Skip to main content
GET
/
partner
/
webhooks
/
config
Get webhook config
curl --request GET \
  --url https://api.contro.me/v1/partner/webhooks/config \
  --header 'x-contro-api-key: <api-key>'
{
  "webhookUrl": "https://your-app.com/webhooks/contro",
  "webhookSecret": "whsec_your_secret_min_16_chars",
  "subscribedEvents": [
    "card.transaction",
    "cardholder.kyc.updated"
  ]
}

Authorizations

​
x-contro-api-key
string
header
required

Partner API key (sk_live_* for production, sk_test_* for sandbox)

Response

Webhook configuration

​
webhookUrl
string | null
required

HTTPS URL that receives webhook events, or null if not configured

Example:

"https://your-app.com/webhooks/contro"

​
webhookSecret
string | null
required

HMAC-SHA256 signing secret, or null if not configured

Example:

"whsec_your_secret_min_16_chars"

​
subscribedEvents
string[]
required

List of subscribed event types

Example:
[
  "card.transaction",
  "cardholder.kyc.updated"
]