Skip to main content
This guide focuses on B2B payouts. You’ll provision resources for one of your business customers in the HopNow sandbox.

​
Get your API credentials

Before making your first API call, you’ll need to obtain your API credentials from the Developer Dashboard.
1

Sign up for an account

Create your account at www.sbx.hopnow.io
2

Generate API keys

Navigate to API Keys in your dashboard and create a new API key pair:
  • API Key ID: Used to identify your requests
  • API Secret: Used to sign your requests (keep this secure!)
3

Note your Customer ID

Your Customer ID is displayed in the dashboard - you’ll need this for API calls

​
Make your first API call

Provision an operating account for a business customer to start modeling balances and payouts.
All API requests require HMAC authentication. For this quickstart, we’ll show simplified examples. See our Authentication Guide for full implementation details.

​
1. Create an Account

curl -X POST https://apis-sbx.hopnow.io/v1/customers/{customer_id}/accounts \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {your_api_key_id}" \
  -H "X-Signature: {hmac_signature}" \
  -H "X-Timestamp: {unix_timestamp}" \
  -d '{
    "name": "My First Account"
  }'
All examples target the sandbox host (https://apis-sbx.hopnow.io). Replace it with https://apis.hopnow.io when promoting to production.

​
2. Expected Response

{
  "id": "acc_1234567890abcdef",
  "object": "account",
  "customer_id": "cus_1234567890abcdef",
  "name": "My First Account",
  "status": "active",
  "balances": [],
  "created": "2024-01-01T00:00:00Z",
  "updated": "2024-01-01T00:00:00Z"
}
Congratulations! 🎉 You’ve created a sandbox account for one of your business customers.

​
Next steps

Now that you’ve made your first API call, here’s what to explore next:

Set up Authentication

Implement proper HMAC authentication for production use

Explore API Reference

Browse all available API endpoints and features

Set up Webhooks

Receive real-time notifications about account activity

Process Transfers

Learn about payment processing capabilities

​
Common use cases

​
For Payment Processors

  1. Create customer accounts for each of your users
  2. Generate virtual accounts for local banking details
  3. Set up webhooks to track payment status
  4. Process payins/payouts as needed

​
For Crypto Exchanges

  1. Create accounts for fiat currency management
  2. Set up wallets for crypto operations
  3. Use FX quotes for currency conversion
  4. Integrate webhooks for real-time updates

​
For International Businesses

  1. Create multi-currency accounts for global operations
  2. Set up beneficiaries for regular payouts
  3. Use FX services for currency hedging
  4. Track transfers with comprehensive reporting

​
SDK and Tools

While our API is REST-based and works with any HTTP client, we’re working on official SDKs:
  • Python SDK - Coming soon
  • Node.js SDK - Coming soon
  • Postman Collection - Available now

​
Getting Help

Authentication Guide

Complete HMAC authentication implementation guide

API Reference

Complete endpoint documentation with request/response examples
Ready to dive deeper? Check out our complete API reference or learn about HMAC authentication.