Төлем жасау

post https://api.cryptomus.com/v1/payout Көшіру

API арқылы төленетін төлемдер сіздің бизнесіңіздің әмияндарыңыздың қалдықтарынан ғана жасалады.

Төлемдерді әр түрлі жолдармен жасауға болады:

  1. Сіз төлемді белгілі бір криптоцерттіктен алуды таңдай аласыз, ал төлем автоматты түрде әр нақты криптокурлылықпен өңделеді. Ол үшін, барлық байланысты төлемдерді жабу үшін нақты валютада жеткілікті теңгерім болғанына көз жеткізіңіз.
  2. Сонымен қатар, сізде Fiat валютасындағы төлем сомасын көрсету мүмкіндігі бар. Бұл жағдайда, сома автоматты түрде қол жетімді теңгерімдегі криптокарттылыққа ауыстырылады. Мысалы, егер сіз LTC-де 20 АҚШ доллары мөлшерін сұрасаңыз, онда LTC теңгеріміңізден балама мән алынып тасталады. Барлық қолданылатын төлемдерді қамту үшін тиісті криптокуралықта жеткілікті қаражат алу маңызды.
  3. Тағы бір мүмкіндік - Fiat валютасындағы төлем сомасын анықтау, ол сіздің USDT теңгеріміңіз арқылы автоматты түрде белгілі бір криптокарттықтан автоматты түрде өзгертіледі. Бұл опция әсіресе AutoConvert қосылған кезде пайдалы, өйткені сіздің шот-фактураларыңыздан қаражат автоматты түрде USDT-ге ауыстырылады. Мысалы, егер сіз LTC-де 20 АҚШ доллары төлегіңіз келсе, бірақ тек USDT-де теңгерім болса, барлық төлемдерді қамту үшін сізде USDT қаражаты жеткілікті екеніне көз жеткізіңіз.
  4. Сонымен қатар, сіз өзіңіздің қалауыңыз бойынша кез-келген крипточкадағы төлем сомасын көрсетуді таңдай аласыз. Төлем қол жетімді USDT теңгерімін пайдаланып, нақты криптоштықтан автоматты түрде өңделеді. Барлық байланысты төлемдерді жабу үшін USDT теңгерімінің жеткілікті болуы өте маңызды.

Өтініш

Сұрау параметрлері

ЕсімПараметр түріӘдепкі мәнАнықтама
amount*string-Төлем сомасы
currency*string-Төлемге арналған валюталық кодЕгер валюта фиат болса, to_currency параметрі міндетті.
order_id*stringmin:1max:100alpha_dash-Сіздің жүйеңіздегі идентификаторПараметр алфавиттік таңбалардан, сандардан, астында сызбалардан және сызықшалардан тұратын жол болуы керек. Ол ешқандай кеңістік немесе арнайы таңбалар болмауы керек. order_id саудагерлердің төлемдерінде ерекше болуы керекЕгер біз order_id бар төлемді тапқан кезде, біз оның мәліметтерін қайтарамыз, жаңа төлем жасалмайды.
address*string-Шығаруға болатын әмиянның мекен-жайы
is_subtract*boolean-Шығару ақысы шегерілетінін анықтайдыTRUE - сіздің балансыңызданЖалған - төлем сомасынан төлем сомасы азаяды
network*string-BlockChain желілік коды валюта/to_currency - бұл криптокюрлік болған кезде қажет емес, мысалы, тек бір желі бар, мысалы BTC
url_callback-Webhook-тегі URL мекен-жайы, қайтарады
to_currency-Төлем жасалатын криптоштік код. Ол currency параметрі Fiat болған кезде қолданылады. Төмендегі мысалдарды қараңыз
course_sourcestringҚол жетімді мәндер• Binance• BinanceP2p• Exmo• KucoinСатушының параметрлерінің мәніВалюта бағамдары шот-фактурада айырбастау үшін қабылданады.Параметр валюта Fiat болған жағдайда ғана қолданылады, әйтпесе, сатушы параметрлерден әдепкі мән алынады.
from_currencystringnullШығару сомасын автоматты түрде түрлендіріп, ішінен rongrience тепе-теңдігін пайдалануға мүмкіндік береді. Тек USDT қол жетімді.
prioritystringmin: 4max: 11Қол жетімді мәндер• recommended• economy• high• highestrecommendedШығарудың басымдылығын таңдау параметрі. Шығару комиссиясының құны таңдалған параметрге байланысты.Бұл параметр BTC, Eth, Polygon және BSC желілерін пайдаланған жағдайда ғана қолданылады.
memostringmin: 1max: 64-Белгілі бір алушыны немесе нысананы көрсету үшін пайдаланылатын тонна үшін қосымша идентификатор

Параметр түрі

string

Анықтама

Төлем сомасы

Параметр түрі

string

Анықтама

Төлемге арналған валюталық кодЕгер валюта фиат болса, to_currency параметрі міндетті.

Параметр түрі

stringmin:1max:100alpha_dash

Анықтама

Сіздің жүйеңіздегі идентификаторПараметр алфавиттік таңбалардан, сандардан, астында сызбалардан және сызықшалардан тұратын жол болуы керек. Ол ешқандай кеңістік немесе арнайы таңбалар болмауы керек. order_id саудагерлердің төлемдерінде ерекше болуы керекЕгер біз order_id бар төлемді тапқан кезде, біз оның мәліметтерін қайтарамыз, жаңа төлем жасалмайды.

Параметр түрі

string

Анықтама

Шығаруға болатын әмиянның мекен-жайы

Параметр түрі

boolean

Анықтама

Шығару ақысы шегерілетінін анықтайдыTRUE - сіздің балансыңызданЖалған - төлем сомасынан төлем сомасы азаяды

Параметр түрі

string

Анықтама

BlockChain желілік коды валюта/to_currency - бұл криптокюрлік болған кезде қажет емес, мысалы, тек бір желі бар, мысалы BTC

Анықтама

Webhook-тегі URL мекен-жайы, қайтарады

Анықтама

Төлем жасалатын криптоштік код. Ол currency параметрі Fiat болған кезде қолданылады. Төмендегі мысалдарды қараңыз

Параметр түрі

string
Қол жетімді мәндер
- Binance- BinanceP2p- Exmo- Kucoin

Әдепкі мән

Сатушының параметрлерінің мәні
Қол жетімді мәндер
- Binance- BinanceP2p- Exmo- Kucoin

Анықтама

Валюта бағамдары шот-фактурада айырбастау үшін қабылданады.Параметр валюта Fiat болған жағдайда ғана қолданылады, әйтпесе, сатушы параметрлерден әдепкі мән алынады.

Параметр түрі

string

Әдепкі мән

null

Анықтама

Шығару сомасын автоматты түрде түрлендіріп, ішінен rongrience тепе-теңдігін пайдалануға мүмкіндік береді. Тек USDT қол жетімді.

Параметр түрі

stringmin: 4max: 11
Қол жетімді мәндер
- recommended- economy- high- highest

Әдепкі мән

recommended
Қол жетімді мәндер
- recommended- economy- high- highest

Анықтама

Шығарудың басымдылығын таңдау параметрі. Шығару комиссиясының құны таңдалған параметрге байланысты.Бұл параметр BTC, Eth, Polygon және BSC желілерін пайдаланған жағдайда ғана қолданылады.

Параметр түрі

stringmin: 1max: 64

Анықтама

Белгілі бір алушыны немесе нысананы көрсету үшін пайдаланылатын тонна үшін қосымша идентификатор

* - Міндетті параметр

Мысал сұрау


curl https://api.cryptomus.com/v1/payout \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{ 
    "amount": "5",
    "currency": "USDT", 
    "network": "TRON", 
    "order_id": "1",
    "address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm", 
    "url_callback": "https://your.site/callback", 
    "is_subtract": "1"
}'
Көшіру

Жауап

Жауап параметрлері

ЕсімПараметр түріАнықтама
uuidstringТөлемнің ууидері
amountstringТөлем сомасы currency
currencystringТөлемге арналған валюталық код
networkstring|nullТөлем жасалатын блок-камера желісінің коды
payer_currencystring|nullТөлем жасалған криптошалық коды іс жүзінде жасалады. Төлем мекен-жайы төлем валютасын алады.
payer_amountstring|null Төлеуші_курсиялық төлемін құрайды.
addressstringТөлем жасалған әмиянның мекен-жайы
txidstring|nullБояудағы транзакция идентификаторы
statusstringТөлем мәртебесі Барлық қол жетімді күйлерді қараңыз
is_finalbooleanТөлем аяқталған ба, жоқ паТөлем процесі сәтті төленгеннен кейін немесе ол сәтсіз болған кезде аяқталады деп саналады. Төлем сәтсіз болған жағдайда қаражат сіздің төлем процесін қайтадан бастауға талап ететін қалдыққа қайтарылады.
balancestring|nullСаудагердің тепе-теңдігі бойынша қалған қаражат.
order_idstring|nullСіздің жүйеңіздегі идентификатор
commissionstring|nullCryptomus комиссиясының сомасы
merchant_amountstring|nullСаудагердің балансынан, соның ішінде барлық комиссиялардан есептен шығарылған сома.
convertТөлем автоматты түрде айырбасталатын валюта туралы ақпарат. Айырбастау Payer_currency USDT-тен орындаладыЕгер from_currency мәні берілген болса, көрсетіңіз
convert.to_currencystring|nullТөлем болып айырылған валюта коды
convert.from_currencystringВалютаның
convert.commissionstringАйырбастау жарнасы
convert.ratestring|nullАйырбастау бағамы
convert.from_amountstring|nullСома

Параметр түрі

string

Анықтама

Төлемнің ууидері

Параметр түрі

string

Анықтама

Төлем сомасы currency

Параметр түрі

string

Анықтама

Төлемге арналған валюталық код

Параметр түрі

string|null

Анықтама

Төлем жасалатын блок-камера желісінің коды

Параметр түрі

string|null

Анықтама

Төлем жасалған криптошалық коды іс жүзінде жасалады. Төлем мекен-жайы төлем валютасын алады.

Параметр түрі

string|null

Анықтама

Төлеуші_курсиялық төлемін құрайды.

Параметр түрі

string

Анықтама

Төлем жасалған әмиянның мекен-жайы

Параметр түрі

string|null

Анықтама

Бояудағы транзакция идентификаторы

Параметр түрі

string

Анықтама

Төлем мәртебесі Барлық қол жетімді күйлерді қараңыз

Параметр түрі

boolean

Анықтама

Төлем аяқталған ба, жоқ паТөлем процесі сәтті төленгеннен кейін немесе ол сәтсіз болған кезде аяқталады деп саналады. Төлем сәтсіз болған жағдайда қаражат сіздің төлем процесін қайтадан бастауға талап ететін қалдыққа қайтарылады.

Параметр түрі

string|null

Анықтама

Саудагердің тепе-теңдігі бойынша қалған қаражат.

Параметр түрі

string|null

Анықтама

Сіздің жүйеңіздегі идентификатор

Параметр түрі

string|null

Анықтама

Cryptomus комиссиясының сомасы

Параметр түрі

string|null

Анықтама

Саудагердің балансынан, соның ішінде барлық комиссиялардан есептен шығарылған сома.

Анықтама

Төлем автоматты түрде айырбасталатын валюта туралы ақпарат. Айырбастау Payer_currency USDT-тен орындаладыЕгер from_currency мәні берілген болса, көрсетіңіз

Параметр түрі

string|null

Анықтама

Төлем болып айырылған валюта коды

Параметр түрі

string

Анықтама

Валютаның

Параметр түрі

string

Анықтама

Айырбастау жарнасы

Параметр түрі

string|null

Анықтама

Айырбастау бағамы

Параметр түрі

string|null

Анықтама

Сома

Жауаптың мысалы


1{
2    "state": 0,
3    "result": {
4        "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
5        "amount": "3",
6        "currency": "USDT",
7        "network": "TRON",
8        "payer_currency": "USDT",
9        "payer_amount": "3",
10        "address": "TJ...",
11        "txid": null,
12        "status": "process",
13        "is_final": false,
14        "balance": "129",
15        "order_id": "1",
16        "commission": null,
17        "merchant_amount": null
18    }
19}
20
Көшіру

Мүмкін қателер

Тексеру қателері

код : 422

мысал жауаптары:


1{
2	"state": 1,
3	"errors": {
4		"amount": ["validation.required"]
5	}
6}
Көшіру

Егер төлемдеріңізден немесе пайдаланушысыңызда төлемдер бұғатталған болса, сіз осы қате туралы хабарлама аласыз. Бұл, мысалы, парольді өзгерткен кезде және төлемдер 24 сағат бойы бұғатталған кезде.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
Көшіру

Егер біз валюта параметрінде ұсынған валюта кодын қолдамасақ, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "The currency was not found"
4}
Көшіру

Егер біз төлемді орындау қызметін таба алмасақ, сіз осы қате туралы хабарлама аласыз. Сіз криптоцерттіктің қолдау көрсетілетініне көз жеткізуіңіз керек. Енгізілген мәндердің дұрыстығын тексеріңіз. Валюта, желі, from_currency, to_currency:


1{
2    "state": 1,
3    "message": "The service was not found"
4}
Көшіру

Егер алу сомасы тым кішкентай болса, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "The withdrawal amount is too small"
4}
Көшіру

Егер сізде жалақы криптофавкасы бар белсенді саудагер әмиян болмаса, сіз осы қатені аласыз:


1{
2    "state": 1,
3    "message": "Wallet not found"
4}
Көшіру

Егер төлем сомасы, оның ішінде барлық комиссиялар сіздің теңгеріміңізден гөрі, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "Not enough funds"
4}
Көшіру

Егер біз to_currency параметрінде өткен валютаның төлем қызметін таба алмасақ, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "Not found service to_currency"
4}
Көшіру

Егер to_currency-ге конвертация кезінде кездейсоқ бірдеңе болса, сіз бұл қате хабарламасын аласыз:


1{
2    "state": 1,
3    "message": "Error convert to_currency"
4}
Көшіру

Егер төлем сомасы криптокуралдылық үшін ең аз қолдау көрсетілетін сомадан аз болса, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "Minimum amount 0.5 USDT"
4}
Көшіру

Егер төлем сомасы криптокуралдылық үшін ең көп қолдау көрсетілетін сомадан үлкен болса, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "Maximum amount 10000000 USDT"
4}
Көшіру

Егер сізде төлем жасау үшін қаражат жеткіліксіз болса, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "Not enough funds"
4}
Көшіру

Егер сізде төлем сомасын төлеу үшін қаражат жеткіліксіз болса, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "Not enough balance for convert USDT to LTC"
4}
Көшіру

Егер техникалық жұмыс орын алса және төлем уақытша қол жетімді емес болса, сіз бұл қате туралы хабарлама аласыз


1{
2    "state": 1,
3    "message": "The terminal was not found"
4}
Көшіру

Ішкі қате

код : 500

мысал жауаптары:


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}
Көшіру