Skip to main content

​
123hub Payment Gateway API

123hub is a modern payment gateway that enables merchants to accept payments, process payouts, and manage their financial operations through a single API endpoint using method-based routing.

Quick Start

Get up and running with your first API call in minutes

Authentication

Learn how to authenticate with Application ID and SHA512 hash

Payments Guide

Create deposits, withdrawals, and check payment status

Webhooks

Receive real-time notifications about payment events

​
How It Works

All API interactions go through a single POST endpoint with method-based routing. Instead of different URLs for different operations, you specify the method field in the request body.
Example Request
{
  "method": "payment.in",
  "service_id": 14701,
  "params": {
    "payment": {
      "description": "Order #12345",
      "identifiers": { "c_id": 12345 },
      "amount": { "value": 10000, "currency": "INR" },
      "payer": {
        "email": "[email protected]",
        "person": { "first_name": "John", "last_name": "Doe" }
      }
    }
  }
}
Example Response
{
  "success": true,
  "result": {
    "payment": {
      "amount": { "value": 10000, "currency": "INR" },
      "identifiers": { "c_id": 12345, "h_id": 1001 },
      "status": { "status": "created", "final": false, "success": null },
      "destination": "in",
      "service_id": 14701
    }
  },
  "request_id": "req_7f3a9b2c",
  "processing_time": 42
}

​
Available Methods

MethodDescription
payment.inCreate an incoming payment (deposit)
payment.outCreate an outgoing payment (withdrawal/payout)
payment.statusCheck the status of an existing payment
balance.getRetrieve your account balance
gateway.pingHealth check to verify connectivity and authentication

​
Features

Accept payments via bank transfers, cash payments, card payments, and cryptocurrency. Multiple currencies supported (ARS, BRL, CNY, COP, EUR, GEL, MXN, USD, UYU).
Receive instant notifications when payment status changes. Secure webhook delivery with SHA512 signatures and automatic retries.
All API operations go through one URL. The method field in the request body determines the action. Simplifies integration and reduces configuration overhead.
Every response follows the same envelope structure with success, result, error, request_id, and processing_time fields. Successful responses return HTTP 200, errors return HTTP 400 (or 404 for unknown methods).

​
Base URL

All API requests are made to: 
https://api.123hub.pro/public/api/multihub/v1
All requests use the POST method. The same endpoint is used for both test and production environments. Your credentials determine which environment is active.

​
Authentication

Every request requires two headers:
HeaderDescription
X-Data-Application-IdYour application ID (integer)
X-Data-HashSHA512 hex hash of requestBody + secretKey
See the Authentication page for full details and code examples.

​
Supported Payment Methods

MethodTypeDescriptionProcessing Time
speiBank TransferMexican interbank transfer system (SPEI)Up to 30 minutes
oxxoCashPay at 20,000+ OXXO convenience storesUp to 30 minutes
cardCardCredit and debit cards (tokenized)Up to 30 minutes
bank_transferBank TransferGeneric bank transferUp to 30 minutes
cashCashCash paymentsUp to 30 minutes
cryptoCryptocurrencyCrypto payments (USDT, etc.)Up to 30 minutes

​
Supported Currencies

CurrencyCodeCountryDefault Method
Argentine PesoARSArgentinabank_transfer
Brazilian RealBRLBrazilbank_transfer
Chinese YuanCNYChinabank_transfer
Colombian PesoCOPColombiabank_transfer
EuroEUREuropebank_transfer
Georgian LariGELGeorgiabank_transfer
Mexican PesoMXNMexicospei
US DollarUSDInternationalbank_transfer
Uruguayan PesoUYUUruguaybank_transfer

​
Response Format

All responses follow a consistent envelope:
Success Response (HTTP 200)
{
  "success": true,
  "result": { ... },
  "request_id": "req_7f3a9b2c",
  "processing_time": 42
}
Error Response (HTTP 400)
{
  "success": false,
  "error": {
    "code": 6010,
    "message": "Payment does not exist",
    "details": null,
    "context": null
  },
  "request_id": "req_8d4b1e3f",
  "processing_time": 5
}
Successful responses return HTTP 200. Error responses return HTTP 400 (or HTTP 404 for unknown methods). Always check the success field in the response body to determine if the request succeeded.

​
Need Help?

API Reference

Explore all available methods and parameters

Support

Contact our developer support team