Skip to main content

​
Base URL

https://api.transaction.gg

​
Authentication

Transaction API supports two authentication methods:

​
JWT Authentication

Most endpoints require JWT authentication via the Authorization header: 
Authorization: Bearer <jwt_token>

​
API Key Authentication

Some endpoints use API key authentication: 
Authorization: Bearer <api_key>
API Key Types:
  • public - For payment creation (pk_*)
  • secret - For merchant operations (sk_*)
  • any - For webhook logs (either key type)

​
Response Format

All responses follow this format: 
{
  "success": boolean,
  "error": {
    "status": number,
    "code": string,
    "message": string
  } | null,
  "data": any | null
}

​
Error Codes

CodeStatusDescription
UNAUTHORISED401Invalid or missing authentication
NOT_FOUND404Resource not found
VALIDATION_INVALID400Invalid input data
INVALID_CREDENTIALS401Invalid login credentials
DUPLICATE_ENTRY400Duplicate resource detected
EMAIL_ALREADY_REGISTERED400Email already exists
MERCHANT_NOT_FOUND404Merchant not found
PAYMENT_NOT_FOUND404Payment not found
PRODUCT_NOT_FOUND404Product not found
PRICE_NOT_FOUND404Price not found
CUSTOMER_NOT_FOUND404Customer not found
INSUFFICIENT_BALANCE400Insufficient wallet balance
RATE_LIMITED429Too many requests

​
ID Formats

All entity IDs use prefixed formats:
EntityFormatExampleLength
Customercus_ + 16 charscus_V6n6SN2KnsIFCuQU20
Productprod_ + 16 charsprod_X4dUuzsMaruQ4UsX21
Priceprice_ + 16 charsprice_i62wKFQ8sGnLxQ5G22
Paymentpay_ + 16 charspay_abc123def45619
MerchantUUIDa086a795-a411-4160-81e4-44e92dbc02bf36

​
Rate Limits

  • Authentication endpoints: 5 requests per minute
  • Payment creation: 10 requests per minute
  • Other endpoints: 100 requests per minute

​
Supported Currencies

Fiat Currencies: USD, EUR, GBP, CAD, AUD, JPY, CHF, CNY, INR, BRL, MXN, KRW, SGD, HKD, NOK, SEK, DKK, PLN, CZK, HUF, RON, BGN, HRK, ISK, LTL, LVL, EEK, TRY, RUB, UAH, BYN, KZT, AZN, GEL, AMD, KGS, TJS, UZS, MNT, KHR, LAK, VND, THB, MYR, IDR, PHP, SGD, BND, MMK, LKR, NPR, BDT, PKR, AFN, IRR, IQD, SYP, JOD, LBP, ILS, AED, QAR, BHD, KWD, OMR, YER, SAR, EGP, LYD, TND, DZD, MAD, ETB, KES, UGX, TZS, ZAR, BWP, SZL, LSL, NAD, ZMW, MWK, MZN, AOA, GMD, GHS, NGN, XOF, XAF, CDF, RWF, BIF, DJF, KMF, SCR, MUR, SLL, GNF, LRD, CVE, STN, SHP, FKP, GBP, EUR, USD Cryptocurrencies: BTC, ETH, LTC, SOL