Skip to main content
PUT
/
webhook
/
{webhookConfigId}
cURL
curl --request PUT \
  --url https://api.xpaycheckout.com/webhook/{webhookConfigId} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventSigner": "secret_key",
  "endpoint": "https://your-webhook-endpoint.com/webhook",
  "subscribedEventTypes": [
    "intent.created",
    "intent.success",
    "intent.failed",
    "intent.refunded",
    "intent.checkout_opened",
    "subscription.trialing",
    "subscription.cycle_charged"
  ]
}
'
{
  "errorCode": "bad_request",
  "errorDescription": "Failed to read request"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
Idempotency-Key
string

A unique key for making the request idempotent. Must match pattern: ^[a-zA-Z0-9\-_:\.]+$. See Idempotent Requests for more details.

Maximum string length: 255
Pattern: ^[a-zA-Z0-9\-_:\.]+$

Path Parameters

​
webhookConfigId
string
required

Identifier of the webhook configuration to update

Body

application/json
​
eventSigner
string
required

Secret used to sign outbound webhook events. Provide a value that you will use to verify the signature.

Example:

"secret_key"

​
endpoint
string
required

Public HTTPS URL where xPay should POST webhook events.

Example:

"https://your-webhook-endpoint.com/webhook"

​
subscribedEventTypes
string[]
required

List of event types to subscribe to. Refer to webhook events for the full list of available events.

Example:
[
  "intent.created",
  "intent.success",
  "intent.failed",
  "intent.refunded",
  "intent.checkout_opened",
  "subscription.trialing",
  "subscription.cycle_charged"
]

Response

Webhook configuration updated successfully. No content is returned.