> ## Documentation Index
> Fetch the complete documentation index at: https://docs-kausanna.sonqo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Probar webhooks

Este endpoint enviará un evento de prueba a la URL de webhook configurada para el partner, para que puedan probar que la integración está funcionando correctamente.
La notificación es de tipo `POST`.

## Ejemplo de notificación

```json
{
  "test": true,
  "event": "chargeback.created",
  "data": {
    "message": "Test webhook"
  }
}
```

Puedes ver en las cabercas de la petición el `x-hmac-hash` que es el hash de la petición que se envía para que el partner pueda validar que la petición es auténtica.
Por ejemplo:

```http
POST /webhook/sample HTTP/1.1
Host: api.example.com
Content-Type: application/json
x-hmac-hash: 5d0a63628669ebc76cf3d5d33a0da3a3c96bd519fa129534b50e0f3ae97027d3
```

<Info>
  Kausanna usa el algoritmo SHA256 para generar el hash de la petición.
</Info>


## OpenAPI

````yaml POST /partner/{partnerId}/subscriptions/test
openapi: 3.0.0
info:
  version: 4.7.6
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  title: Kausanna API
  description: >
    Bienvenido a Kausanna, el servicio ofrecido por SONQO, dedicado a procesar
    los contracargos de tus clientes en tiempo real,

    brindando una solución integral que te permite concentrarte en tu negocio
    sin preocuparte por la complejidad de las redes de

    Visa y Mastercard.


    En el mundo de los negocios, los contracargos pueden ser una preocupación
    constante para los comercios y las empresas.

    La necesidad de enfrentar disputas de pagos, desconocimientos o
    reclamaciones de clientes puede ser un desafío significativo,

    especialmente cuando se trabaja con múltiples proveedores de tarjetas y
    redes de pago.

    Es en este punto donde Kausanna se convierte en tu mejor aliado.


    Nuestra plataforma Kausanna se ha desarrollado pensando en la simplicidad y
    eficiencia,

    ofreciendo un sistema escalable y seguro que te permitirá manejar los
    contracargos de manera rápida y efectiva.

    Olvídate de la complejidad técnica y los detalles burocráticos, Kausanna se
    encarga de abstraer toda la

    complejidad de las redes de Visa y Mastercard para que puedas enfocarte en
    lo que realmente importa: hacer crecer tu negocio.


    Verificá el estado de nuestras APIs en [Kausanna
    Status](https://kausanna.instatus.com/)
  contact:
    email: ongoing-processes-sonqo@naranjax.com
  x-logo:
    url: https://www.naranjax.com/assets/images/navbar-isologo-naranjax.png
    altText: NaranjaX Logo
    backgroundColor: '#ffffff'
    href: https://www.naranjax.com/
servers:
  - url: https://e3-kausanna.sonqo.io
    description: Sandbox
  - url: https://kausanna.sonqo.io
    description: Entorno de producción
security:
  - bearerAuth: []
paths:
  /partner/{partnerId}/subscriptions/test:
    post:
      tags:
        - partner > {partnerId}
      summary: Probar las subscripciones webhook
      description: Test the webhook integration by sending a JSON test message.
      operationId: postTestSubscription
      parameters:
        - name: partnerId
          in: path
          schema:
            type: integer
          required: true
          description: The ID of the partner registered to receive webhooks
          example: '006837'
      responses:
        '200':
          description: Successful test
          content:
            application/json:
              schema:
                type: object
              example:
                success: true
        '409':
          description: Conflict
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
              example:
                success: false
                code: PARTNER.TEST_PARTNER_SUBSCRIPTION_ERROR
                message: Error sending test webhook to some subscriptions
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API Token generated for your account. The token must be prefixed with
        `Bearer `.

````