Webhook endpoints

/v1/webhook-endpoints — configura a dónde Rekurra te envía eventos (subscription.created, charge.approved, etc.). Ver la guía completa de verificación de firma en Webhooks.

El objeto WebhookEndpoint

{
  "id": "we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  "url": "https://tuapp.com/webhooks/rekurra",
  "secret": "whsec_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "events": ["subscription.created", "charge.approved"],
  "active": true
}

Campo	Tipo	Descripción
`id`	string	Identificador único del endpoint
`url`	string	URL a la que Rekurra entrega los eventos
`secret`	string	Secreto de firma (solo en la respuesta de creación)
`events`	string[]	Tipos de evento suscritos
`active`	boolean	Si el endpoint está activo

Crear un webhook endpoint

POST /v1/webhook-endpoints

Request body

{
  "url": "https://tuapp.com/webhooks/rekurra",
  "events": ["subscription.created", "charge.approved", "charge.declined", "subscription.canceled"]
}

curl -X POST https://api.rekurra.dev/v1/webhook-endpoints \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tuapp.com/webhooks/rekurra",
    "events": ["subscription.created", "charge.approved"]
  }'

const res = await fetch("https://api.rekurra.dev/v1/webhook-endpoints", {
  method: "POST",
  headers: {
    Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://tuapp.com/webhooks/rekurra",
    events: ["subscription.created", "charge.approved"],
  }),
});
const endpoint = await res.json();

import requests
 
res = requests.post(
    "https://api.rekurra.dev/v1/webhook-endpoints",
    headers={
        "Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX",
        "Content-Type": "application/json",
    },
    json={
        "url": "https://tuapp.com/webhooks/rekurra",
        "events": ["subscription.created", "charge.approved"],
    },
)
endpoint = res.json()

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
String body = """
    {
      "url": "https://tuapp.com/webhooks/rekurra",
      "events": [
        "subscription.created",
        "charge.approved"
      ]
    }
    """;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/webhook-endpoints"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
using System.Text;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var json = """
    {
      "url": "https://tuapp.com/webhooks/rekurra",
      "events": [
        "subscription.created",
        "charge.approved"
      ]
    }
    """;
var content = new StringContent(json, Encoding.UTF8, "application/json");
 
var response = await http.PostAsync("https://api.rekurra.dev/v1/webhook-endpoints", content);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response — `201 Created`

Devuelve el objeto con secret incluido — guárdalo, no se vuelve a mostrar.

Errores posibles

Status	`error.type`	Causa
`400`	`invalid_request`	`url` inválida o `events` con un tipo desconocido

Listar webhook endpoints

GET /v1/webhook-endpoints

curl https://api.rekurra.dev/v1/webhook-endpoints \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

const res = await fetch("https://api.rekurra.dev/v1/webhook-endpoints", {
  headers: { Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" },
});
const { data } = await res.json();

import requests
 
res = requests.get(
    "https://api.rekurra.dev/v1/webhook-endpoints",
    headers={"Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"},
)
body = res.json()

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/webhook-endpoints"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .GET()
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var response = await http.GetAsync("https://api.rekurra.dev/v1/webhook-endpoints");
Console.WriteLine(await response.Content.ReadAsStringAsync());

Nota: los objetos devueltos en el listado no incluyen secret.

Actualizar un webhook endpoint

PATCH /v1/webhook-endpoints/{id}

curl -X PATCH https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2 \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "active": false }'

const res = await fetch(
  "https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  {
    method: "PATCH",
    headers: {
      Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ active: false }),
  }
);
const endpoint = await res.json();

import requests
 
res = requests.patch(
    "https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
    headers={
        "Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX",
        "Content-Type": "application/json",
    },
    json={"active": False},
)
endpoint = res.json()

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
String body = """
    {
      "active": false
    }
    """;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString(body))
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
using System.Text;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var json = """
    {
      "active": false
    }
    """;
var content = new StringContent(json, Encoding.UTF8, "application/json");
 
var response = await http.PatchAsync("https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2", content);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Errores posibles

Status	`error.type`	Causa
`404`	`invalid_request`	El webhook endpoint no existe

Eliminar un webhook endpoint

DELETE /v1/webhook-endpoints/{id}

curl -X DELETE https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2 \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

await fetch(
  "https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  {
    method: "DELETE",
    headers: { Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" },
  }
);

import requests
 
requests.delete(
    "https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
    headers={"Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"},
)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .DELETE()
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var response = await http.DeleteAsync("https://api.rekurra.dev/v1/webhook-endpoints/we_01HZXK7QJ5M8Z9X2R3TVQ7A1B2");
Console.WriteLine(await response.Content.ReadAsStringAsync());

Balance Events

Webhook endpoints

El objeto WebhookEndpoint

Crear un webhook endpoint

Request body

Response — 201 Created

Errores posibles

Listar webhook endpoints

Actualizar un webhook endpoint

Errores posibles

Eliminar un webhook endpoint

Response — `201 Created`