Skip to main content

kobana banking webhooks

Commands of kobana banking webhooks. Every global option (Global options) applies here.

CommandHTTPDescription
webhooks listGET /v1/webhooksList Webhooks
webhooks createPOST /v1/webhooksCreate Webhook
webhooks getGET /v1/webhooks/{id}Webhook Information
webhooks updatePUT /v1/webhooks/{id}Update Webhook
webhooks deleteDELETE /v1/webhooks/{id}Delete Webhook

webhooks list​

List Webhooks

kobana banking webhooks list [OPTIONS]

GET /v1/webhooks

List webhooks.

Query parameters

NameTypeRequiredDescription
pageintegernoPage Number
per_pageintegernoNumber of records per page

Responses

HTTPDescription
200Success in listing webhooks

webhooks create​

Create Webhook

kobana banking webhooks create [OPTIONS]

POST /v1/webhooks

Creates a webhook to receive system event notifications via HTTP.

Request body

NameTypeRequiredDescription
urlstringyesAddress where requests will be made
eventsarray<string>yesEvents that should generate notifications for the webhook. Choose one or more events.
idintegernoWebhook ID
namestringnoWebhook identification name
content_typestringnoContent-type of the request that will be made. Valid values application/json (default) or application/x-www-form-urlencoded.
activebooleannoDefines whether the webhook will be active, receiving notifications. The default value is true.
ssl_verification_enabledbooleannoDefines whether SSL verification is enabled on the webhook.
subaccountsbooleannoDefines whether the webhook will be active for subaccount events.
bank_billet_account_idintegernoID of the Billing Account. If provided, the webhook will only receive notifications for events related to the specified billing account.
auth_kindstringnoType of authentication configured. Returned in responses. To configure, send the auth object in the body. Values: none, basic_auth, bearer, api_key.
authobjectnoAuthentication configuration of the receiving endpoint. For creation/update only — not returned in responses.
created_atstring (date-time)noDate and time of record creation
updated_atstring (date-time)noDate and time of last record update

More fields and nested objects: kobana schema banking.webhooks.create.

Responses

HTTPDescription
201Webhook created with Basic Auth
422Invalid webhook

webhooks get​

Webhook Information

kobana banking webhooks get [ID] [OPTIONS]

GET /v1/webhooks/{id}

Query specific information from a Webhook.

Path arguments: id

Responses

HTTPDescription
200Webhook found
404Webhook not found

webhooks update​

Update Webhook

kobana banking webhooks update [ID] [OPTIONS]

PUT /v1/webhooks/{id}

Updates specific information of a webhook.

Path arguments: id

Request body

NameTypeRequiredDescription
urlstringyesAddress where requests will be made
eventsarray<string>yesEvents that should generate notifications for the webhook. Choose one or more events.
idintegernoWebhook ID
namestringnoWebhook identification name
content_typestringnoContent-type of the request that will be made. Valid values application/json (default) or application/x-www-form-urlencoded.
activebooleannoDefines whether the webhook will be active, receiving notifications. The default value is true.
ssl_verification_enabledbooleannoDefines whether SSL verification is enabled on the webhook.
subaccountsbooleannoDefines whether the webhook will be active for subaccount events.
bank_billet_account_idintegernoID of the Billing Account. If provided, the webhook will only receive notifications for events related to the specified billing account.
auth_kindstringnoType of authentication configured. Returned in responses. To configure, send the auth object in the body. Values: none, basic_auth, bearer, api_key.
authobjectnoAuthentication configuration of the receiving endpoint. For creation/update only — not returned in responses.
created_atstring (date-time)noDate and time of record creation
updated_atstring (date-time)noDate and time of last record update

More fields and nested objects: kobana schema banking.webhooks.update.

Responses

HTTPDescription
204Partial update of auth preserves existing secret fields
404Webhook not found

webhooks delete​

Delete Webhook

kobana banking webhooks delete [ID] [OPTIONS]

DELETE /v1/webhooks/{id}

Deletes a specific webhook

Path arguments: id

Responses

HTTPDescription
204Webhook deleted
404Webhook not found