Crypto Payment API | AlbaPay Infrastructure
Developer First

The Ultimate
Crypto Payment API

A robust, non-custodial REST API engineered for scale. Accept over 300 cryptocurrencies globally, automatically trigger IPN webhooks, and settle directly to your cold storage with 0% platform fees. Built by developers, for developers.

99.99% Uptime
< 200ms Latency
Sandbox Env
POST /v1/payments
// Create a new crypto payment
curl -X POST https://api.AlbaPay.com/v1/payments \
  -H "x-api-key: cg_live_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "price_amount": 150.00,
    "price_currency": "USD",
    "pay_currency": "USDTTRC20",
    "order_id": "INV-98214",
    "ipn_callback_url": "https://yourapp.com/webhooks"
  }'

// 200 OK Response
{
  "payment_id": "pay_8x29j1d9",
  "pay_address": "TWEyxJm...",
  "pay_amount": "150.00",
  "status": "waiting"
}
Frustrated developer

Stop Wasting Time on Fragile Crypto Integrations

Building your own cryptocurrency checkout from scratch is a nightmare. Running your own Bitcoin, Ethereum, and Tron nodes requires massive server resources, constant security patching, and complex websocket listeners just to detect when a user sends funds.

Custodial APIs (like Coinbase Commerce or Binance Pay) force your users to create accounts, hit you with 1-2% platform fees, and worse — they hold your private keys. If they suspect your industry is "high-risk", your funds get frozen indefinitely.

"We moved from a custodial payment gateway because their compliance team froze $40,000 of our revenue for a week. AlbaPay gives us the infrastructure without custody of our funds."

— Lead Backend Engineer, Global Casino Platform

How the API Works

Four simple steps to fully automated, non-custodial crypto payments.

1

Create Payment

Send a POST request with fiat amount, currency, and Order ID. We instantly generate a unique crypto wallet address and exact coin amount based on real-time Oracles.

User Pays

Display the payment address and QR code in your UI. The customer sends funds using their preferred wallet. No sign-ups required.

Auto-Forward

The exact moment the transaction is confirmed on the blockchain, our system automatically forwards the funds directly to your pre-configured cold wallet address.

IPN Webhook

Simultaneously, we fire a cryptographic signed POST webhook to your server, allowing your backend to automatically mark the invoice as paid and grant the user access.

API Features Extensively Documented

More than just a payment gateway. A complete blockchain infrastructure API.

Real-Time Pricing Oracles

Lock in the exchange rate for 20 minutes (customizable). Our API calculates the exact crypto amount needed to satisfy a fiat invoice using aggregate rate data from Binance and Kraken.

Cryptographic Webhook Signatures

Never worry about spoofed callbacks. Every IPN payload includes an HMAC SHA-512 signature in the header, generated using your private IPN Secret.

Underpaid & Overpaid Handling

Crypto users sometimes send the wrong amount due to wallet fees. Our API handles "partially_paid" statuses natively, allowing you to prompt them for the difference or auto-refund.

Auto Fiat Conversions

Don't want to hold volatile crypto? Use our fiat conversion endpoints to automatically swap received Bitcoin or meme coins into USDT Stablecoins or direct SEPA / Wire bank transfers.

Full White-Label Support

You don't have to use our checkout pages. Retrieve the wallet address and exact amount via API, and generate the QR code natively on your own branded frontend.

Developer Sandbox

Test everything without spending real money. Our sandbox environment runs on Testnets (Goerli, Bitcoin Testnet), letting you simulate payments, confirmations, and webhooks freely.

Built for High-Volume Platforms

  • iGaming & Casino Deposits

    API allows players to fund accounts instantly using USDT or TRX without leaving the game window. Webhooks add credits to player balances autonomously.

  • B2B SaaS / App Licensing

    Sell software licenses to global clients bypassing Stripe blocks. When the API returns the paid webhook, your system generates the activation key automatically.

  • Trading Platform Funding

    Prop-trading firms and forex platforms use our API to process high-value stablecoin deposits from traders globally without wire transfer delays.

Dashboard Data

Handle Webhooks Securely

A real-world example of how to handle an incoming IPN notification in PHP securely verifying the signature.

webhook_handler.php
<?php
// 1. Get the payload and signature
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_PAYMENT_SIGNATURE'];

// 2. Your IPN Secret from Dashboard
$ipn_secret = "your_ipn_secret_key_here";

// 3. Calculate expected signature
$expected_sig = hash_hmac('sha512', $payload, $ipn_secret);

// 4. Time-constant compare to prevent timing attacks
if (!hash_equals($expected_sig, $signature)) {
    http_response_code(401);
    die('Invalid Signature');
}

// 5. Process valid payment
$data = json_decode($payload, true);
if ($data['payment_status'] === 'finished') {
    // Payment confirmed! Update database.
    $db->query("UPDATE orders SET status='paid' WHERE id=?", [$data['order_id']]);
}

http_response_code(200);
echo 'OK';

API vs Legacy Gateways

Why developers are ripping out Stripe to build custom crypto flows.

Feature AlbaPay API Stripe / PayPal API Custodial Crypto APIs
Chargeback Risk 0% (Impossible) High (120+ days) 0%
Fund Custody You hold your keys Bank holds funds Platform holds funds
Settlement Speed In seconds (Blockchain) 3-7 Business Days Daily batching
Account Throttling/Freezes Never (Decentralized) Algorithm based High-risk restricted
Platform Fees 0% 2.9% + 30¢ 1.0% - 2.0%

API FAQs

What are the rate limits for the API?

Our free tier allows 100 API requests per second (RPS) per IP address. For Enterprise merchants, dedicated instances are provisioned with virtually unlimited throughput capable of handling 20,000+ RPS.

Do I need an SSL certificate to receive Webhooks?

Yes. For security reasons, we will only dispatch IPN webhooks to HTTPS URLs with valid SSL certificates. Self-signed certificates will be rejected during payload delivery.

Ready to start building?

Grab your API keys and make your first testnet transaction in under 2 minutes.