API Integration

Processing Only mode uses dedicated HUB2 API endpoints that are different from our traditional aggregation model. The main difference is that transactions are processed directly through your provider accounts instead of our aggregated accounts. Available endpoint are availble at: https://api.hub2.io/docs#/Delegation

Authentication

Your integration uses the same HUB2 API keys for authentication but the key must have new permissions:
  • Api.delegated_payment_create
  • Api.delegated_transfer_create

Transaction Flow

1. Transaction Request

When you initiate a transaction, HUB2 will:
  1. Validate Request: Check your API key and request format
  2. Route to Provider: Direct the request to your configured provider account
  3. Process Transaction: Execute the transaction using your provider credentials
  4. Return Response: Provide a unified response format regardless of the provider

2. Provider Processing

The actual transaction processing happens directly with your provider:

API Endpoints

Processing Only mode uses dedicated creation endpoints, while reading endpoints remain the same as traditional ones:

Payments

  • POST /delegated/payments - Create a payment using your provider account
  • POST /delegated/payments/sync - Create a payment using your provider account with synchronous mode (the list of providers supporting synchronous is availabe at https://docs.hub2.io/integration/en/getting_started/api_operation#synchronous-circuit)
  • GET /payments - List payments (same as classic payments)
  • GET /payments/{id}/status - Get payment status (same as classic payments)

Transfers

  • POST /delegated/transfers - Create a transfer using your provider accounts
  • POST /delegated/transfers/irt - Create an IRT transfer using your provider accounts
  • GET /transfers - List transfers (same as classic transfers)
  • GET /transfers/{id}/status - Get transfer status (same as classic transfers)

Webhooks

This uses the same webhooks as the classic circuit. If you’ve already configured webhooks for payments/ transfers, no extra steps are required. Else, see: https://docs.hub2.io/integration/en/webhooks/webhooks_overview