# Возврат средств Source: https://docs.crypto-cash.world/api-reference/actions/возврат-средств /APIs/crypto-cash-openapi.json post /merchant/api/v1/balance/actions/refund/ Создает заявку на возврат средств на указанный кошелек # Покупка криптовалюты (Вывод) Source: https://docs.crypto-cash.world/api-reference/actions/покупка-криптовалюты-вывод /APIs/crypto-cash-openapi.json post /merchant/api/v1/balance/actions/buy/crypto/ Создает заявку на вывод криптовалюты. Конвертация через USDT. Заявки обрабатываются в порядке очереди. # Продажа криптовалюты (Пополнение) Source: https://docs.crypto-cash.world/api-reference/actions/продажа-криптовалюты-пополнение /APIs/crypto-cash-openapi.json post /merchant/api/v1/balance/actions/sale/ Создает заявку на пополнение криптовалюты. Конвертация через USDT. # Получение баланса Source: https://docs.crypto-cash.world/api-reference/balance/получение-баланса /APIs/crypto-cash-openapi.json post /merchant/api/v1/balance/retrieve/ Возвращает баланс мерчанта в USDT # Список криптовалют Source: https://docs.crypto-cash.world/api-reference/reference/список-криптовалют /APIs/crypto-cash-openapi.json post /merchant/api/v1/crypto-currencies/list/ Возвращает список доступных криптовалют с сетями и лимитами # Получение конкретной транзакции Source: https://docs.crypto-cash.world/api-reference/transactions/получение-конкретной-транзакции /APIs/crypto-cash-openapi.json post /merchant/api/v1/balance/payments/retrieve/ Возвращает детали конкретной транзакции по externalId или internalId # Получение списка транзакций Source: https://docs.crypto-cash.world/api-reference/transactions/получение-списка-транзакций /APIs/crypto-cash-openapi.json post /merchant/api/v1/balance/payments/list/ Возвращает список транзакций с пагинацией и фильтрацией # Получение списка транзакций в очереди Source: https://docs.crypto-cash.world/api-reference/transactions/получение-списка-транзакций-в-очереди /APIs/crypto-cash-openapi.json post /merchant/api/v1/queues Возвращает список транзакций в очереди на вывод # List in Source: https://docs.crypto-cash.world/crypto-currencies/list-in # Крипто валюты ## Список валют на пополнение (Pay-in) > [!NOTE] > > Не нашли интересующую вас монету? Напишите нам на [info@crypto-cash.world](mailto:info@crypto-cash.world) - и мы добавим её в список. | Currency | Network | Ticker | Network Confirm | Network Fee | Min | Max | Exchange | Memo | | | - | - | - | - | - | - | - | - | - | - | | USDT | TRC20 | USDTTRC20 | 3 | 0% | 5 USDT | --- | 0% | --- | | | USDT | ERC20 | USDTERC20 | 12 | 0% | 5 USDT | --- | 0% | --- | | | USDT | BEP20 | USDTBEP20 | 15 | 0% | 10 USDT | --- | 0% | --- | | | USDT | POLYGON | USDTPOLYGON | 200 | 0% | 5 USDT | --- | 0% | --- | | | USDT | ARBITRUM | USDTARBTM | 120 | 0% | 5 USDT | --- | 0% | --- | | | USDT | CCHAIN | USDTC | 32 | 0% | 5 USDT | --- | 0% | --- | | | USDT | NEAR | USDTNEAR | 5 | 0% | 5 USDT | --- | 0% | --- | | | USDT | SOL | USDTSOL | 2 | 0% | 5 USDT | --- | 0% | --- | | | USDT | TON | USDTTON | 1 | 0% | 5 USDT | --- | 0% | --- | | | USDT | OPTIMISM | USDTOPTM | 100 | 0% | 5 USDT | --- | 0% | --- | | | BTC | BTC | BTC | 1 | 0% | 0.00003 BTC | --- | 0% | --- | | | BTC | BEP20 | BTCBEP20 | 15 | 0% | 0.0001 BTC | --- | 0% | --- | | | ETH | ERC20 | ETH | 12 | 0% | 0.004 ETH | --- | 0% | --- | | | ETH | ARBITRUM | ETHARBTM | 120 | 0% | 0.015 ETH | --- | 0% | --- | | | ETH | BASE | ETHBASE | 100 | 0% | 0.004 ETH | --- | 0% | --- | | | ETH | BEP20 | ETHBEP20 | 15 | 0% | 0.004 ETH | --- | 0% | --- | | | ETH | OPTIMISM | ETHOPTM | 100 | 0% | 0.004 ETH | --- | 0% | --- | | | ETC | ETC | ETC | 300 | 0% | 0.06 ETC | --- | 0% | --- | | | USDC | ERC20 | USDCERC20 | 12 | 0% | 5 USDC | --- | 0% | --- | | | USDC | BASE | USDCBASE | 100 | 0% | 5 USDC | --- | 0% | --- | | | USDC | POLYGON | USDCPOLYGON | 200 | 0% | 5 USDC | --- | 0% | --- | | | USDC | CCHAIN | USDCC | 32 | 0% | 5 USDC | --- | 0% | --- | | | USDC | NEAR | USDCNEAR | 5 | 0% | 5 USDC | --- | 0% | --- | | | USDC | SOL | USDCSOL | 2 | 0% | 5 USDC | --- | 0% | --- | | | USDC | STELLAR | USDCXLM | 1 | 0% | 0.01 USDC | --- | 0% | Required | | | USDC | ARBITRUM | USDCARBTM | 120 | 0% | 5 USDC | --- | 0% | --- | | | USDC | OPTIMISM | USDCOPTM | 100 | 0% | 5 USDC | --- | 0% | --- | | | USDC | BEP20 | USDCBEP20 | 15 | 0% | 0.01 USDC | --- | 0% | --- | | | USDC | SUI | USDCSUI | 1 | 0% | 5 USDC | --- | 0% | --- | | | USDS | ERC20 | USDS | 12 | 0% | 5 USDS | --- | 0% | --- | | | ADA | ADA | ADA | 30 | 0% | 10 ADA | --- | 0% | --- | | | SOL | SOL | SOL | 2 | 0% | 0.02 SOL | --- | 0% | --- | | | BNB | BEP20 | BNBBEP20 | 15 | 0% | 0.0025 BNB | --- | 0% | --- | | | DASH | DASH | DASH | 7 | 0% | 0.04 DASH | --- | 0% | --- | | | DOGE | DOGE | DOGE | 12 | 0% | 50 DOGE | --- | 0% | --- | | | DOGS | TON | DOGS | 1 | 0% | 10000 DOGS | --- | 0% | --- | | | XMR | XMR | XMR | 32 | 0.1% | 0.01 XMR | --- | 0% | --- | | | ZEC | ZEC | ZEC | 40 | 0.0% | 0.01 ZEC | --- | 0% | --- | | | AAVE | ERC20 | AAVE | 12 | 0% | 0.05 AAVE | --- | 0% | --- | | | AVAX | CCHAIN | AVAX | 32 | 0% | 0.15 AVAX | --- | 0% | --- | | | CHR | ERC20 | CHR | 12 | 0% | 25 CHR | --- | 0% | --- | | | NEAR | NEAR | NEAR | 5 | 0% | 0.25 NEAR | --- | 0% | --- | | | TRX | TRC20 | TRX | 3 | 0% | 20 TRX | --- | 0% | --- | | | 1INCH | ERC20 | 1INCH | 12 | 0% | 50 1INCH | --- | 0% | --- | | | GRAM | TON | GRAM | 1 | 0% | 2 GRAM | --- | 0% | --- | | | NOT | TON | NOT | 1 | 0% | 1200 NOT | --- | 0% | --- | | | TUSD | TRC20 | TUSDTRC20 | 3 | 0% | 5 TUSD | --- | 0% | --- | | | TUSD | ERC20 | TUSDERC20 | 12 | 0% | 6 TUSD | --- | 0% | --- | | | INJ | INJECTIVE | INJ | 2 | 0% | 0.18 INJ | --- | 0% | --- | | | XRP | XRP | XRP | 12 | 0% | 15 XRP | --- | 0% | --- | | | ANKR | ERC20 | ANKR | 12 | 0% | 150 ANKR | --- | 0% | --- | | | ANKR | BEP20 | ANKRBEP20 | 15 | 0% | 150 ANKR | --- | 0% | --- | | | APE | ERC20 | APE | 12 | 0% | 12 APE | --- | 0% | --- | | | AXS | ERC20 | AXS | 12 | 0% | 0.88 AXS | --- | 0% | --- | | | BAND | ERC20 | BAND | 12 | 0% | 4 BAND | --- | 0% | --- | | | BAT | ERC20 | BAT | 12 | 0% | 25 BAT | --- | 0% | --- | | | BCH | BCH | BCH | 3 | 0% | 0.004 BCH | --- | 0% | --- | | | BTT | TRC20 | BTT | 3 | 0% | 4299965 BTT | --- | 0% | --- | | | COMP | ERC20 | COMP | 12 | 0% | 0.0918 COMP | --- | 0% | --- | | | CRV | ERC20 | CRV | 12 | 0% | 5.5 CRV | --- | 0% | --- | | | ENS | ERC20 | ENS | 12 | 0% | 0.14 ENS | --- | 0% | --- | | | FIL | FIL | FIL | 60 | 0% | 1.1 FIL | --- | 0% | --- | | | GALA | ERC20 | GALA | 12 | 0% | 180 GALA | --- | 0% | --- | | | GRT | ERC20 | GRT | 12 | 0% | 23 GRT | --- | 0% | --- | | | LINK | ERC20 | LINK | 12 | 0% | 0.1 LINK | --- | 0% | --- | | | LTC | LTC | LTC | 12 | 0% | 0.2 LTC | --- | 0% | --- | | | MANA | ERC20 | MANA | 12 | 0% | 10 MANA | --- | 0% | --- | | | SAND | ERC20 | SAND | 12 | 0% | 24 SAND | --- | 0% | --- | | | SHIB | ERC20 | SHIBERC20 | 12 | 0% | 640000 SHIB | --- | 0% | --- | | | SNX | ERC20 | SNX | 12 | 0% | 3 SNX | --- | 0% | --- | | | SUSHI | ERC20 | SUSHI | 12 | 0% | 3.35 SUSHI | --- | 0% | --- | | | UNI | ERC20 | UNI | 12 | 0% | 1 UNI | --- | 0% | --- | | | XLM | STELLAR | XLM | 1 | 0% | 4 XLM | --- | 0% | --- | | | XTZ | XTZ | XTZ | 35 | 0% | 5 XTZ | --- | 0% | --- | | | YFI | ERC20 | YFI | 12 | 0% | 0.0006 YFI | --- | 0% | --- | | | ZRX | ERC20 | ZRX | 12 | 0% | 10 ZRX | --- | 0% | --- | | | AGLD | ERC20 | AGLD | 12 | 0% | 10 AGLD | --- | 0% | --- | | | IMX | ERC20 | IMX | 12 | 0% | 4 IMX | --- | 0% | --- | | | OP | OPTIMISM | OPOPTIMISM | 100 | 0% | 2.17 OP | --- | 0% | --- | | | PEOPLE | ERC20 | PEOPLE | 12 | 0% | 140 PEOPLE | --- | 0% | --- | | | AMP | ERC20 | AMP | 12 | 0% | 1112 AMP | --- | 0% | --- | | | DODO | ERC20 | DODO | 12 | 0% | 41.73 DODO | --- | 0% | --- | | | AUDIO | ERC20 | AUDIO | 12 | 0% | 36 AUDIO | --- | 0% | --- | | | CAKE | BEP20 | CAKE | 15 | 0% | 0.02 CAKE | --- | 0% | --- | | | LDO | ERC20 | LDO | 12 | 0% | 4 LDO | --- | 0% | --- | | | THETA | THETA | THETA | 12 | 0% | 2.3 THETA | --- | 0% | --- | | | ARB | ARBITRUM | ARB | 120 | 0% | 8 ARB | --- | 0% | --- | | | SUI | SUI | SUI | 1 | 0% | 0.5 SUI | --- | 0% | --- | | | PEPE | ERC20 | PEPE | 12 | 0% | 292000 PEPE | --- | 0% | --- | | | FLOKI | ERC20 | FLOKI | 12 | 0% | 19290 FLOKI | --- | 0% | --- | | | XAUT | ERC20 | XAUT | 12 | 0% | 0.001 XAUT | --- | 0% | --- | | | PENDLE | ERC20 | PENDLE | 12 | 0% | 1.25 PENDLE | --- | 0% | --- | | | JTO | SOL | JTO | 2 | 0% | 1.43 JTO | --- | 0% | --- | | | BONK | SOL | BONK | 2 | 0% | 11000 BONK | --- | 0% | --- | | | JUP | SOL | JUP | 2 | 0% | 4.8 JUP | --- | 0% | --- | | | XAI | ARBITRUM | XAI | 120 | 0% | 6.5 XAI | --- | 0% | --- | | | PYTH | SOL | PYTH | 2 | 0% | 9.5 PYTH | --- | 0% | --- | | | QNT | ERC20 | QNT | 12 | 0% | 0.066 QNT | --- | 0% | --- | | | MEME | ERC20 | MEME | 12 | 0% | 360 MEME | --- | 0% | --- | | | STRK | ERC20 | STRKERC20 | 12 | 0% | 10 STRK | --- | 0% | --- | | | SKY | ERC20 | SKY | 12 | 0% | 131.11 SKY | --- | 0% | --- | | | WIF | SOL | WIF | 2 | 0% | 2.4 WIF | --- | 0% | --- | | | ETHFI | ERC20 | ETHFI | 12 | 0% | 3.28 ETHFI | --- | 0% | --- | | | BOME | SOL | BOME | 2 | 0% | 533 BOME | --- | 0% | --- | | | ENA | ERC20 | ENA | 12 | 0% | 9.5 ENA | --- | 0% | --- | | | GMX | ARBITRUM | GMX | 120 | 0% | 0.15 GMX | --- | 0% | --- | | | ZRO | ERC20 | ZRO | 12 | 0% | 1 ZRO | --- | 0% | --- | | | TAO | TAO | TAO | 2 | 0% | 0.015 TAO | --- | 0% | --- | | | RENDER | SOL | RENDER | 2 | 0% | 1 RENDER | --- | 0% | --- | | | BEAM | ERC20 | BEAM | 12 | 0% | 235 BEAM | --- | 0% | --- | | | BANANA | ERC20 | BANANA | 12 | 0% | 0.0731 BANANA | --- | 0% | --- | | | RPL | ERC20 | RPL | 12 | 0% | 0.5 RPL | --- | 0% | --- | | | NEIRO | ERC20 | NEIRO | 12 | 0% | 8510 NEIRO | --- | 0% | --- | | | ORCA | SOL | ORCA | 2 | 0% | 1.3 ORCA | --- | 0% | --- | | | TRUMP | SOL | TRUMP | 2 | 0% | 0.25 TRUMP | --- | 0% | --- | | | PENGU | SOL | PENGU | 2 | 0% | 1465 PENGU | --- | 0% | --- | | | PROVE | ERC20 | PROVE | 12 | 0% | 9.9 PROVE | --- | 0% | --- | | | PUMP | SOL | PUMP | 2 | 0% | 2000 PUMP | --- | 0% | --- | | | AVNT | BASE | AVNT | 100 | 0% | 4.9 AVNT | --- | 0% | --- | | | CVX | ERC20 | CVX | 12 | 0% | 2.94 CVX | --- | 0% | --- | | | CYBER | BEP20 | CYBER | 15 | 0% | 1.41 CYBER | --- | 0% | --- | | | CAT | BEP20 | CAT | 15 | 0% | 360000 CAT | --- | 0% | --- | | | DOT | DOTASSETHUB | DOT | --- | 0% | 0.6 DOT | --- | 0% | --- | | | OPEN | ERC20 | OPEN | 12 | 0% | 11 OPEN | --- | 0% | --- | | | USD1 | BEP20 | USD1 | 15 | 0% | 5 USD1 | --- | 0% | --- | | | POL | POLYGON | POL | 200 | 0% | 5 POL | --- | 0% | --- | | | FF | ERC20 | FF | 12 | 0% | 51 FF | --- | 0% | --- | | | BERT | SOL | BERT | 2 | 0% | 322 BERT | --- | 0% | --- | | | DOP2 | ERC20 | DOP2 | 12 | 0% | 628 DOP2 | --- | 0% | --- | | | KITE | ERC20 | KITE | 12 | 0% | 151 KITE | --- | 0% | --- | | | MORPHO | ERC20 | MORPHO | 12 | 0% | 6 MORPHO | --- | 0% | --- | | | ZBT | BEP20 | ZBT | 15 | 0% | 37.5 ZBT | --- | 0% | --- | | | ALGO | ALGORAND | ALGO | --- | 0% | 100 ALGO | --- | 0% | --- | | | ATOM | ATOM | ATOM | --- | 0% | 1 ATOM | --- | 0% | --- | | | AGIX | ERC20 | AGIX | 12 | 0% | 32 AGIX | --- | 0% | --- | | | DAI | ERC20 | DAI | 12 | 0% | --- | --- | 0% | --- | | | CHZ | ERC20 | CHZ | 12 | 0% | 68.5 CHZ | --- | 0% | --- | | # List out Source: https://docs.crypto-cash.world/crypto-currencies/list-out # Крипто валюты ## Список валют на вывод (Pay-out) > [!NOTE] > > Не нашли интересующую вас монету? Напишите нам на [info@crypto-cash.world](mailto:info@crypto-cash.world) - и мы добавим её в список. | Currency | Network | Network Fee | Min | Max | Exchange | Memo | | | | | | - | - | - | - | - | - | - | - | - | - | - | | USDT | TRC20 | 1.5 USDT | 5 USDT | --- | 0% | --- | | | | | | USDT | ERC20 | 1.7 USDT | 10 USDT | --- | 0% | --- | | | | | | USDT | BEP20 | 1 USDT | 10 USDT | --- | 0% | --- | | | | | | USDT | POLYGON | 0.8 USDT | 5 USDT | --- | 0% | --- | | | | | | USDT | ARBITRUM | 1 USDT | 5 USDT | --- | 0% | --- | | | | | | USDT | CCHAIN | 1 USDT | 5 USDT | --- | 0% | --- | | | | | | USDT | NEAR | 0.5 USDT | 5 USDT | --- | 0% | --- | | | | | | USDT | SOL | 1 USDT | 5 USDT | --- | 0% | --- | | | | | | USDT | TON | 0.5 USDT | 5 USDT | --- | 0% | --- | | | | | | USDT | OPTIMISM | 1 USDT | 10 USDT | --- | 0% | --- | | | | | | BTC | BTC | 0.000045 BTC | 0.00018 BTC | --- | 0% | --- | | | | | | BTC | BEP20 | 0.000004 BTC | 0.0003 BTC | --- | 0% | --- | | | | | | ETH | ERC20 | 0.0002 ETH | 0.004 ETH | --- | 0% | --- | | | | | | ETH | ARBITRUM | 0.0002 ETH | 0.02 ETH | --- | 0% | --- | | | | | | ETH | BASE | 0.0001 ETH | 0.004 ETH | --- | 0% | --- | | | | | | ETH | BEP20 | 0.00024 ETH | 0.004 ETH | --- | 0% | --- | | | | | | ETH | OPTIMISM | 0.0002 ETH | 0.004 ETH | --- | 0% | --- | | | | | | ETC | ETC | 0.04 ETC | 0.08 ETC | --- | 0% | --- | | | | | | USDC | ERC20 | 2 USDC | 10 USDC | --- | 0% | --- | | | | | | USDC | BASE | 0.5 USDC | 10 USDC | --- | 0% | --- | | | | | | USDC | CCHAIN | 1 USDC | 10 USDC | --- | 0% | --- | | | | | | USDC | NEAR | 0.5 USDC | 10 USDC | --- | 0% | --- | | | | | | USDC | SOL | 1 USDC | 10 USDC | --- | 0% | --- | | | | | | USDC | STELLAR | 1 USDC | 10 USDC | --- | 0% | Optional | | | | | | USDC | ARBITRUM | 1 USDC | 10 USDC | --- | 0% | --- | | | | | | USDC | OPTIMISM | 1 USDC | 10 USDC | --- | 0% | --- | | | | | | USDC | POLYGON | 0.21 USDC | 10 USDC | --- | 0% | --- | | | | | | USDC | BEP20 | 1 USDC | 10 USDC | --- | 0% | --- | | | | | | USDC | SUI | 0.5 USDC | 10 USDC | --- | 0% | --- | | | | | | USDS | ERC20 | 1.3 USDS | 10 USDS | --- | 0% | --- | | | | | | ADA | ADA | 2.5 ADA | 10 ADA | --- | 0% | --- | | | | | | SOL | SOL | 0.003 SOL | 0.02 SOL | --- | 0% | --- | | | | | | BNB | BEP20 | 0.000953 BNB | 0.0025 BNB | --- | 0% | --- | | | | | | DOGE | DOGE | 2.5 DOGE | 100 DOGE | --- | 0% | --- | | | | | | DOGS | TON | 10000 DOGS | 20000 DOGS | --- | 0% | --- | | | | | | DASH | DASH | 0.03 DASH | 0.06 DASH | --- | 0% | --- | | | | | | XMR | XMR | 0.00085 XMR | 0.02 XMR | --- | 0% | --- | | | | | | ZEC | ZEC | 0.005 ZEC | 0.01 ZEC | --- | 0% | --- | | | | | | AAVE | ERC20 | 0.025 AAVE | 0.05 AAVE | --- | 0% | --- | | | | | | AVAX | CCHAIN | 0.05 AVAX | --- | --- | 0% | --- | | | | | | CHR | ERC20 | 44.49 CHR | 88.98 CHR | --- | 0% | --- | | | | | | NEAR | NEAR | 0.23 NEAR | 0.5 NEAR | --- | 0% | --- | | | | | | TRX | TRC20 | 1 + Amount × 0.25% | 20 TRX | --- | 0% | --- | | | | | | GRAM | TON | 0.4 GRAM | 2 GRAM | --- | 0% | --- | | | | | | NOT | TON | 700 NOT | 1400 NOT | --- | 0% | --- | | | | | | 1INCH | ERC20 | 22 1INCH | 50 1INCH | --- | 0% | --- | | | | | | TUSD | TRC20 | 1.8 TUSD | --- | --- | 0% | --- | | | | | | TUSD | ERC20 | --- | --- | --- | 0% | --- | | | | | | INJ | INJECTIVE | --- | --- | --- | 0% | --- | | | | | | XRP | XRP | 0.3 XRP | 15 XRP | --- | 0% | Optional | | | | | | ANKR | ERC20 | 73.2 ANKR | 530 ANKR | --- | 0% | --- | | | | | | ANKR | BEP20 | 21.7 ANKR | 260 ANKR | --- | 0% | --- | | | | | | APE | ERC20 | 6 APE | 12 APE | --- | 0% | --- | | | | | | AXS | ERC20 | 1 AXS | 2 AXS | --- | 0% | --- | | | | | | BAND | ERC20 | 0.62 BAND | 1.24 BAND | --- | 0% | --- | | | | | | BAT | ERC20 | 4.15 BAT | 8.3 BAT | --- | 0% | --- | | | | | | BCH | BCH | 0.0018 BCH | 0.004 BCH | --- | 0% | --- | | | | | | BTT | TRC20 | 3000000 BTT | 8599931 BTT | --- | 0% | --- | | | | | | CHZ | ERC20 | Dynamic | --- | --- | 0% | --- | | | | | | COMP | ERC20 | 0.0239 COMP | 0.0478 COMP | --- | 0% | --- | | | | | | CRV | ERC20 | 1.59 CRV | 3.18 CRV | --- | 0% | --- | | | | | | ENS | ERC20 | 0.193 ENS | 0.386 ENS | --- | 0% | --- | | | | | | FIL | FIL | 0.0009 FIL | 2.22 FIL | --- | 0% | --- | | | | | | GALA | ERC20 | 69.8 GALA | --- | --- | 0% | --- | | | | | | GRT | ERC20 | 14.87 GRT | 29.7 GRT | --- | 0% | --- | | | | | | LINK | ERC20 | 0.32 LINK | 0.64 LINK | --- | 0% | --- | | | | | | LTC | LTC | 0.003 LTC | 0.2 LTC | --- | 0% | --- | | | | | | MANA | ERC20 | 3.18 MANA | 6.36 MANA | --- | 0% | --- | | | | | | SAND | ERC20 | 18 SAND | 36 SAND | --- | 0% | --- | | | | | | SHIB | ERC20 | 420000 SHIB | 840000 SHIB | --- | 0% | --- | | | | | | SNX | ERC20 | 2.8 SNX | 5.6 SNX | --- | 0% | --- | | | | | | SUSHI | ERC20 | 1.502 SUSHI | 15 SUSHI | --- | 0% | --- | | | | | | UNI | ERC20 | 0.8 UNI | 2 UNI | --- | 0% | --- | | | | | | XLM | STELLAR | 2.21 XLM | 5 XLM | --- | 0% | Optional | | | | | | XTZ | XTZ | 0.1 XTZ | 10 XTZ | --- | 0% | --- | | | | | | YFI | ERC20 | 0.000013 YFI | 0.000026 YFI | --- | 0% | --- | | | | | | ZRX | ERC20 | 5.56 ZRX | 11.12 ZRX | --- | 0% | --- | | | | | | AGLD | ERC20 | 5 AGLD | 15 AGLD | --- | 0% | --- | | | | | | IMX | ERC20 | 3.335 IMX | --- | --- | 0% | --- | | | | | | OP | OPTIMISM | 0.195 OP | 4.35 OP | --- | 0% | --- | | | | | | PEOPLE | ERC20 | 84 PEOPLE | 168 PEOPLE | --- | 0% | --- | | | | | | AMP | ERC20 | 392.4 AMP | 784 AMP | --- | 0% | --- | | | | | | DODO | ERC20 | 17.23 DODO | 34.46 DODO | --- | 0% | --- | | | | | | AUDIO | ERC20 | Dynamic | 80.08 AUDIO | --- | 0% | --- | | | | | | CAKE | BEP20 | 0.41 CAKE | 0.9 CAKE | --- | 0% | --- | | | | | | LDO | ERC20 | 1.67 LDO | 3.34 LDO | --- | 0% | --- | | | | | | THETA | THETA | 0.13 THETA | 4.6 THETA | --- | 0% | --- | | | | | | ARB | ARBITRUM | 4 ARB | 8 ARB | --- | 0% | --- | | | | | | SUI | SUI | 0.5 SUI | 1 SUI | --- | 0% | --- | | | | | | PEPE | ERC20 | 86246 PEPE | 172492 PEPE | --- | 0% | --- | | | | | | FLOKI | ERC20 | 13973 FLOKI | 27946 FLOKI | --- | 0% | --- | | | | | | XAUT | ERC20 | --- | --- | --- | 0% | --- | | | | | | PENDLE | ERC20 | 0.339 PENDLE | 0.678 PENDLE | --- | 0% | --- | | | | | | JTO | SOL | 2.1 JTO | 2.87 JTO | --- | 0% | --- | | | | | | BONK | SOL | 240000 BONK | 480000 BONK | --- | 0% | --- | | | | | | JUP | SOL | 3.2 JUP | 10 JUP | --- | 0% | --- | | | | | | XAI | ARBITRUM | 26.4 XAI | 13 XAI | --- | 0% | --- | | | | | | PYTH | SOL | 11.62 PYTH | 20 PYTH | --- | 0% | --- | | | | | | QNT | ERC20 | 0.0023 QNT | 0.004 QNT | --- | 0% | --- | | | | | | STRK | ERC20 | Dynamic | --- | --- | 0% | --- | | | | | | WIF | SOL | 4.48 WIF | --- | --- | 0% | --- | | | | | | ETHFI | ERC20 | 0.74 ETHFI | 1.48 ETHFI | --- | 0% | --- | | | | | | BOME | SOL | 1175 BOME | 1066 BOME | --- | 0% | --- | | | | | | ENA | ERC20 | 3.06 ENA | 6.12 ENA | --- | 0% | --- | | | | | | GMX | ARBITRUM | 0.035 GMX | 0.35 GMX | --- | 0% | --- | | | | | | ZRO | ERC20 | 0.613 ZRO | 1.226 ZRO | --- | 0% | --- | | | | | | TAO | TAO | 0.0009 TAO | 0.03 TAO | --- | 0% | --- | | | | | | RENDER | SOL | 0.473 RENDER | 2 RENDER | --- | 0% | --- | | | | | | BEAM | ERC20 | Dynamic | 226.06 BEAM | --- | 0% | --- | | | | | | BANANA | ERC20 | 0.0674 BANANA | 0.1348 BANANA | --- | 0% | --- | | | | | | RPL | ERC20 | 0.158 RPL | 0.316 RPL | --- | 0% | --- | | | | | | NEIRO | ERC20 | Dynamic | 29652 NEIRO | --- | 0% | --- | | | | | | ORCA | SOL | 0.61 ORCA | 2.6 ORCA | --- | 0% | --- | | | | | | TRUMP | SOL | 0.4 TRUMP | 0.5 TRUMP | --- | 0% | --- | | | | | | PENGU | SOL | 114 PENGU | 2195 PENGU | --- | 0% | --- | | | | | | PUMP | SOL | 182 PUMP | 3000 PUMP | --- | 0% | --- | | | | | | AVNT | BASE | 1.16 AVNT | 7.4 AVNT | --- | 0% | --- | | | | | | BERT | SOL | 54 BERT | 483 BERT | --- | 0% | --- | | | | | | CAT | BEP20 | 180000 CAT | 360000 CAT | --- | 0% | --- | | | | | | CVX | ERC20 | 0.481 CVX | 4.4 CVX | --- | 0% | --- | | | | | | CYBER | BEP20 | 1.17 CYBER | 3.51 CYBER | --- | 0% | --- | | | | | | DOP2 | ERC20 | 314 DOP2 | 942 DOP2 | --- | 0% | --- | | | | | | DOT | DOTASSETHUB | 0.4 DOT | 0.8 DOT | --- | 0% | --- | | | | | | FF | ERC20 | 7.17 FF | 76.7 FF | --- | 0% | --- | | | | | | KITE | ERC20 | 5.101 KITE | 226 KITE | --- | 0% | --- | | | | | | MORPHO | ERC20 | 0.51 MORPHO | 9 MORPHO | --- | 0% | --- | | | | | | MEME | ERC20 | 1552.74 MEME | 3105 MEME | --- | 0% | --- | | | | | | OPEN | ERC20 | 2.69 OPEN | 16 OPEN | --- | 0% | --- | | | | | | PROVE | ERC20 | 2.63 PROVE | 14.8 PROVE | --- | 0% | --- | | | | | | SKY | ERC20 | 13.63 SKY | 196.87 SKY | --- | 0% | --- | | | | | | USD1 | BEP20 | 0.3 USD1 | --- | --- | 0% | --- | | | | | | ZBT | BEP20 | 3 ZBT | 56.3 ZBT | --- | 0% | --- | | | | | | POL | POLYGON | 3 POL | 6 POL | --- | 0% | --- | | | | | | ALGO | ALGORAND | 3.09 ALGO | 100 ALGO | --- | 0% | --- | | | | | | AGIX | ERC20 | --- | --- | --- | 0% | --- | | | | | | DAI | ERC20 | --- | --- | --- | 0% | --- | | | | | | ATOM | ATOM | 0.35 ATOM | 1 ATOM | --- | 0% | --- | | | | | # Список валют Source: https://docs.crypto-cash.world/fiat-out-1 | Currency | Payment Method | Min Amount | Max Amount | Payment Time | | - | - | - | - | - | | EUR | Skrill | 500 EUR | --- | \< 60m | | EUR | Paysera | 1000 EUR | --- | \< 60m | | EUR | SEPA | 1000 EUR | --- | \< 60m | | EUR | Monobank | 600 EUR | --- | \< 60m | | EUR | Visa/MasterCard | 800 EUR | --- | \< 60m | | EUR | Bank transfer | 1000 EUR | --- | \< 60m | | EUR | Revolut | 1000 EUR | --- | \< 60m | | EUR | Wise | 1000 EUR | --- | \< 60m | | EUR | Privat24 | 600 EUR | --- | \< 60m | | EUR | Neteller | 500 EUR | --- | \< 60m | | USD | Zelle | 500 USD | --- | \< 60m | | USD | Monobank | 500 USD | --- | \< 60m | | USD | Revolut | 1000 USD | --- | \< 60m | | USD | Wise | 500 USD | --- | \< 60m | | USD | Neteller | 500 USD | --- | \< 60m | | USD | Skrill | 500 USD | --- | \< 60m | | USD | Privat24 | 500 USD | --- | \< 60m | | USD | Visa/MasterCard | 500 USD | --- | \< 60m | | GBP | Revolut | 750 GBP | --- | \< 60m | | GBP | Wise | 1000 GBP | --- | \< 60m | | GBP | Bank transfer | 1000 GBP | --- | \< 60m | | GEL | Visa/MasterCard | 1330 GEL | --- | \< 60m | | GEL | Credo/Liberty | 650 GEL | --- | \< 60m | | GEL | Bank transfer | 1500 GEL | --- | \< 60m | | KZT | Visa/MasterCard | 400005 KZT | --- | \< 60m | | KZT | Kaspi Bank | 300000 KZT | --- | \< 60m | | KZT | Forte Bank | 400005 KZT | --- | \< 60m | | KZT | Freedom Bank | 400005 KZT | --- | \< 60m | | KZT | Jusan Bank | 400005 KZT | --- | \< 60m | | KZT | Eurasian Bank | 400005 KZT | --- | \< 60m | | KZT | CenterCredit | 400005 KZT | --- | \< 60m | | KZT | Bereke Bank | 400000 KZT | --- | \< 60m | | UZS | Visa/MasterCard | 6090000 UZS | --- | \< 60m | | UZS | UzCard | 6080000 UZS | --- | \< 60m | | UZS | HUMO | 6100000 UZS | --- | \< 60m | | PLN | BLIK | 1000 PLN | --- | \< 60m | | PLN | Bank transfer | 1000 PLN | --- | \< 60m | | UAH | UkrSibbank | 400 UAH | --- | 3h | | UAH | Sense Bank | 400 UAH | --- | 3h | | UAH | Raiffeisen | 400 UAH | --- | 3h | | UAH | PUMB | 400 UAH | --- | 3h | | UAH | OTP Bank | 400 UAH | --- | 3h | | UAH | Oschadbank | 400 UAH | --- | 3h | | UAH | Izibank | 400 UAH | --- | 3h | | UAH | A-Bank | 400 UAH | --- | 3h | | UAH | Monobank | 400 UAH | --- | 3h | | UAH | Privat24 | 400 UAH | --- | 3h | | UAH | Bank transfer | 400 UAH | --- | 3h | | UAH | Visa/MasterCard | 400 UAH | --- | \< 60m | # Введение в Crypto-Cash API Source: https://docs.crypto-cash.world/index Crypto-Cash API предоставляет полный набор инструментов для интеграции криптовалютных платежей в ваш сервис. API поддерживает операции с созданием заявок на выплату, получения кошельков для пополнения, истории транзакций, балансом и другим. ## Начало работ Для того чтобы начать использовать CryptoCash API первым делом вам необходимо создать ваши Public & Secret keys в личном кабинете. > [card] [CryptoCash Dashboard](https://account.crypto-cash.world/login) > > Перейти в личный кабинет ## Быстрая навигация Основные разделы документации > [card] [Crypto API](/api-reference/balance) > > Основые запросы > [card] [Webhooks](/webhooks/types) > > Настройка и примеры вебхуков > [card] [Currencies list](/crypto-currencies/list-in) > > Список поддерживаемых криптовалют, лимиты и комиссии > [card] [Поддержка]() > > Связаться с менеджером в телеграмме # Для интеграторов Source: https://docs.crypto-cash.world/integratsiya Интеграция Off-Ramp: подпись запросов, справочники, создание фиатного вывода, статусы и исходящие webhook. # Off-Ramp — справочник API для интеграторов ## 1. Общие правила * Base URL предоставляется платформой. * Все endpoint-ы Off-Ramp принимают и возвращают `application/json`. * Все authenticated endpoint-ы используют метод **`POST`**, включая read-only операции вроде `rates` или `withdrawals/list`, потому что тело запроса должно содержать подписанный envelope. * Денежные числовые значения возвращаются как **строки**, чтобы сохранить точность decimal-значений, например `"25.18"` или `"39.7059"`. * Временные метки возвращаются как ISO-8601 UTC строки, например `"2026-05-04T10:00:00.000Z"`. *** ## 2. Аутентификация и подпись запросов Каждый authenticated request должен быть отправлен в виде **подписанного envelope**: ```json theme={null} { "data": "", "signature": "" } ``` `data` — это base64 от JSON payload. `signature` — это base64 криптографической подписи, рассчитанной по base64-строке `data`. Конкретный алгоритм зависит от типа API-ключа, см. раздел 2.3. ### 2.1. Обязательные headers | Header | Required | Описание | | - | - | - | | `Content-Type` | yes | Должен быть `application/json`. | | `x-public-key` | conditional | Public key мерчанта в **hex** формате. **Обязателен, если** public key не передан внутри подписанного payload. См. раздел 2.2. | | `X-Request-Id` | optional | UUID запроса, сгенерированный клиентом для correlation. Отображается в логах. | ### 2.2. Где передавать public key — в header или payload Сервер определяет public key в таком порядке: 1. HTTP header `x-public-key` без учета регистра. Если header присутствует, используется он, а тело запроса для public key не проверяется. 2. Если header отсутствует, используется поле `publicKey` из **декодированного JSON payload**, то есть внутри `data` после base64 decode. Если public key не найден ни в одном из мест, запрос отклоняется с HTTP `401 Missing public key`. Оба варианта допустимы. Выберите один вариант для каждого запроса. Рекомендуемый вариант — передавать public key в header: так signed payload содержит только бизнес-поля, а correlation в логах становится проще. **Header form (recommended):** ```http theme={null} POST /merchant/api/v1/express/rates Content-Type: application/json x-public-key: 5a3c...hex { "data": "", "signature": "" } ``` Decoded payload содержит только DTO-поля: ```json theme={null} { "amount": 100 } ``` **Payload form (header omitted):** ```http theme={null} POST /merchant/api/v1/express/rates Content-Type: application/json { "data": "", "signature": "" } ``` Decoded payload содержит поле `publicKey` вместе с DTO-полями: ```json theme={null} { "amount": 100, "publicKey": "5a3c...hex" } ``` Подпись рассчитывается по той же base64-строке, которую будет читать сервер. Поэтому `publicKey` должен быть добавлен в JSON до encoding и signing. Если добавить `publicKey` после подписания, verification не пройдет. ### 2.3. Типы ключей API key мерчанта имеет одно из двух значений `keyType`. Сервер выбирает алгоритм verification по merchant record, связанному с public key. Интегратор не передает key type явно. | Key type | Алгоритм | Crypto material у интегратора | | - | - | - | | `ED25519` | Ed25519, asymmetric | Private key в hex, public key в hex. Public key регистрируется на платформе. | | `LEGACY` | HMAC-style SHA-256 по `privateKey + base64Data` | Общий secret, который хранится как `privateKey` на обеих сторонах. | `ED25519` используется по умолчанию для новых ключей. `LEGACY` поддерживается для исторических интеграций. Эти два алгоритма дают разные подписи для одного и того же payload, поэтому используйте выбранный алгоритм последовательно. ### 2.4. Algorithm A — ED25519 (recommended) Шаги: 1. Соберите JSON payload с DTO-полями, см. endpoint sections ниже. 2. `json = JSON.stringify(payload)` 3. `data = base64(utf8_bytes(json))` 4. `signatureBytes = ed25519.sign(utf8_bytes(data), privateKeyBytes)` — входом является именно **base64 string**, а не исходный JSON и не raw bytes JSON. 5. `signature = base64(signatureBytes)` 6. Отправьте `POST { data, signature }` с header `x-public-key: `. **Node.js example (ED25519):** ```ts theme={null} import * as ed25519 from '@noble/ed25519'; async function signED25519(privateKeyHex: string, payload: Record) { const json = JSON.stringify(payload); const data = Buffer.from(json, 'utf8').toString('base64'); const signatureBytes = await ed25519.signAsync( Buffer.from(data, 'utf8'), Buffer.from(privateKeyHex, 'hex'), ); const signature = Buffer.from(signatureBytes).toString('base64'); return { data, signature }; } ``` ### 2.5. Algorithm B — LEGACY (SHA-256 with shared secret) Шаги: 1. Соберите JSON payload. 2. `data = base64(utf8_bytes(JSON.stringify(payload)))` 3. `hexDigest = sha256_hex(privateKey + data)` — string concatenation secret и base64 payload. 4. `signature = base64(utf8_bytes(hexDigest))` — base64-encode применяется к **строке** hex-символов, а не к raw 32-byte digest. 5. Отправьте `POST { data, signature }` с header `x-public-key: `. **Node.js example (LEGACY):** ```ts theme={null} import * as crypto from 'node:crypto'; function signLegacy(privateKey: string, payload: Record) { const json = JSON.stringify(payload); const data = Buffer.from(json, 'utf8').toString('base64'); const hexDigest = crypto.createHash('sha256').update(privateKey + data).digest('hex'); const signature = Buffer.from(hexDigest, 'utf8').toString('base64'); return { data, signature }; } ``` ### 2.6. API key permissions and IP allowlist API key, выпущенный в merchant portal, содержит список permissions. Off-Ramp использует один из них: * `POST /merchant/api/v1/express/withdrawals` требует включенный permission **Fiat Withdraw**. * Все остальные Off-Ramp endpoint-ы требуют только корректную подпись активным и не revoked ключом. Если для ключа настроен IP allowlist, запросы с любого другого IP address отклоняются. ### 2.7. Error codes Error responses используют числовое поле `code`. Наиболее важные коды для authentication и validation layer: | HTTP | `code` | Meaning | | - | - | - | | 400 | `2010` | Поле `data` отсутствует или не является валидным base64-encoded JSON. | | 400 | `2011` | Поле `signature` отсутствует. | | 400 | `1110` | Payload validation failed: поле отсутствует, имеет неверный тип или нарушает constraint из раздела 4. | | 401 | `2020` | Signature did not verify. Почти всегда это ошибка в signing code интегратора: неверное encoding input, неверный key или payload изменен после signing. | | 401 | `2021` | Public key blocked. Обратитесь в поддержку платформы. | | 401 | `2022` | Public key expired. Выпустите новый ключ в merchant portal. | | 401 | `2023` | Public key inactive: revoked или еще не activated. | | 403 | `4003` | На ключе отсутствует permission или source IP не входит в allowlist. | | 404 | `4004` | Resource not found, например неизвестный `transactionId` или `bankLinkCode`. | | 400 | `5001` | `rateId` не существует. | | 400 | `5002` | `rateId` больше не предлагается ни одним партнером. | | 400 | `5003` | `recipientData` не содержит required fields или содержит invalid values. | | 400 | `5004` | Баланса мерчанта недостаточно для покрытия `usdtTotal`. | | 404 | `5007` | Withdrawal transaction not found. | | 404 | `5008` | Bank link not found. | *** ## 3. Request / Response Envelope **Каждый response** от authenticated endpoint-ов возвращается в wrapper: ```json theme={null} { "code": 200, "data": { /* endpoint-specific payload */ } } ``` Non-`200` responses возвращают стандартный NestJS error envelope: ```json theme={null} { "statusCode": 400, "code": "VALIDATION_FAILED", "message": "fiatAmount must not be less than 0.01" } ``` *** ## 4. Endpoint Reference Все endpoint-ы ниже используют одинаковую authentication model: signed `{ data, signature }` envelope, header `x-public-key`, `Content-Type: application/json`. Только `POST /merchant/api/v1/express/withdrawals` дополнительно требует permission **Fiat Withdraw** и проверяется по API-key IP allowlist. ### 4.1. `POST /merchant/api/v1/express/rates` Возвращает лучшие доступные merchant-facing rates по bank link. **Decoded payload:** | Field | Type | Required | Notes | | - | - | - | - | | `amount` | number | no | Зарезервировано для будущего amount-aware rate selection. Можно не передавать. | **Response:** ```json theme={null} { "code": 200, "data": { "items": [ { "id": "5e2f...-rate-id", "bankLinkCode": "PRIVAT_UAH", "bankName": "PrivatBank", "fiatCurrencyCode": "UAH", "fiatCurrencyLogoUrl": "https://.../uah.png", "rate": "39.7059" } ] } } ``` `id` — это **`rateId`**, который нужно передать в `withdrawals` при создании order. `rate` — fiat amount за 1 USDT. Для заданного `fiatAmount` с мерчанта будет списано `fiatAmount / rate` USDT. Эта сумма возвращается как `usdtTotal` из `withdrawals`. ### 4.2. `POST /merchant/api/v1/express/banks` Возвращает список банков, поддерживаемых для указанной fiat currency. **Decoded payload:** | Field | Type | Required | Notes | | - | - | - | - | | `fiatCurrencyCode` | string | yes | Например `"UAH"`. | **Response:** ```json theme={null} { "code": 200, "data": { "items": [ { "code": "PRIVAT", "name": "PrivatBank", "logoUrl": "https://.../privat.png" } ] } } ``` ### 4.3. `POST /merchant/api/v1/express/currencies` Возвращает список fiat currencies, поддерживаемых указанным bank. **Decoded payload:** | Field | Type | Required | Notes | | - | - | - | - | | `bankCode` | string | yes | Например `"PRIVAT"`. | **Response:** ```json theme={null} { "code": 200, "data": { "items": [ { "code": "UAH", "name": "Ukrainian Hryvnia", "logoUrl": "https://.../uah.png" } ] } } ``` ### 4.4. `POST /merchant/api/v1/express/bank-link` Возвращает schema полей recipient-data, которые нужны для order по bank link. Используйте этот endpoint перед `withdrawals`, чтобы понять, какие поля, например card number или phone, нужно собрать у end-user. **Decoded payload:** | Field | Type | Required | Notes | | - | - | - | - | | `bankLinkCode` | string | yes | `bankLinkCode`, возвращенный endpoint-ом `rates`. | **Response:** ```json theme={null} { "code": 200, "data": { "fields": [ { "name": "card_number", "label": "Card number", "fieldType": "MASKED", "isRequired": true }, { "name": "phone", "label": "Phone", "fieldType": "TEXT", "isRequired": false } ] } } ``` `fieldType` может быть `TEXT`, `NUMBER` или `MASKED`. `name` каждого поля — это key, который интегратор должен использовать в `recipientData` при вызове `withdrawals`. ### 4.5. `POST /merchant/api/v1/express/withdrawals` Создает fiat withdrawal. Система блокирует USDT на балансе мерчанта и отправляет order P2P-партнеру. **Required permission:** Fiat Withdraw. Endpoint проверяется по API-key IP allowlist. **Decoded payload:** | Field | Type | Required | Validation | | - | - | - | - | | `fiatAmount` | number | yes | `>= 0.01`. | | `rateId` | string (UUID) | yes | `id`, возвращенный endpoint-ом `rates`. | | `recipientData` | `object` | yes | Keys должны совпадать с `name`, которые вернул `bank-link`. Не должен быть пустым. | | `externalId` | string | no | Идентификатор на стороне мерчанта. **Уникален в рамках мерчанта**: duplicate values вызывают ошибку. Полезен для idempotent retries. | **Example payload before signing:** ```json theme={null} { "fiatAmount": 1000, "rateId": "5e2f5b40-1234-4abc-9def-0123456789ab", "recipientData": { "card_number": "4111111111111111", "phone": "+380991234567" }, "externalId": "merchant-order-123" } ``` **Response:** ```json theme={null} { "code": 200, "data": { "transactionId": "f1a2b3c4-...-uuid", "fiatAmount": "1000", "fiatCurrencyCode": "UAH", "usdtTotal": "25.18", "exchangeRate": "39.7059", "status": "CREATED" } } ``` В этот момент баланс мерчанта изменяется: `available -= usdtTotal`, `locked += usdtTotal`. Funds are released only when transaction reaches `COMPLETED` (consumed) or `CANCELLED` (refunded). Полный balance flow описан в разделе 5. ### 4.6. `POST /merchant/api/v1/express/withdrawals/list` Paginated list Off-Ramp withdrawals мерчанта. **Decoded payload:** | Field | Type | Required | Notes | | - | - | - | - | | `status` | string | no | `CREATED`, `PROCESSING`, `COMPLETED`, `CANCELLED`, `FAILED`. | | `internalId` | string (UUID) | no | Off-Ramp transaction `id`. | | `externalId` | string | no | Merchant-supplied identifier. | | `page` | int | no | Default `1`. | | `pageSize` | int | no | Default `50`. | **Response:** ```json theme={null} { "code": 200, "data": { "items": [ /* array of withdrawal detail objects, see section 4.7 */ ], "pagination": { "page": 1, "pageSize": 50, "total": 137 } } } ``` ### 4.7. `POST /merchant/api/v1/express/withdrawals/detail` Детали одного withdrawal. **Decoded payload:** | Field | Type | Required | Notes | | - | - | - | - | | `transactionId` | string (UUID) | yes | `transactionId`, возвращенный endpoint-ом `withdrawals` или webhook payload. | **Response:** ```json theme={null} { "code": 200, "data": { "id": "express-tx-uuid", "transactionId": "main-tx-uuid", "status": "COMPLETED", "fiatAmount": "1000", "fiatCurrencyCode": "UAH", "bankName": "PrivatBank", "exchangeRate": "39.7059", "usdtTotal": "25.18", "externalId": "merchant-order-123", "createdAt": "2026-05-04T09:58:00.000Z", "completedAt": "2026-05-04T10:00:00.000Z" } } ``` *** ## 5. Withdrawal Status Lifecycle Merchant-visible status flow для Off-Ramp transaction: ```txt theme={null} CREATED ─┬──► PROCESSING ──► COMPLETED └──► CANCELLED ◄── PROCESSING (no eligible partners after retries) FAILED ◄── critical system error ``` | Status | Meaning | Balance impact | | - | - | - | | `CREATED` | Order отправлен partner-у; система ожидает acceptance. | `usdtTotal` locked. | | `PROCESSING` | Partner принял order; система ожидает payment confirmation. | Lock unchanged. | | `COMPLETED` | Partner отметил payout как paid; USDT списаны. | `locked -= usdtTotal`, создан ledger `OUT` entry. | | `CANCELLED` | Все partner attempts исчерпаны или order отменен admin-ом. | Full refund: `locked -= usdtTotal`, `available += usdtTotal`. | | `FAILED` | Critical/unrecoverable error. | Operational follow-up; balance reconciled manually or by replay. | `usdtTotal` и `exchangeRate`, возвращенные `withdrawals`, фиксируются при создании transaction и не меняются в течение всего lifecycle transaction. *** ## 6. Outbound Webhooks Платформа уведомляет мерчанта об изменениях статуса через HTTP `POST` на webhook URL, настроенный мерчантом. Delivery asynchronous и повторяется при failure. ### 6.1. Event types | Event | Trigger | | - | - | | `express::withdrawal.created` | Order создан и отправлен первому partner-у. | | `express::withdrawal.processing` | Partner принял order. | | `express::withdrawal.completed` | Partner подтвердил fiat payout; USDT consumed. | | `express::withdrawal.cancelled` | Все partner attempts исчерпаны или order отменен admin-ом; full refund applied. | | `express::withdrawal.failed` | Critical/unrecoverable error. | Events `express::order.*` и `express::partner.*` являются internal и **не доставляются** на merchant webhooks. ### 6.2. Webhook payload ```json theme={null} { "id": "delivery-uuid", "delivered_at": "2026-05-04T10:00:00.123Z", "event": { "event_type": "express::withdrawal.completed", "timestamp": "2026-05-04T10:00:00.000Z", "data": { "id": "express-tx-uuid", "transactionId": "main-tx-uuid", "externalId": "merchant-order-123", "type": "WITHDRAWAL", "status": "COMPLETED", "fiatAmount": "1000", "fiatCurrencyCode": "UAH", "exchangeRate": "39.7059", "usdtTotal": "25.18", "createdAt": "2026-05-04T09:58:00.000Z", "updatedAt": "2026-05-04T10:00:00.000Z" } }, "signature": "" } ``` ### 6.3. Verifying the webhook Signature covers payload object **без поля `signature`**, то есть `{ id, delivered_at, event }`, и создается тем же алгоритмом, что request signature для merchant key, см. раздел 2.3. Корректная verification implementation должна: 1. **Проверить replay protection.** Отклоняйте delivery, если `id` уже был обработан. Храните processed IDs в database; in-memory set будет потерян после restart. 2. **Проверить timestamp.** Отклоняйте delivery, если `Math.abs(now - delivered_at) > 16 minutes`. Окно 16 минут покрывает maximum delivery time с учетом retries. 3. **Recompute and compare signature** по `{ id, delivered_at, event }`. 4. **Сохранить `id`** только после успешного прохождения всех трех проверок. Handler должен быть **idempotent**: одна и та же delivery может прийти больше одного раза во время retries. **Verification (ED25519):** ```ts theme={null} import * as ed25519 from '@noble/ed25519'; interface WebhookPayload { id: string; delivered_at: string; event: { event_type: string; timestamp: string; data: unknown }; signature: string; } async function verifyWebhook( webhook: WebhookPayload, publicKeyHex: string, seenIds: Set, ): Promise { if (seenIds.has(webhook.id)) { throw new Error('Replay: webhook id already processed'); } const skewMs = Math.abs(Date.now() - new Date(webhook.delivered_at).getTime()); if (skewMs > 16 * 60 * 1000) { throw new Error('Webhook outside acceptable time window'); } const payload = { id: webhook.id, delivered_at: webhook.delivered_at, event: webhook.event }; const data = Buffer.from(JSON.stringify(payload), 'utf8').toString('base64'); const ok = await ed25519.verifyAsync( Buffer.from(webhook.signature, 'base64'), Buffer.from(data, 'utf8'), Buffer.from(publicKeyHex, 'hex'), ); if (!ok) { throw new Error('Invalid webhook signature'); } seenIds.add(webhook.id); } ``` **Verification (LEGACY):** ```ts theme={null} import * as crypto from 'node:crypto'; function verifyWebhookLegacy( webhook: WebhookPayload, privateKey: string, seenIds: Set, ): void { if (seenIds.has(webhook.id)) { throw new Error('Replay: webhook id already processed'); } const skewMs = Math.abs(Date.now() - new Date(webhook.delivered_at).getTime()); if (skewMs > 16 * 60 * 1000) { throw new Error('Webhook outside acceptable time window'); } const payload = { id: webhook.id, delivered_at: webhook.delivered_at, event: webhook.event }; const data = Buffer.from(JSON.stringify(payload), 'utf8').toString('base64'); const hexDigest = crypto.createHash('sha256').update(privateKey + data, 'utf8').digest('hex'); const expected = Buffer.from(hexDigest, 'utf8').toString('base64'); if (expected !== webhook.signature) { throw new Error('Invalid webhook signature'); } seenIds.add(webhook.id); } ``` # Быстрый старт Source: https://docs.crypto-cash.world/quickstart ## Аутентификация Все запросы к API требуют аутентификации через подпись запроса. Каждый запрос должен содержать: ```json theme={null} { { "data": "base64-encoded-json-string", "signature": "base64-encoded-signature" } } ``` *** ## Базовая структура запроса * **Метод:** POST * **Формат данных:** JSON * **Кодировка:** UTF-8 * **Подпись:** base64( ed25519\_sign( data, PRIVATE\_KEY ) ) *** ## Типы подписей ### ED25519 (Рекомендуемый) 1. Создать объект payload: `id, delivered_at, event` 2. JSON.stringify(payload) 3. Закодировать JSON-строку в Base64 4. Подписать с помощью ED25519 (ed25519.signAsync) 5. Закодировать подпись в Base64 ### Legacy (Устаревший) 1. Создать объект payload: `id, delivered_at, event` 2. JSON.stringify(payload) 3. Закодировать JSON-строку в Base64 4. SHA256 хеш (privateKey + data) 5. Закодировать хеш в Base64 > [!WARNING] > > **ВАЖНО:** При интеграции через CMS Exchanger используйте Legacy ключи *** ## Внешняя ссылка для получения курсов **URL:** `https://rates.crypto-cash.world/api/v1/market/rates/export/xml` **URL:** `https://rates.crypto-cash.world/api/v1/market/rates/export/json` *** ## Статусы транзакций в ответах API * Queued (Очередь – В очереди на обработку) * New (Новая - Заказ создан, ожидается депозит) * Waiting (Ожидание - Подтверждение в блокчейне) * Paid (Оплачено - Депозит соответствует ожидаемой сумме) * Underpaid (Недоплата - Депозит меньше ожидаемой суммы) * Overpaid (Переплата - Депозит превышает ожидаемую сумму) * Canceled (Отменена - Транзакция отменена / ошибка) * CurrencyMismatch (Несоответствие валют - Внесена неверная криптовалюта) * CanceledButPaid / Late paid (Отменен, но оплачен - Заказ просрочен/отклонён, но получен точный депозит) * CanceledButOverpaid / Late overpaid (Отмененный, но переплаченный - Заказ просрочен/отклонён, но получена переплата) * CanceledButUnderpaid / Late underpaid (Отменен, но недоплачен - Заказ просрочен/отклонён, но получена недоплата) * No credited (Сумма пополнения меньше минимальной суммы, средства не зачислены на баланс) *** ## Ошибки При возникновении ошибок в ответ будет возвращен список из кодов ошибок. Пример ответа с ошибкой: ```json theme={null} { "errors": [1000] } ``` #### Список ошибок: * 1000 - Неверный запрос * 2010 - Ошибка декодирования данных * 2011 - Ошибка декодирования подписи * 2020 - Неверная подпись * 3000 - Компания не найдена * 3001 - Заказ не найден * 3002 - Транзакция не найдена * 4003 - Аккаунт не активирован *** > [card] [Crypto API](/api-reference/balance) > > Основые запросы # Примеры ответов Source: https://docs.crypto-cash.world/webhooks/examples ## Withdrawal - примеры ответов #### **`withdrawal::created`** ```json theme={null} { "id": "7c3a9f48-b215-4e87-9d62-5b8c1f4a3e69", "event": { "data": { "id": "4d7e2c91-8f63-45b2-a9c4-1e6f8d3a5b27", "hash": "", "memo": null, "pair": "USDT/TON", "type": "Buy", "amount": null, "status": "Queued", "address": "UQBxR9_mP3gZkF2tHpLqWeAcVjN8YsTnDuI4XhMgK1CzPbVe", "dealFee": "0", "network": "TON", "currency": "TON", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-01-01T00:00:00.000Z", "usdtTotal": "107.369040", "externalId": "out_28475", "merchantId": "c6e2a8f4-7b35-49d1-a8f6-3e9c5b1d4f72", "completedAt": null, "cancelReason": null, "exchangeRate": "1.42", "expectedAmount": "75.612", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "75.482", "receivedCurrency": null, "actualConfirmations": 0, "requiredConfirmations": 0 }, "timestamp": "2026-01-01T00:00:00.000Z", "event_type": "withdrawal::created" }, "delivered_at": "2026-01-01T00:00:00.000Z" } ``` *** #### **`withdrawal::completed`** ```json theme={null} { "id": "1f6d9e34-8b27-4a51-c739-2e5b8d4a1f63", "event": { "data": { "id": "4d7e2c91-8f63-45b2-a9c4-1e6f8d3a5b27", "hash": "5b9d3a8e2c4f1b7d6a0e9c3f8b2d5a4e1c7f9b6d3a8e5c2f4b1d7a9e6c3f8b2d", "memo": null, "pair": "USDT/TON", "type": "Buy", "amount": "75.612", "status": "Paid", "address": "UQBxR9_mP3gZkF2tHpLqWeAcVjN8YsTnDuI4XhMgK1CzPbVe", "dealFee": "0", "network": "TON", "currency": "TON", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-01-01T00:00:00.000Z", "usdtTotal": "107.5094720", "externalId": "out_28475", "merchantId": "c6e2a8f4-7b35-49d1-a8f6-3e9c5b1d4f72", "completedAt": "2026-01-01T00:00:00.000Z", "cancelReason": null, "exchangeRate": "1.4218573421984762849", "expectedAmount": "75.612", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "75.482", "receivedCurrency": null, "actualConfirmations": 0, "requiredConfirmations": 0 }, "timestamp": "2026-01-01T00:00:00.000Z", "event_type": "withdrawal::completed" }, "delivered_at": "2026-01-01T00:00:00.000Z" } ``` *** #### **`withdrawal::canceled`** ```json theme={null} { "id": "6f2c8a93-4d71-49e5-b86f-3c1d7a9b5e84", "event": { "data": { "id": "8b4e1f72-3c95-4d68-a217-9e6c5f3b8d24", "hash": "", "memo": null, "pair": "USDT/USDC", "type": "Buy", "amount": null, "status": "Canceled", "address": "0x6cD92Fa3Ae84c712Bd5eF09c4A1eB73d8f25Ca0E", "dealFee": "0", "network": "ERC20", "currency": "USDC", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-01-01T00:00:00.000Z", "usdtTotal": "130.38879855", "externalId": "out_38715", "merchantId": "c6e2a8f4-7b35-49d1-a8f6-3e9c5b1d4f72", "completedAt": null, "cancelReason": "Withdrawal declined by provider", "exchangeRate": "0.99876523451687234562", "expectedAmount": "130.55", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "130.45", "receivedCurrency": null, "actualConfirmations": 0, "requiredConfirmations": 0 }, "timestamp": "2026-01-01T00:00:00.000Z", "event_type": "withdrawal::canceled" }, "delivered_at": "2026-01-01T00:00:00.000Z" } ``` *** ## Acquiring #### **`acquiring::created`** ```json theme={null} { "id": "a3f8c2d1-7b94-4e6a-9c25-1f8d3e7a2b59", "event": { "data": { "id": "e7d4b9a2-6f31-48c5-b8e9-2a5c7d4f1e83", "hash": "", "memo": null, "pair": "USDT/USDT", "type": "Sale", "amount": null, "status": "New", "address": "TXn8LqKpRsW3vZmHbYcJfDgEuQaNtPxZyC", "dealFee": null, "network": "TRC20", "currency": "USDT", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-01-01T00:00:00.000Z", "usdtTotal": null, "externalId": "in_48291", "merchantId": "b2c5e8f1-9d34-4a7b-8e62-1f4d9c3a7b65", "completedAt": null, "cancelReason": null, "exchangeRate": null, "expectedAmount": "315", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "315", "receivedCurrency": null, "actualConfirmations": 0, "requiredConfirmations": 0 }, "timestamp": "2026-01-01T00:00:00.000Z", "event_type": "acquiring::created" }, "delivered_at": "2026-01-01T00:00:00.000Z" } ``` *** #### **`acquiring::deposit_received`** ```json theme={null} { "id": "d9f4a7c3-2e85-4b16-9a78-3c1f8e5d2b47", "event": { "data": { "id": "e7d4b9a2-6f31-48c5-b8e9-2a5c7d4f1e83", "hash": "7b3e9c1d8a4f2e6b5c0d7a9f3e8b1c4d6a2f5e9c8b7d1a4f3e6c2b9d5a8f1e7c", "memo": null, "pair": "USDT/USDT", "type": "Sale", "amount": "315", "status": "Paid", "address": "TXn8LqKpRsW3vZmHbYcJfDgEuQaNtPxZyC", "dealFee": "0.62937", "network": "TRC20", "currency": "USDT", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-01-01T00:00:00.000Z", "usdtTotal": "314.37063", "externalId": "in_48291", "merchantId": "b2c5e8f1-9d34-4a7b-8e62-1f4d9c3a7b65", "completedAt": "2026-01-01T00:00:00.000Z", "cancelReason": null, "exchangeRate": "1", "expectedAmount": "315", "receivedAmount": "315", "receivedNetwork": "TRC20", "requestedAmount": "315", "receivedCurrency": "USDT", "actualConfirmations": 18, "requiredConfirmations": 20 }, "timestamp": "2026-01-01T00:00:00.000Z", "event_type": "acquiring::deposit_received" }, "delivered_at": "2026-01-01T00:00:00.000Z" } ``` *** #### **`acquiring::completed`** ```json theme={null} { "id": "f1c8b3e7-5a92-4d68-b04f-7e3c9a1d6b82", "event": { "data": { "id": "e7d4b9a2-6f31-48c5-b8e9-2a5c7d4f1e83", "hash": "7b3e9c1d8a4f2e6b5c0d7a9f3e8b1c4d6a2f5e9c8b7d1a4f3e6c2b9d5a8f1e7c", "memo": null, "pair": "USDT/USDT", "type": "Sale", "amount": "315", "status": "Paid", "address": "TXn8LqKpRsW3vZmHbYcJfDgEuQaNtPxZyC", "dealFee": "0.62937", "network": "TRC20", "currency": "USDT", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-01-01T00:00:00.000Z", "usdtTotal": "314.37063", "externalId": "in_48291", "merchantId": "b2c5e8f1-9d34-4a7b-8e62-1f4d9c3a7b65", "completedAt": "2026-01-01T00:00:00.000Z", "cancelReason": null, "exchangeRate": "1", "expectedAmount": "315", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "315", "receivedCurrency": null, "actualConfirmations": 18, "requiredConfirmations": 20 }, "timestamp": "2026-01-01T00:00:00.000Z", "event_type": "acquiring::completed" }, "delivered_at": "2026-01-01T00:00:00.000Z" } ``` *** #### **`acquiring::overpaid`** ```json theme={null} { "id": "8a4c2e91-6d75-43b8-b1f3-9e7c5a2d8b41", "event": { "data": { "id": "5f9b3d72-1a48-4e6c-9d83-7b2e4f1c8a95", "hash": "0x4e8d2b91c5a73f6e0d4b8a92c1f5e3d7b9a6c2f4e8d1b5a3c9f7e2b6d4a8c1f3", "memo": null, "pair": "USDC/USDT", "type": "Sale", "amount": "480.523", "status": "Overpaid", "address": "0x9bF3c4a17De258e619d3aB45cF8a702eC3b91d62", "dealFee": "0.5", "network": "ERC20", "currency": "USDC", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-01-01T00:00:00.000Z", "usdtTotal": "479.42825", "externalId": "in_29384", "merchantId": "c6e2a8f4-7b35-49d1-a8f6-3e9c5b1d4f72", "completedAt": "2026-01-01T00:00:00.000Z", "cancelReason": null, "exchangeRate": "0.99876234518902145673", "expectedAmount": "480", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "480", "receivedCurrency": null, "actualConfirmations": 30, "requiredConfirmations": 32 }, "timestamp": "2026-01-01T00:00:00.000Z", "event_type": "acquiring::overpaid" }, "delivered_at": "2026-01-01T00:00:00.000Z" } ``` *** #### **`acquiring::underpaid`** ```json theme={null} { "id": "3e7b5c84-9f21-46d8-a05c-b27f4d1e8a36", "event": { "data": { "id": "a1d9c5f3-8e47-42b6-9c14-5f8b3a7d2e91", "hash": "8d3e1c9a4f7b2e5c0d8a6f4b1e9c3d7a5b2f8e6c1d4a9f3b7e5c2d8a6f1b4e9c", "memo": null, "pair": "USDT/USDT", "type": "Sale", "amount": "249.84", "status": "Underpaid", "address": "TKp7XmRsNvLqB4yHfDjW2cUaPgZeQ8tYxM", "dealFee": "0.449712", "network": "TRC20", "currency": "USDT", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-01-01T00:00:00.000Z", "usdtTotal": "249.390288", "externalId": "in_72541", "merchantId": "f7b3d8c2-4a91-46e5-b9d7-2c8f5a1e4b63", "completedAt": "2026-01-01T00:00:00.000Z", "cancelReason": null, "exchangeRate": "1", "expectedAmount": "250", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "250", "receivedCurrency": null, "actualConfirmations": 20, "requiredConfirmations": 20 }, "timestamp": "2026-01-01T00:00:00.000Z", "event_type": "acquiring::underpaid" }, "delivered_at": "2026-01-01T00:00:00.000Z" } ``` *** #### **`acquiring::currency_mismatch`** ```json theme={null} { "id": "5b8e2d47-c963-41a8-9f25-7d4b3a6c1e89", "event": { "data": { "id": "9c4f7b21-3e85-4d62-a17b-8f5c2d9e6a34", "hash": "2a7c9e4b1d8f3a6c5e0b2d8f4a9c7e1b3d6f8a2c5e9b4d7f1a8c3e6b9d2f5a4c", "memo": null, "pair": "USDT/USDT", "type": "Sale", "amount": "15", "status": "CurrencyMismatch", "address": "TQz6BwYpHsLm9NfRgVcXdJa3UkP2tEbWyA", "dealFee": "0.5", "network": "TRC20", "currency": "USDT", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-01-01T00:00:00.000Z", "usdtTotal": "5.68", "externalId": "in_61294", "merchantId": "b2c5e8f1-9d34-4a7b-8e62-1f4d9c3a7b65", "completedAt": "2026-01-01T00:00:00.000Z", "cancelReason": null, "exchangeRate": "0.412", "expectedAmount": "845.32841", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "845.32841", "receivedCurrency": null, "actualConfirmations": 13, "requiredConfirmations": 20 }, "timestamp": "2026-01-01T00:00:00.000Z", "event_type": "acquiring::currency_mismatch" }, "delivered_at": "2026-01-01T00:00:00.000Z" } ``` *** #### **`acquiring::declined`** ```json theme={null} { "id": "31c38a04-425d-481a-b3f2-ba68dd6c4e73", "event": { "data": { "id": "8918870e-9797-4170-bcf0-ee88a0f576fc", "hash": "", "memo": null, "pair": "USDT/USDT", "type": "Sale", "amount": null, "status": "Declined", "address": "TUFkrw3C3Nah98iwe6SfZJNtK23kMTR1Rq", "dealFee": null, "network": "TRC20", "currency": "USDT", "createdAt": "2026-04-21T17:50:31.531Z", "updatedAt": "2026-04-22T06:00:00.288Z", "usdtTotal": null, "externalId": "in_136153", "merchantId": "40ad4b61-5987-4fe4-b8fd-65c2f4f4755f", "completedAt": null, "cancelReason": null, "exchangeRate": null, "expectedAmount": "149", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "149", "receivedCurrency": null, "actualConfirmations": 0, "requiredConfirmations": 0 }, "timestamp": "2026-04-22T06:00:00.422Z", "event_type": "acquiring::declined" }, "delivered_at": "2026-04-22T06:00:00.525Z" } ``` *** #### **`acquiring::canceled`** ```json theme={null} { "id": "31c38a04-425d-481a-b3f2-ba68dd6c4e73", "event": { "data": { "id": "8918870e-9797-4170-bcf0-ee88a0f576fc", "hash": "", "memo": null, "pair": "USDT/USDT", "type": "Sale", "amount": null, "status": "Canceled", "address": "TUFkrw3C3Nah98iwe6SfZJNtK23kMTR1Rq", "dealFee": null, "network": "TRC20", "currency": "USDT", "createdAt": "2026-04-21T17:50:31.531Z", "updatedAt": "2026-04-22T06:00:00.288Z", "usdtTotal": null, "externalId": "in_136153", "merchantId": "40ad4b61-5987-4fe4-b8fd-65c2f4f4755f", "completedAt": null, "cancelReason": null, "exchangeRate": null, "expectedAmount": "149", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "149", "receivedCurrency": null, "actualConfirmations": 0, "requiredConfirmations": 0 }, "timestamp": "2026-04-22T06:00:00.422Z", "event_type": "acquiring::canceled" }, "delivered_at": "2026-04-22T06:00:00.525Z" } ``` #### **`acquiring::aml_frozen`** ```json theme={null} { "id": "590fcf51-kvia-9aof-a137-aab4fd0951d7", "event": { "data": { "id": "06acd3ff-ldoa-s9vj-1jca-df1b37b79398", "hash": "5e5f85780e0a570bvhalx81nca04908ba5cf1cf5f25d1956a777f1b82537e3", "memo": null, "pair": "USDT/USDT", "type": "Sale", "amount": null, "status": "AmlFrozen", "address": "TJ55uBj6wAD8fka9xkxandihUx52pcqeW2k", "dealFee": null, "network": "TRC20", "currency": "USDT", "createdAt": "2026-04-21T17:50:31.531Z", "updatedAt": "2026-04-22T06:00:00.288Z", "usdtTotal": null, "externalId": "in_136153", "merchantId": "808fa0fe-9g1j-zkc9-a980-30f152040051", "completedAt": null, "cancelReason": null, "exchangeRate": null, "expectedAmount": "130", "receivedAmount": null, "receivedNetwork": null, "requestedAmount": "130", "receivedCurrency": null, "actualConfirmations": 7, "requiredConfirmations": 20 }, "timestamp": "2026-04-22T06:00:00.422Z", "event_type": "acquiring::aml_frozen" }, "delivered_at": "2026-04-22T06:00:00.525Z" } ``` # Алгоритм генерации подписи Source: https://docs.crypto-cash.world/webhooks/signature Подпись охватывает полный payload вебхука: `id, delivered_at, event`. Поддерживаются два алгоритма подписи в зависимости от keyType: ## ED25519 (Рекомендуемый) 1. Создать объект payload: `id, delivered_at, event` 2. JSON.stringify(payload) 3. Закодировать JSON-строку в Base64 4. Подписать с помощью ED25519 (ed25519.signAsync) 5. Закодировать подпись в Base64 ## Legacy (Устаревший) 1. Создать объект payload: `id, delivered_at, event` 2. JSON.stringify(payload) 3. Закодировать JSON-строку в Base64 4. SHA256 хеш (privateKey + data) 5. Закодировать хеш в Base64 ## Особенности безопасности: * Подпись охватывает все поля, включая id и delivered\_at * Уникальный id предотвращает атаки повторного воспроизведения (replay attacks) * Валидация временной метки предотвращает принятие устаревших вебхуков (окно 16 минут) * 16-минутное окно учитывает повторные попытки (немедленно + 5 мин + 10 мин) + сетевой буфер * ED25519 обеспечивает криптографическую подлинность ## Логика повторной попытки 1. Первая попытка: Немедленно 2. Вторая попытка: задержка в 300 секунд (5 минут) 3. Третья попытка: задержка в 600 секунд (10 минут) 4. Ошибка: задача удалена из очереди, логирована *** > [!WARNING] > > **ВАЖНО:** Всегда проверяйте webhooks, чтобы предотвратить подделку и повторные атаки. ## Полный алгоритм проверки ```typescript theme={null} import * as ed25519 from '@noble/ed25519'; interface WebhookPayload { id: string; delivered_at: string; event: { event_type: string; timestamp: string; data: any; }; signature: string; } async function verifyWebhook( webhook: WebhookPayload, publicKey: string, seenWebhookIds: Set ): Promise { // 1. Replay Protection: Check if webhook ID already processed if (seenWebhookIds.has(webhook.id)) { throw new Error('Replay attack detected: webhook ID already processed'); } // 2. Timestamp Validation: Reject webhooks older than 16 minutes or from future // Max delivery time: 15 min (immediate + 5min retry + 10min retry) + 1min network buffer const deliveredAt = new Date(webhook.delivered_at); const now = Date.now(); const timeDiff = Math.abs(now - deliveredAt.getTime()); if (timeDiff > 960000) { // 16 minutes throw new Error('Webhook timestamp outside acceptable window'); } // 3. Signature Verification: Verify signature covers entire payload const payload = { id: webhook.id, delivered_at: webhook.delivered_at, event: webhook.event }; // Reconstruct signed data (same as server) const json = JSON.stringify(payload); const data = Buffer.from(json, 'utf8').toString('base64'); // Decode signature and public key const signatureBytes = Buffer.from(webhook.signature, 'base64'); const publicKeyBytes = Buffer.from(publicKey, 'hex'); const dataBytes = Buffer.from(data, 'utf8'); // Verify with ED25519 const isValid = await ed25519.verifyAsync(signatureBytes, dataBytes, publicKeyBytes); if (!isValid) { throw new Error('Invalid signature: webhook authentication failed'); } // 4. Store webhook ID to prevent future replay seenWebhookIds.add(webhook.id); return true; } ``` *** ## Этапы проверки ED25519 1. Защита от повторного воспроизведения - Проверьте **`webhook.id`**, который не был замечен ранее 2. Проверка метки времени - проверка delivery\_at в течение 16 минут (максимальное время доставки + буфер) 3. Восстановление полезной нагрузки - `id, delivery_at, event` 4. Проверка подписи - ed25519.verifyAsync (signature, payload, publicKey) 5. Сохранить идентификатор веб-узла - сохранить для предотвращения повторного воспроизведения # Webhook Structure Source: https://docs.crypto-cash.world/webhooks/structure ## Структура Payload Каждое событие содержит объект `data` с данными о транзакции на момент события. Структура payload одинакова для всех типов событий, но значения полей различаются в зависимости от типа транзакции и этапа её жизненного цикла. ```json theme={null} { id: "uuid", // Идентификатор транзакции externalId: "string", // Внешний идентификатор type: "Buy" | "Sale", // "Buy" = вывод, "Sale" = пополнение status: "TransactionStatus", // Текущий статус // Валюта и пара pair: "string", // Торговая пара: "USDT/TRX" (вывод) или "BTC/USDT" (пополнение) currency: "string", // Целевая валюта network: "string", // Блокчейн-сеть: "TRC20", "ERC20", "Bitcoin" и т.д. // Суммы (см. раздел "Пояснение полей сумм" ниже) requestedAmount: "string", // Чистая сумма, которую получает пользователь (при выводе) или ожидает внести (при пополнении) expectedAmount: "string", // Общая сумма с комиссией сети (вывод) или то же, что requestedAmount (пополнение) amount: "string | null", // Кумулятивная фактическая сумма. null до обработки. usdtTotal: "string | null", // USDT зарезервированные с удержанием (вывод) или кумулятивная сумма зачисленных USDT (пополнение) exchangeRate: "string | null", // Предварительный курс при создании, фактический курс после конвертации dealFee: "string | null", // Комиссия, начисленная за транзакцию // Информация о полученном депозите (только для события `deposit_received` пополнения) receivedCurrency: "string | null", // Фактически полученная криптовалюта receivedNetwork: "string | null", // Сеть полученной криптовалюты receivedAmount: "string | null", // Фактическая сумма пополнения (НЕ кумулятивная) // Блокчейн address: "string", // Адрес назначения (вывода) или адрес депозита (пополнение) hash: "string | null", // Хеш блокчейн-транзакции, пустая строка до появления memo: "string | null", // Memo/tag для сетей, которые этого требуют (XRP, XLM и т.д.) // Метаданные merchantId: "uuid", // Идентификатор мерчанта cancelReason: "string | null", // Причина отмены (только для событий отмены/ошибки) createdAt: "ISO 8601", // Время создания транзакции updatedAt: "ISO 8601", // Время последнего обновления completedAt: "ISO 8601 | null" // Время завершения, null до финализации } ``` ### Пояснение полей сумм Есть четыре поля, связанных с суммами, и они имеют разное назначение в зависимости от типа транзакции. #### Вывод (Buy) | Поле | Значение | Пример | | - | - | - | | `requestedAmount` | Чистая сумма, которую пользователь получит в блокчейне | `"25"` TRX | | `expectedAmount` | Общая сумма с комиссией сети: `requestedAmount + networkFee` | `"25.5"` TRX | | `amount` | Фактически отправленная сумма (сообщается после отправки в блокчейн) | `"25"` TRX | | `usdtTotal` | USDT зарезервированные с баланса, включая буфер удержания 1.25% | `"7.52"` USDT | Если интегратор передаёт `includeFeeInAmount: true`, расчёт меняется на обратный: `expectedAmount` = исходная сумма, `requestedAmount` = исходная сумма - networkFee. Соотношение всегда: `expectedAmount = requestedAmount + networkFee`. `usdtTotal` рассчитывается так: конвертированный `expectedAmount` в USDT по предварительному курсу, затем добавленный буфер удержания 1.25%. Это общая сумма USDT, списываемая с баланса мерчанта. После конвертации излишек удержания возвращается. Пример: ``` Вы запрашивает: вывести 25 TRX requestedAmount = "25" ← что получит пользователь expectedAmount = "25.5" ← 25 + 0.5 комиссия сети exchangeRate = "0.2971" ← предварительный курс USDT/TRX usdtTotal = "7.68" ← (25.5 × 0.2971) × 1.0125 буфер удержания После отправки в блокчейн: amount = "25" ← фактически отправлено ``` #### Пополнение (Sale) | Поле | Значение | Пример | | - | - | - | | `requestedAmount` | Сумма, которую интегратор ожидает получить в качестве депозита | `"0.001"` BTC | | `expectedAmount` | То же, что `requestedAmount` | `"0.001"` BTC | | `amount` | Кумулятивная фактическая сумма депозитов по всем частичным внесениям | `"0.0012"` BTC | | `receivedAmount` | Сумма отдельного депозита в `receivedCurrency` (только при `deposit_received`) | `"0.0005"` BTC | | `usdtTotal` | Кумулятивная сумма USDT, зачисленная на баланс мерчанта (после комиссий) | `"45.30"` USDT | Для пополнения `requestedAmount` и `expectedAmount` всегда одинаковы. Поле `amount` показывает фактическую общую полученную сумму. Сравнивая `amount` с `expectedAmount`, система определяет статус транзакции: `Paid` (ровная сумма), `Overpaid` (сумма больше), `Underpaid` (сумма меньше). Пример: ``` Вы создаёте заказ: пополнение 0.001 BTC requestedAmount = "0.001" ← ожидаемый депозит expectedAmount = "0.001" ← то же значение amount = null ← депозита ещё нет usdtTotal = null После подтверждения депозита: amount = "0.0012" ← фактически получено (переплата) usdtTotal = "45.30" ← зачислено USDT после комиссий exchangeRate = "37750" ← курс BTC/USDT status = "Overpaid" ``` Сводка | Поле | Вывод | Пополнение | | - | - | - | | `requestedAmount` | Чистая сумма к получению (без комиссии) | Ожидаемая сумма депозита | | `expectedAmount` | Полная сумма (с комиссией сети) | То же, что `requestedAmount` | | `amount` | Расчитанная сумма | Кумулятивная фактическая сумма депозитов | | `usdtTotal` | Зарезервированные USDT (с удержанием 1.25%) | Кумулятивная сумма зачисленных USDT | ## Значения статусов | Status | Используется в | Описание | | - | - | - | | `Queued` | Вывод | В очереди на обработку | | `New` | Пополнение | Заказ создан, ожидается депозит | | `Waiting` | Пополнение | Подтверждение в блокчейне в процессе | | `Paid` | Пополнение | Депозит соответствует ожидаемой сумме | | `Overpaid` | Пополнение | Депозит превышает ожидаемую сумму | | `Underpaid` | Пополнение | Депозит меньше ожидаемой суммы | | `Canceled` | Оба | Транзакция отменена / отклонена / ошибка | | `CurrencyMismatch` | Пополнение | Внесена неверная криптовалюта | | `CanceledButPaid` | Пополнение | Заказ просрочен/отклонён, но получен точный депозит | | `CanceledButOverpaid` | Пополнение | Заказ просрочен/отклонён, но получена переплата | | `CanceledButUnderpaid` | Пополнение | Заказ просрочен/отклонён, но получена недоплата | ## Логика валют Поле `currency` отображает то, что ожидалось, а не то, что было фактически получено: * Вывод: целевая криптовалюта, которая покупается (например, `"TRX"`, `"BTC"`) * Пополнение: ожидаемая криптовалюта для депозита из конфигурации заказа (например, `"BTC"`) Фактически полученная криптовалюта указывается в `receivedCurrency` (см. ниже). ### Поля получения (`receivedCurrency`, `receivedNetwork`, `receivedAmount`) Эти три поля отображают то, что фактически было внесено в блокчейн для конкретного депозита. Они заполняются только для события `deposit_received` и всегда `null` для всех остальных событий. * `receivedAmount` фактически зачисленная сумма, а НЕ кумулятивный итог (используйте `amount` для кумулятивного) * `receivedCurrency` — фактически зачисленная криптовалюта * `receivedNetwork` — сеть фактически зачисленной криптовалюты | Сценарий | `receivedCurrency` | `receivedNetwork` | `receivedAmount` | | - | - | - | - | | Вывод (любое событие) | `null` | `null` | `null` | | Пополнение — `deposit_received` | фактический тикер криптовалюты | сеть депозита | сумма отдельного депозита | | Пополнение — все остальные события | `null` | `null` | `null` | ### Детали полей по событиям #### События вывода | Поле | `created` | `completed` | `declined` | `failed` | `canceled` | | - | - | - | - | - | - | | `status` | `Queued` | финальный статус | `Canceled` | `Canceled` | `Canceled` | | `amount` | `null` | финальная сумма | из БД | из БД | из БД | | `hash` | `""` | хеш блокчейна | хеш | может быть `""` | может быть `""` | | `usdtTotal` | сумма резерва | финальное значение | из БД | из БД | из БД | | `exchangeRate` | предварительный курс | фактический курс | из БД | из БД | из БД | | `dealFee` | `"0"` | рассчитано | из БД | из БД | из БД | | `cancelReason` | `null` | `null` | причина | сообщение об ошибке | причина отката | | `completedAt` | `null` | метка времени | `null` | `null` | `null` | | `received*` | `null` | `null` | `null` | `null` | `null` | #### События пополнения | Поле | `created` | `confirmation_started` | `deposit_received` | `completed` / `overpaid` / `underpaid` / `currency_mismatch` | `declined` | `canceled` | | - | - | - | - | - | - | - | | `status` | `New` | `Waiting` | зависит | зависит | зависит | `Canceled` | | `currency` | ожидаемая криптовалюта | ожидаемая криптовалюта | ожидаемая криптовалюта | ожидаемая криптовалюта | ожидаемая криптовалюта | ожидаемая криптовалюта | | `receivedCurrency` | `null` | `null` | фактическая криптовалюта | `null` | `null` | `null` | | `receivedNetwork` | `null` | `null` | сеть депозита | `null` | `null` | `null` | | `receivedAmount` | `null` | `null` | сумма отдельного депозита | `null` | `null` | `null` | | `amount` | `null` | `null` | кумулятивная | кумулятивная | кумулятивная или `null` | `null` | | `hash` | `""` | хеш блокчейна | хеш | хеш | хеш | `""` | | `usdtTotal` | `null` | `null` | кумулятивная USDT | кумулятивная USDT | кумулятивная или `null` | `null` | | `exchangeRate` | `null` | `null` | взвешенное среднее | взвешенное среднее | из БД | `null` | | `dealFee` | `null` | `null` | рассчитано | рассчитано | из БД | `null` | | `completedAt` | `null` | `null` | если доступно | если доступно | если доступно | `null` | | `cancelReason` | `null` | `null` | `null` | `null` | `null` | `null` | Примечания: * `deposit_received` всегда отправляется вместе с одним из: `completed`, `overpaid`, `underpaid` или `currency_mismatch` * `declined` может содержать или не содержать данные депозита, в зависимости от того, были ли получены депозиты до отклонения * Суммы пополнения являются кумулятивными по нескольким депозитам (каждый вебхук `was_final_exchange` добавляется к общей сумме) * Для `currency_mismatch` поле `currency` показывает, что ожидалось, а `receivedCurrency` — что было фактически отправлено # Event Types Source: https://docs.crypto-cash.world/webhooks/types > [!NOTE] > > Все события происходят по шаблону "категория::действие". #### События вывода | Event Type | Description | Webhook | Email | | - | - | - | - | | `withdrawal::created` | Транзакция создана и поставлена в очередь | ✓ | ✗ | | `withdrawal::completed` | Успешно отправлен в блокчейн | ✓ | ✓ | | `withdrawal::declined` | Отклонено системой | ✓ | ✓ | | `withdrawal::failed` | Произошла критическая ошибка | ✓ | ✓ | | `withdrawal::canceled` | Отмена по причине ошибки | ✓ | ✓ | #### События пополнения | Event Type | Description | Webhook | Email | | - | - | - | - | | `acquiring::created` | Депозит создан | ✓ | ✗ | | `acquiring::confirmation_started` | Подтверждение запуска сети | ✓ | ✗ | | `acquiring::confirmation` | Количество подтверждений confirmation | ✓ | ✗ | | `acquiring::deposit_received` | Депозит подтвержден, USDT зачислено на баланс | ✓ | ✗ | | `acquiring::completed` | Заявка выполнена | ✓ | ✓ | | `acquiring::overpaid` | Получено больше, чем ожидалось | ✓ | ✓ | | `acquiring::underpaid` | Получено меньше, чем ожидалось | ✓ | ✓ | | `acquiring::currency_mismatch` | Криптовалюта пополнения не совпадает с валютой в заявке | ✓ | ✓ | | `acquiring::declined` | Отклонено системой | ✓ | ✓ | | `acquiring::canceled` | Срок действия заявки истек без оплаты | ✓ | ✓ | | `acquiring::aml_frozen` | Заморожен из-за соблюдения требований AML | ✓ | ✗ | > [!WARNING] > > Примечание: Все события отправляются через webhooks, но только критические / заключительные события запускают уведомления по электронной почте.