跳至主要内容

Appendix

Scene Codes​

Scene codes are based on MCC (Merchant Category Code) industry categories.

MCC Industry Categories​

MCC RangeIndustryDescription
3xxxTravel & AccommodationAirlines, hotels, car rental
4xxxTransportation & UtilitiesTransportation, telecom, utilities
5xxxRetail & ConsumerRetail, food & beverage, gas
6xxxFinancial ServicesBanks, insurance, loans
7xxxBusiness ServicesEntertainment, auto, professional
8xxxProfessional OrganizationsHealthcare, education, membership

Scene Code List​

Scene CodeMCC IndustryDescriptionUse Cases
Transportation (4xxx)
TAXI4xxxTaxi/Ride-hailingDidi, Uber
TRANSIT4xxxPublic TransportationSubway, bus, train
TOLL4xxxToll FeesETC, highway fees
UTILITY4xxxUtilitiesElectricity, water, gas
TELECOM4xxxTelecom ServicesPhone bills, broadband
Retail (5xxx)
FOOD5xxxFood & BeverageFood delivery, restaurant
SUBSCRIPTION5xxxSubscription ServicesContent, recurring delivery
Financial (6xxx)
INSURANCE6xxxInsurance ServicesAuto, health insurance
LOAN6xxxLoan RepaymentCredit card, installment
Business Services (7xxx)
PARKING7xxxParking ServicesParking lots, street parking
RENT7xxxRental ServicesCar rental, bike sharing
ENTERTAINMENT7xxxEntertainmentVideo, music, gaming
FITNESS7xxxFitness & SportsGyms, sports apps
CLOUD7xxxCloud ComputingCloud servers, SaaS
Professional (8xxx)
EDUCATION8xxxEducation & TrainingOnline courses
MEMBERSHIP8xxxMembership OrganizationsClubs, VIP membership
Other
OTHERS-Other ScenariosFallback for uncategorized

Currency List​

Fiat Currency​

CodeDescriptionStandard
CNYChinese YuanISO 4217
USDUS DollarISO 4217
EUREuroISO 4217
GBPBritish PoundISO 4217
JPYJapanese YenISO 4217
KRWKorean WonISO 4217
SGDSingapore DollarISO 4217
HKDHong Kong DollarISO 4217
AUDAustralian DollarISO 4217
CADCanadian DollarISO 4217

Cryptocurrency​

CodeDescriptionNetworks
USDTTetherERC20, TRC20, Arbitrum, Optimism
USDCUSD CoinERC20, TRC20, Arbitrum, Optimism
BTCBitcoinBitcoin
ETHEthereumEthereum
BNBBinance CoinBSC
SOLSolanaSolana
XRPRippleRipple
DOGEDogecoinDogecoin
TRXTronTron
MATICPolygonPolygon
ARBArbitrumArbitrum
OPOptimismOptimism

Currency Type​

TypeDescription
FIATFiat Currency
CRYPTOCryptocurrency

Chain Network List​

Chain CodeDescriptionSupported Currencies
ERC20Ethereum NetworkUSDT, USDC, ETH
TRC20Tron NetworkUSDT, USDC, TRX
ArbitrumArbitrum L2USDT, USDC, ARB, ETH
OptimismOptimism L2USDT, USDC, OP, ETH
BSCBinance Smart ChainBNB, USDT, USDC
PolygonPolygon NetworkMATIC, USDT, USDC
SolanaSolana NetworkSOL, USDT, USDC
BitcoinBitcoin NetworkBTC
TronTron NativeTRX
RippleRipple NetworkXRP
DogecoinDogecoin NetworkDOGE

Notes:

  • chain field must match currency
  • Same currency has different addresses on different chains
  • Chain support may expand with platform upgrades

Amount Precision​

General Rules​

  • All amounts are transmitted as strings to avoid floating-point precision loss
  • Amount values are integers representing minimum units (no decimal point)

Fiat Currency Precision​

CurrencyMinimum UnitDecimalsExample
USDcent2"10000" = 100.00 USD
EURcent2"5000" = 50.00 EUR
CNYfen2"10000" = 100.00 CNY
JPYyen0"1000" = 1000 JPY
KRWwon0"50000" = 50000 KRW
GBPpence2"2000" = 20.00 GBP
SGDcent2"1500" = 15.00 SGD
HKDcent2"7800" = 78.00 HKD

Cryptocurrency Precision​

CurrencyMinimum UnitDecimalsExample
USDTminimum unit6"1000000" = 1.000000 USDT
USDCminimum unit6"1000000" = 1.000000 USDC
BTCsatoshi8"100000000" = 1.00000000 BTC
ETHwei18"1000000000000000000" = 1.0 ETH
TRXsun6"1000000" = 1.000000 TRX
SOLlamport9"1000000000" = 1.000000000 SOL
BNBjager8"100000000" = 1.00000000 BNB
DOGEkoinu8"100000000" = 1.00000000 DOGE

Precision Notes​

  1. Validation: Amounts exceeding supported precision return INVALID_AMOUNT
  2. Exchange Rate: System handles precision conversion for fiat-to-crypto
  3. Refund: Refund amount precision must match original transaction
  4. Minimum Amount: Each currency has minimum transaction amount per merchant config

Sandbox Environment​

Environment Information​

EnvironmentDomainDescription
Sandboxapi2-testnet.bybit.comTest environment, no real transactions
Productionapi2.bybit.comProduction environment, real transactions

Sandbox Features​

  1. Isolated Data: Completely isolated from production
  2. Simulated Transactions: No real fund transfers
  3. Feature Consistency: Same API definitions as production
  4. Relaxed Rate Limits: Lower thresholds for testing

Test Accounts​

TypeDescriptionHow to Obtain
Merchant AccountSandbox test merchantContact platform operations
Test UserSimulated sign userAuto-created in sandbox
API KeySandbox dedicated keyMerchant dashboard

Testing Recommendations​

  1. Full Flow Testing: Complete sign → deduction → refund → unsign flow
  2. Exception Simulation: Use special amounts to trigger states
  3. Webhook Verification: Ensure correct webhook handling
  4. Signature Verification: Verify signature implementation

Special Amount Triggers​

Amount (Minimum Unit)Triggered StatusDescription
Ends with 01SUCCESSImmediate success
Ends with 02PROCESSINGStays processing
Ends with 03FAILEDBalance insufficient
Ends with 04TIMEOUTSimulates timeout
Ends with 99RISK_REJECTTriggers risk control

Examples:

  • Amount 100001 → Returns SUCCESS immediately
  • Amount 100002 → Stays PROCESSING, wait for notification
  • Amount 100003 → Returns FAILED with BALANCE_NOT_ENOUGH