delopay
Official server-side Rust SDK for the DeloPay payments API.
Typed, async, hyper-based, with a constant-time webhook verifier.
Covers payments, hosted checkout and payment links, webhook verification, refunds, customers, payouts, disputes with evidence, mandates, payment methods, events, subscriptions, ephemeral keys, poll, cards, forex, files, and export.
Installation
You also need an async runtime (tokio).
[]
= { = "1", = ["macros", "rt-multi-thread"] }
= "0.2"
Webhook-only build (no HTTP client)
If a service only needs to verify incoming webhooks and read the wire models,
disable the default client feature. That build has no hyper, tokio, or
async runtime, pulls 26 crates instead of 64, and is pure Rust, so no C
toolchain is required:
= { = "0.2", = false }
webhooks::verify, WebhookEvent, DelopayError, and all the *Response
models are available; Delopay, the request builders, and the resources
module are not.
Create a payment with hosted checkout
use ;
async
The return page is not the source of truth. Reconcile status from the webhook,
or client.payments().retrieve_synced(&id).
Verify a webhook
DeloPay signs each webhook with HMAC-SHA512 over the raw body; the hex digest
arrives in the X-Webhook-Signature-512 header. Verify the raw bytes before
parsing:
use webhooks;
// raw_body: &[u8] captured before JSON parsing; sig: the header value.
let event = verify?;
if event.event_type == "payment_succeeded"
Subscriptions
Subscription endpoints are profile-scoped; the backend requires an
x-profile-id header. Scope the resource once:
let subscriptions = client.subscriptions.with_profile_id;
let sub = subscriptions.retrieve.await?;
HTTP proxies
Behind a corporate egress proxy, the SDK reads the usual environment
variables (HTTPS_PROXY, HTTP_PROXY, ALL_PROXY, filtered by NO_PROXY),
or you can configure it on the builder:
let client = builder
.proxy // ignore the environment
.build;
let client = builder.no_proxy.build;
http:// proxies only, via HTTP CONNECT tunnelling: TLS is negotiated with
the API through the tunnel, so the proxy never sees plaintext. A configured
but unusable proxy fails every request instead of silently connecting direct,
and proxy credentials never appear in Debug output.
Design notes
- HTTP:
hyperdirectly, notreqwest. TheTransporttrait is the only backend seam; retries, backoff, and error mapping sit above it. - TLS:
rustlswith theringprovider passed explicitly; the SDK never installs a process-global crypto provider. Portable across Linux, macOS, and Windows. - Retries: automatic on
429(always) and on network errors or5xxfor idempotent calls (GET, or a request with an idempotency key), so a create is never silently duplicated. HonorsRetry-After. - Forward-compatible: responses keep unknown fields in an
extramap, so a new API field never breaks deserialization. - Bounded memory: response bodies are capped at 10 MiB.
- Errors:
DelopayErrordistinguishesApi,Authentication(401),Timeout,Transport,InvalidSignature, andInvalidRequest.ApiandAuthenticationcarry the APIcode,type, andx-request-id.
License
MIT, see LICENSE.