{ "webhook_url": "https://your-app.com/hooks/rails" }
{
"status": "success",
"message": "Webhook URL updated",
"data": {
"sender_profile_id": "e7c194a0-3c4c-48c4-8235-4ba7dc94fa40",
"webhook_url": "https://your-app.com/hooks/rails",
"domain_whitelist": ["https://your-app.com"]
}
}
API Reference
Update Webhook
Set your own webhook URL for order status notifications — self-service, no admin needed.
PATCH
/
v1
/
sender
/
webhook
{ "webhook_url": "https://your-app.com/hooks/rails" }
{
"status": "success",
"message": "Webhook URL updated",
"data": {
"sender_profile_id": "e7c194a0-3c4c-48c4-8235-4ba7dc94fa40",
"webhook_url": "https://your-app.com/hooks/rails",
"domain_whitelist": ["https://your-app.com"]
}
}
Set or change the webhook URL Rails calls when your orders change state
(
settled, refunded, expired). Authenticated with your API key — you
manage this yourself.
To view your current webhook, call Get Account.
Header Parameters
string
required
Unique API key issued manually through Telegram.
Request Body
string
required
A valid HTTPS URL Rails will POST status events to.
array
Optional domain whitelist. Only updated when provided — omit it and your
existing whitelist is preserved.
Response
string
Response state (
success).{ "webhook_url": "https://your-app.com/hooks/rails" }
{
"status": "success",
"message": "Webhook URL updated",
"data": {
"sender_profile_id": "e7c194a0-3c4c-48c4-8235-4ba7dc94fa40",
"webhook_url": "https://your-app.com/hooks/rails",
"domain_whitelist": ["https://your-app.com"]
}
}