curl --request GET \
--url https://platform.spritz.finance/v1/integrator/webhooks/deliveries \
--header 'X-Integrator-Key: <api-key>' \
--header 'X-Signature: <api-key>' \
--header 'X-Timestamp: <api-key>'import requests
url = "https://platform.spritz.finance/v1/integrator/webhooks/deliveries"
headers = {
"X-Signature": "<api-key>",
"X-Integrator-Key": "<api-key>",
"X-Timestamp": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Signature': '<api-key>',
'X-Integrator-Key': '<api-key>',
'X-Timestamp': '<api-key>'
}
};
fetch('https://platform.spritz.finance/v1/integrator/webhooks/deliveries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://platform.spritz.finance/v1/integrator/webhooks/deliveries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Integrator-Key: <api-key>",
"X-Signature: <api-key>",
"X-Timestamp: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://platform.spritz.finance/v1/integrator/webhooks/deliveries"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Signature", "<api-key>")
req.Header.Add("X-Integrator-Key", "<api-key>")
req.Header.Add("X-Timestamp", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://platform.spritz.finance/v1/integrator/webhooks/deliveries")
.header("X-Signature", "<api-key>")
.header("X-Integrator-Key", "<api-key>")
.header("X-Timestamp", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.spritz.finance/v1/integrator/webhooks/deliveries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Signature"] = '<api-key>'
request["X-Integrator-Key"] = '<api-key>'
request["X-Timestamp"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "6a7441a013a0c37c0d1facfe",
"eventId": "<string>",
"status": "pending",
"attempts": 1,
"nextAttemptAt": "2023-11-07T05:31:56Z",
"event": "onramp.completed",
"webhookUrl": "https://api.example.com/webhooks",
"payload": {
"schemaVersion": "1",
"eventId": "<string>",
"sequence": 2,
"occurredAt": "2023-11-07T05:31:56Z",
"userId": "<string>",
"id": "dep_01K3NQ4QGM7Y5ZP0DRW1M4V8NC",
"deposit": {
"id": "dep_01K3NQ4QGM7Y5ZP0DRW1M4V8NC",
"asset": "USDC",
"destinationAddressDisplay": "9xQeWv…wM9R",
"principalAmountUsd": "<string>",
"totalDebitAmountUsd": "<string>",
"confirmedReleasedAmountUsd": "<string>",
"debitStatus": "authorized",
"releaseStatus": "not_started",
"releaseDecisionMode": "after_settlement",
"instantPortionUsd": "<string>",
"settlementPortionUsd": "<string>",
"userFeeUsd": "<string>"
},
"fundingSource": {
"id": "fs_01K3NQ4QGM7Y5ZP0DRW1M4V8NC",
"institutionName": "<string>",
"accountMask": "<string>"
},
"event": "achDebit.authorized",
"milestone": "authorized",
"achReturn": {
"id": "dr_01K3NQ4QGM7Y5ZP0DRW1M4V8NC",
"amountUsd": "<string>",
"returnCode": "R01",
"cryptoStateAtReturn": "not_released",
"sourceAction": "disabled",
"userAction": "review_required"
}
},
"success": true,
"responseStatus": 200,
"error": "getaddrinfo ENOTFOUND webhooks.example.com",
"timestamp": "2023-11-07T05:31:56Z"
}
],
"hasMore": true,
"nextCursor": "<string>"
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}{
"title": "Unauthorized",
"status": 401,
"type": "urn:problem-type:auth:unauthorized",
"detail": "Bearer token required",
"instance": "<string>",
"realm": "API",
"scope": "read:users"
}{
"title": "<string>",
"status": 404,
"resourceType": "user",
"resourceId": "<string>",
"type": "about:blank",
"detail": "<string>",
"instance": "<string>"
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}Get webhook deliveries
Returns recent webhook deliveries for the integrator, newest first. A delivery is one event sent to one webhook, including all of its retries.
Use this to tell “Spritz never sent it” apart from “my endpoint rejected it” — from the outside both look like silence.
Read error first — it is what separates the two cases.
success: true— your endpoint accepted the delivery, andresponseStatusis what it returned.success: false, noerror, with aresponseStatus— the request reached your endpoint and it responded with that status. Your handler is being called and is failing.success: falsewith neithererrornorresponseStatus— the outcome was not recorded. Only older records look like this; every delivery the current sender writes carries a status. There is nothing to diagnose from them.success: falsewith anerror— no usable response came back: a timeout, a refused connection, a DNS or certificate problem.errorcarries the underlying reason (for examplegetaddrinfo ENOTFOUND ...). Note thatresponseStatusis still present here — 504 for a timeout, 500 otherwise — but it is our classification of the failure, not something your endpoint said. Do not read it as your handler’s response.
An
errordoes not prove the event was not processed. A refused connection means it never arrived, but a timeout or a dropped connection may mean your endpoint received and fully handled the event and we simply never heard the answer. Treat these as unknown, not as not delivered — re-running non-idempotent work on the strength of anerroris how you double-process. This is the case idempotent handlers exist for.
success, responseStatus, error and timestamp describe the latest attempt. status describes the delivery as a whole:
pending— the latest attempt failed and Spritz will retry atnextAttemptAt.succeeded— your endpoint returned a 2xx. Terminal.failed— Spritz stopped retrying. Terminal; usePOST /v1/integrator/webhooks/deliveries/{deliveryId}/redeliveronce your endpoint is fixed.
Retries: Spritz retries a failed delivery for about 24 hours, waiting roughly 30s, 2m, 10m, 30m, 1h, 2h, 4h, 8h, then 8h between attempts. Timings are approximate, not guaranteed. A 3xx response, or a 4xx other than 408 or 429, is not retried: the delivery becomes failed immediately.
Delivery ID: each delivery has a stable id, sent as the Spritz-Delivery-Id header on every attempt and redelivery. eventId identifies the event; deduplicate on it.
payload is the exact body that was sent, and the body the signature headers were computed over, so it can be replayed against your own verification code.
Cursor-paginated: pass the previous response’s nextCursor as cursor to walk further back. nextCursor is null on the last page.
No fixed retention period is guaranteed. Treat this endpoint as a diagnostic and recovery aid, not permanent event storage. Store accepted webhook events durably, and reconcile or redeliver deliveries that end failed.
Deliveries are recorded for every webhook on the integrator. Scope is your own integrator only.
curl --request GET \
--url https://platform.spritz.finance/v1/integrator/webhooks/deliveries \
--header 'X-Integrator-Key: <api-key>' \
--header 'X-Signature: <api-key>' \
--header 'X-Timestamp: <api-key>'import requests
url = "https://platform.spritz.finance/v1/integrator/webhooks/deliveries"
headers = {
"X-Signature": "<api-key>",
"X-Integrator-Key": "<api-key>",
"X-Timestamp": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Signature': '<api-key>',
'X-Integrator-Key': '<api-key>',
'X-Timestamp': '<api-key>'
}
};
fetch('https://platform.spritz.finance/v1/integrator/webhooks/deliveries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://platform.spritz.finance/v1/integrator/webhooks/deliveries",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Integrator-Key: <api-key>",
"X-Signature: <api-key>",
"X-Timestamp: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://platform.spritz.finance/v1/integrator/webhooks/deliveries"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Signature", "<api-key>")
req.Header.Add("X-Integrator-Key", "<api-key>")
req.Header.Add("X-Timestamp", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://platform.spritz.finance/v1/integrator/webhooks/deliveries")
.header("X-Signature", "<api-key>")
.header("X-Integrator-Key", "<api-key>")
.header("X-Timestamp", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.spritz.finance/v1/integrator/webhooks/deliveries")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Signature"] = '<api-key>'
request["X-Integrator-Key"] = '<api-key>'
request["X-Timestamp"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "6a7441a013a0c37c0d1facfe",
"eventId": "<string>",
"status": "pending",
"attempts": 1,
"nextAttemptAt": "2023-11-07T05:31:56Z",
"event": "onramp.completed",
"webhookUrl": "https://api.example.com/webhooks",
"payload": {
"schemaVersion": "1",
"eventId": "<string>",
"sequence": 2,
"occurredAt": "2023-11-07T05:31:56Z",
"userId": "<string>",
"id": "dep_01K3NQ4QGM7Y5ZP0DRW1M4V8NC",
"deposit": {
"id": "dep_01K3NQ4QGM7Y5ZP0DRW1M4V8NC",
"asset": "USDC",
"destinationAddressDisplay": "9xQeWv…wM9R",
"principalAmountUsd": "<string>",
"totalDebitAmountUsd": "<string>",
"confirmedReleasedAmountUsd": "<string>",
"debitStatus": "authorized",
"releaseStatus": "not_started",
"releaseDecisionMode": "after_settlement",
"instantPortionUsd": "<string>",
"settlementPortionUsd": "<string>",
"userFeeUsd": "<string>"
},
"fundingSource": {
"id": "fs_01K3NQ4QGM7Y5ZP0DRW1M4V8NC",
"institutionName": "<string>",
"accountMask": "<string>"
},
"event": "achDebit.authorized",
"milestone": "authorized",
"achReturn": {
"id": "dr_01K3NQ4QGM7Y5ZP0DRW1M4V8NC",
"amountUsd": "<string>",
"returnCode": "R01",
"cryptoStateAtReturn": "not_released",
"sourceAction": "disabled",
"userAction": "review_required"
}
},
"success": true,
"responseStatus": 200,
"error": "getaddrinfo ENOTFOUND webhooks.example.com",
"timestamp": "2023-11-07T05:31:56Z"
}
],
"hasMore": true,
"nextCursor": "<string>"
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}{
"title": "Unauthorized",
"status": 401,
"type": "urn:problem-type:auth:unauthorized",
"detail": "Bearer token required",
"instance": "<string>",
"realm": "API",
"scope": "read:users"
}{
"title": "<string>",
"status": 404,
"resourceType": "user",
"resourceId": "<string>",
"type": "about:blank",
"detail": "<string>",
"instance": "<string>"
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}{
"title": "Unauthorized",
"status": 400,
"type": "urn:problem-type:auth:unauthorized",
"detail": "<string>",
"instance": "/errors/1234567890",
"code": "transaction_limit",
"field": "amountUsd",
"retryable": true,
"retryAfter": 5,
"suggestedAction": "auto_ramp",
"clearsAt": "2023-11-07T05:31:56Z",
"availableAt": "2023-11-07T05:31:56Z",
"permanent": true
}Authorizations
HMAC signature authentication for backend integrators.
Required Headers:
- X-Integrator-Key: Integrator API key (format: ik_...)
- X-Signature: HMAC signature (format: sha256={hex})
- X-Timestamp: Unix timestamp in milliseconds
- Authorization: Bearer {user-api-key}
Signature Algorithm: HMAC-SHA256
Signature Format: {timestamp}.{METHOD}.{path}.{bodyHash}
- timestamp: Unix timestamp in milliseconds
- METHOD: HTTP method in UPPERCASE (GET, POST, etc.)
- path: Request path (e.g., /v1/transactions)
- bodyHash: SHA256 hex digest of request body (empty string if no body)
Timestamp Tolerance: ±5 minutes (300 seconds)
Example: For POST /v1/transactions with body {"amount":100} and timestamp 1234567890000: Payload: 1234567890000.POST./v1/transactions.{sha256(body)} Signature: sha256=abc123...