Registrar un webhook
A dónde te avisamos. Cada entrega va firmada: Tikin-Signature: t=<unix_ts>,v1=<hmac_sha256(secret, t + "." + body)> — rechaza entregas con t a más de 5 minutos (anti-replay). Reintentos con backoff hasta 24h; los listados son tu red de seguridad.
Authorization
tenantToken Tu token de tenant: tk_live_…. El entorno sandbox llega pronto; los tokens tk_test_ quedarán reservados para él. Scopes: read, lookup, transfers, bonuses, payouts, webhooks. Usa el mínimo.
In: header
Header Parameters
UUID tuyo. Reintentar con la misma llave es el MISMO pedido (200 en vez de 201, y la respuesta trae el header Idempotent-Replay: true para que tu observabilidad distinga el replay del original); la misma llave con otro cuerpo — bytes de archivos incluidos — es 409.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/webhook_endpoints" \ -H "Idempotency-Key: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{ "url": "http://example.com", "events": [ "transfer.completed" ] }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "url": "http://example.com", "events": [ "transfer.completed" ], "created_at": "2019-08-24T14:15:22Z", "secret": "string"}