> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.recurrente.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recurrente.com/_mcp/server. # Emitir un fixture de webhook POST https://app.recurrente.com/api/test_helpers/webhook_events Content-Type: application/json Persiste una `Activity` de prueba y entrega el evento por la misma aplicación Svix del Sandbox autenticado. Acepta cualquier tipo del catálogo público y es útil para validar firmas, routing, reintentos e idempotencia del consumer. La respuesta contiene el payload base normalizado. Recurrente genera y reemplaza los campos reservados `data.id` y `data.created_at`, aunque el request envíe otros valores. La entrega Svix agrega `data.event_type` y `data.sandbox_id` como contexto estándar. El fixture no crea el grafo de dominio del evento. Por ejemplo, `dispute.create` entrega el contrato del webhook, pero no crea una disputa ni movimientos financieros. Para validar comportamiento end-to-end, ejecuta el flujo real y observa sus webhooks naturales. Este endpoint solo existe para llaves de Sandboxes nombrados. Una llave LIVE recibe `404` para evitar que una suite de pruebas emita fixtures en producción. Reference: https://docs.recurrente.com/referencia-api/api-reference/test-helpers/create-sandbox-webhook-event ## Authentication - `X-SECRET-KEY` header (required) — Tu clave secreta de API. Una llave de cuenta (`sk_live_...`, `sk_test_...`) opera sobre su propia cuenta y, con `X-ACCOUNT-ID`, sobre sus cuentas conectadas. La llave también fija el ambiente: una `sk_test_` solo lista y resuelve objetos de prueba (`live_mode: false`) y una `sk_live_` solo objetos reales. Un ID del otro ambiente responde `404` (`401` en `/customers`). Una llave de organización (`sk_org_live_...`, `sk_org_test_...`) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con `X-ACCOUNT-ID`; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde `403` con `code: organization_key_unsupported`. ## Request ### Body (application/json) This endpoint expects a SandboxWebhookEventRequest. - `event_type` (enum, required) — Tipo de evento publicado que debe emitir el fixture. - Allowed values: `account_connection.create`, `automated_bank_transfer_intent.succeeded`, `balance_intent.paid`, `balance_intent.succeeded`, `bank_transfer_intent.create`, `bank_transfer_intent.failed`, `bank_transfer_intent.pending`, `bank_transfer_intent.succeeded`, `bank_transfer_intent.update`, `cash_intent.succeeded`, `connected_account_fee_invoice.failed`, `connected_account_fee_invoice.issued`, `crypto_intent.create`, `crypto_intent.pending`, `crypto_intent.succeeded`, `crypto_intent.update`, `dispute.create`, `dispute.update`, `intent.canceled`, `intent.failed`, `intent.paid`, `intent.pending`, `intent.succeeded`, `partner_commission_invoice.failed`, `partner_commission_invoice.issued`, `payment_intent.failed`, `payment_intent.requires_capture`, `payment_intent.requires_verification`, `payment_intent.succeeded`, `product.inventory_adjusted`, `refund.create`, `setup_intent.cancelled`, `setup_intent.succeeded`, `subscription.cancel`, `subscription.create`, `subscription.invoice_item_added`, `subscription.item_added`, `subscription.item_removed`, `subscription.past_due`, `subscription.pause`, `subscription.reactivate`, `subscription.unpause`, `subscription.update`, `swap.create`, `swap.update`, `tax_invoice_settings.enabled`, `transfer.cancelled`, `transfer.in_review`, `transfer.pending`, `transfer.received`, `transfer.sent`, `verification.completed`, `verification.rejected`, `withdrawal.create`, `withdrawal.update` - `data` (map from string to any, optional, default: {}) — Campos del payload de prueba. Recurrente reemplaza `id` y `created_at` con la identidad y fecha persistidas del fixture. ## Response ### 201 Fixture persistido y encolado para entrega - `id` (string, required) - `event_type` (enum, required) — Tipo de evento publicado que debe emitir el fixture. - Allowed values: `account_connection.create`, `automated_bank_transfer_intent.succeeded`, `balance_intent.paid`, `balance_intent.succeeded`, `bank_transfer_intent.create`, `bank_transfer_intent.failed`, `bank_transfer_intent.pending`, `bank_transfer_intent.succeeded`, `bank_transfer_intent.update`, `cash_intent.succeeded`, `connected_account_fee_invoice.failed`, `connected_account_fee_invoice.issued`, `crypto_intent.create`, `crypto_intent.pending`, `crypto_intent.succeeded`, `crypto_intent.update`, `dispute.create`, `dispute.update`, `intent.canceled`, `intent.failed`, `intent.paid`, `intent.pending`, `intent.succeeded`, `partner_commission_invoice.failed`, `partner_commission_invoice.issued`, `payment_intent.failed`, `payment_intent.requires_capture`, `payment_intent.requires_verification`, `payment_intent.succeeded`, `product.inventory_adjusted`, `refund.create`, `setup_intent.cancelled`, `setup_intent.succeeded`, `subscription.cancel`, `subscription.create`, `subscription.invoice_item_added`, `subscription.item_added`, `subscription.item_removed`, `subscription.past_due`, `subscription.pause`, `subscription.reactivate`, `subscription.unpause`, `subscription.update`, `swap.create`, `swap.update`, `tax_invoice_settings.enabled`, `transfer.cancelled`, `transfer.in_review`, `transfer.pending`, `transfer.received`, `transfer.sent`, `verification.completed`, `verification.rejected`, `withdrawal.create`, `withdrawal.update` - `data` (map from string to any, required) — Payload base normalizado, incluidos `id` y `created_at`. La entrega Svix agrega `event_type` y `sandbox_id`. - `created_at` (datetime, required) ## Errors ### 400 Bad Request Error Falta `event_type` - `message` (string, optional) — Mensaje de error - `code` (string, optional) — Código estable legible por máquinas, cuando aplica - `refund_id` (string, optional) — ID del reembolso relacionado cuando aplica - `endpoint` (string, optional) — Acción de API rechazada, cuando aplica - `errors` (ErrorErrors, optional) — Detalles de errores por campo ### 404 Not Found Error La llave autenticada no pertenece a un Sandbox - `message` (string, optional) — Mensaje de error - `code` (string, optional) — Código estable legible por máquinas, cuando aplica - `refund_id` (string, optional) — ID del reembolso relacionado cuando aplica - `endpoint` (string, optional) — Acción de API rechazada, cuando aplica - `errors` (ErrorErrors, optional) — Detalles de errores por campo ### 422 Unprocessable Entity Error `event_type` no pertenece al catálogo publicado - `message` (string, optional) — Mensaje de error - `code` (string, optional) — Código estable legible por máquinas, cuando aplica - `refund_id` (string, optional) — ID del reembolso relacionado cuando aplica - `endpoint` (string, optional) — Acción de API rechazada, cuando aplica - `errors` (ErrorErrors, optional) — Detalles de errores por campo ## Types ### ErrorErrors Detalles de errores por campo ## Examples **Request** ```json { "event_type": "dispute.create", "data": { "status": "needs_response", "integration_case": "chargeback-v1" } } ``` **Response** ```json { "id": "swe_abc123", "event_type": "dispute.create", "data": { "status": "needs_response", "integration_case": "chargeback-v1", "id": "swe_abc123", "created_at": "2026-07-21T18:30:00Z" }, "created_at": "2026-07-21T18:30:00Z" } ``` **SDK Code** ```python Test Helpers_createSandboxWebhookEvent_example import requests url = "https://app.recurrente.com/api/test_helpers/webhook_events" payload = { "event_type": "dispute.create", "data": { "status": "needs_response", "integration_case": "chargeback-v1" } } headers = { "X-SECRET-KEY": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Test Helpers_createSandboxWebhookEvent_example const url = 'https://app.recurrente.com/api/test_helpers/webhook_events'; const options = { method: 'POST', headers: {'X-SECRET-KEY': '', 'Content-Type': 'application/json'}, body: '{"event_type":"dispute.create","data":{"status":"needs_response","integration_case":"chargeback-v1"}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Test Helpers_createSandboxWebhookEvent_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://app.recurrente.com/api/test_helpers/webhook_events" payload := strings.NewReader("{\n \"event_type\": \"dispute.create\",\n \"data\": {\n \"status\": \"needs_response\",\n \"integration_case\": \"chargeback-v1\"\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-SECRET-KEY", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Test Helpers_createSandboxWebhookEvent_example require 'uri' require 'net/http' url = URI("https://app.recurrente.com/api/test_helpers/webhook_events") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-SECRET-KEY"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"event_type\": \"dispute.create\",\n \"data\": {\n \"status\": \"needs_response\",\n \"integration_case\": \"chargeback-v1\"\n }\n}" response = http.request(request) puts response.read_body ``` ```java Test Helpers_createSandboxWebhookEvent_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://app.recurrente.com/api/test_helpers/webhook_events") .header("X-SECRET-KEY", "") .header("Content-Type", "application/json") .body("{\n \"event_type\": \"dispute.create\",\n \"data\": {\n \"status\": \"needs_response\",\n \"integration_case\": \"chargeback-v1\"\n }\n}") .asString(); ``` ```php Test Helpers_createSandboxWebhookEvent_example request('POST', 'https://app.recurrente.com/api/test_helpers/webhook_events', [ 'body' => '{ "event_type": "dispute.create", "data": { "status": "needs_response", "integration_case": "chargeback-v1" } }', 'headers' => [ 'Content-Type' => 'application/json', 'X-SECRET-KEY' => '', ], ]); echo $response->getBody(); ``` ```csharp Test Helpers_createSandboxWebhookEvent_example using RestSharp; var client = new RestClient("https://app.recurrente.com/api/test_helpers/webhook_events"); var request = new RestRequest(Method.POST); request.AddHeader("X-SECRET-KEY", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"event_type\": \"dispute.create\",\n \"data\": {\n \"status\": \"needs_response\",\n \"integration_case\": \"chargeback-v1\"\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Test Helpers_createSandboxWebhookEvent_example import Foundation let headers = [ "X-SECRET-KEY": "", "Content-Type": "application/json" ] let parameters = [ "event_type": "dispute.create", "data": [ "status": "needs_response", "integration_case": "chargeback-v1" ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://app.recurrente.com/api/test_helpers/webhook_events")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```