Developer Hub — v3.1 API

Build Faster. Ship Rewards
in Minutes.

The blackhawnketwork REST API gives you a single, unified endpoint to issue gift cards, manage incentive payouts, and track delivery — across 1,000+ brands worldwide.

Explore our SDKs for Node.js, Python, PHP, and Go. Test every call in the live Sandbox with zero risk before going live.

REST API📦Official SDKs🧪Live Sandbox🔐OAuth 2.0🌍1,000+ Brands
terminal — blackhawnketwork API

# POST /v1/rewards — Issue a Gift Card

curl -X POST https://api.blackhawnketwork.com/v1/rewards 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "recipient_email": "[email protected]",
    "brand": "amazon",
    "amount": 50.00,
    "currency": "USD",
    "message": "Thanks for your loyalty!"
  }'

# 200 OK — Response

{
  "status": "success",
  "reward_id": "rwd_9f3a2c17e4b8",
  "delivery": "instant",
  "tracking_url": "https://track.blackhawnketwork.com/rwd_9f3a2c17e4b8"
}
Sandbox mode active
latency: ~42ms
99.99{48e30695cfb0fe5f7a4a7444b49788b7da1293cc5c2ef68df6e156436216f1d4}Uptime SLA
< 100msAvg. Response
256-bitTLS Encryption
Official SDKsMIT Licensed

SDKs & Developer Tools

Officially maintained libraries for every major stack. Install in minutes, ship in hours. All packages receive weekly updates and are covered by our SLA.

All repos are open-source on GitHub
6Languages Supported
6.1k+Total GitHub Stars
340k+Weekly Downloads
< 2 hrsAvg. Integration Time
JS

Node.js SDK

v3.4.1
1.2k

Async-first SDK for Node.js and TypeScript with full type definitions.

Actively MaintainedMIT License
View on GitHub

Python SDK

v2.7.0
984

Pythonic library with sync and async clients, compatible with Python 3.8+.

Actively MaintainedMIT License
View on GitHub
Java

Java SDK

v1.9.3
741

Enterprise-grade SDK for Java 11+ with Spring Boot integration out of the box.

Actively MaintainedMIT License
View on GitHub
PHP

PHP SDK

v2.1.0
612

Composer-installable SDK supporting PHP 8.0+ with PSR-18 HTTP client compatibility.

Actively MaintainedMIT License
View on GitHub
RUBY

Ruby SDK

v1.5.2
489

Gem for Ruby 3.0+ with ActiveSupport compatibility and Rails helpers included.

Actively MaintainedMIT License
View on GitHub

Postman Collection

v4.0
2.1k

Pre-configured Postman workspace with all endpoints, environments, and auth flows.

Actively MaintainedMIT License
View on GitHub

Don't see your language?

Our REST API works with any HTTP client. Check the full API reference or request an SDK.

API Key Management

Manage API Keys withPrecision and Control

Follow this step-by-step guide to generate, scope, rotate, monitor, and revoke API keys in your blackhawnketwork account — keeping your payment integrations secure at every stage.

Progress1 / 5
Step 1

Generate Your API Key

Navigate to the API Keys section inside your blackhawnketwork dashboard. Click Create New Key, give it a descriptive label (e.g. production-payments-v1), and confirm your identity via two-factor authentication.

shell
POST /v1/api-keys
{
  "label": "production-payments-v1",
  "scope": "write",
  "expires_at": "2026-12-31"
}

Your secret key is shown only once at creation. Copy and store it securely in a secrets manager — never in source code.

Generate a Key

API Keys Settings Panel

A look at the key management interface inside your blackhawnketwork dashboard

dashboard.blackhawnketwork.com/settings/api-keys
blackhawnketwork API Keys Settings Panel

Screenshot for illustration. UI may vary by account plan.

blackhawnketwork

Power Your Payments with a Single API. Enterprise-grade gift card & incentive distribution built for scale.

Get in Touch

[email protected]+1 (800) 555-0198
2200 Mission College Blvd,
Santa Clara, CA 95054, USA

© 2026 blackhawnketwork. All rights reserved.

All Systems Operational