Wallets API
Multi-currency balances
Provision wallets in USD · AED · EUR. Read balances, list transactions, post ledger entries.
POST /walletsThe same primitives BINKPAY uses internally are exposed via a clean REST surface: cards, wallets, transfers, payments.
Every endpoint is idempotent on a request key, returns a predictable shape, and emits signed webhooks for every state transition. No surprises in production.
// Issue a virtual USD card with a $5,000 limit
import binkpay from "@binkpay/node";
const card = await binkpay.cards.create({
currency: "USD",
category: "VIRTUAL",
monthlyLimitMinor: 500000, // $5,000.00
}, { idempotencyKey });
// → { id: "crd_8s4k...", status: "ACTIVE", last4: "4271" }REST over HTTPS, JSON in and out, idempotency keys on every mutation, signed webhooks for every state change.
Wallets API
Provision wallets in USD · AED · EUR. Read balances, list transactions, post ledger entries.
POST /walletsCards API
Virtual or physical, in USD or AED. Per-card limits, MCC blocks, OTP-gated reveal.
POST /cardsPayments API
Drop-in checkout, hosted page, REST charges. 3DS 2.0, refunds, dispute API.
POST /paymentsWebhooks
Every state transition emits a signed event. Replay-safe, idempotent, with a 30-day retention window.
HMAC SHA-256Hand-written, typed wrappers around the REST surface. Pagination, retries, and idempotency built in. Generated types stay in sync with the OpenAPI spec on every release.
@binkpay/node
Full type coverage, async iterators for pagination, automatic retry with exponential backoff.
npm install @binkpay/nodebinkpay-python
Typed dataclasses, async/sync clients, idempotency-key helpers, webhook verifier.
pip install binkpayOpenAPI
Generate clients in any language. Live API explorer with sandbox keys baked in.
binkpay.dev/openapi.jsonOpen-source
All SDKs, OpenAPI spec, and example apps live on GitHub.
Spin up sandbox keys instantly. Promote to production after a single KYB review. Documentation, OpenAPI spec, and reference implementations included.