Төлем жасау

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Төлемге арналған валюталық кодЕгер валюта болса, егер FIAT болса, to_currency параметрі қажет .
order_id*stringmin:1max:100alpha_dashСіздің жүйеңіздегі идентификаторПараметр алфавиттік таңбалардан, сандардан, астында сызбалардан және сызықшалардан тұратын жол болуы керек. Ол ешқандай кеңістік немесе арнайы таңбалар болмауы керек. order_id саудагерлердің төлемдерінде ерекше болуы керекЕгер біз order_id бар төлемді тапқан кезде, біз оның мәліметтерін қайтарамыз, жаңа төлем жасалмайды.
address*stringШығаруға болатын әмиянның мекен-жайы
is_subtract*booleanШығару ақысы шегерілетінін анықтайдыTRUE - сіздің балансыңызданЖалған - төлем сомасынан төлем сомасы азаяды
network*stringBlockChain желілік коды to_currency - бұл криптокюрлік болған кезде қажет емес, мысалы, тек бір желі бар, мысалы BTC
url_callbackWebHook-тегі URL мекен-жайы, қайтарады
to_currencyТөлем жасалатын криптоштік код. Ол currency параметрі Fiat болған кезде қолданылады. Төмендегі мысалдарды қараңыз
course_sourcestringҚол жетімді мәндерBinanceBinanceP2pExmoKucoinСатушының параметрлерінің мәніВалюта бағамдары шот-фактурада айырбастау үшін қабылданады.Параметр валюта Fiat болған жағдайда ғана қолданылады, әйтпесе, сатушы параметрлерден әдепкі мән алынады.
from_currencystringnullШығару сомасын автоматты түрде түрлендіріп, ішінен rongrience тепе-теңдігін пайдалануға мүмкіндік береді. Тек USDT қол жетімді.
prioritystringmin: 4max: 11Қол жетімді мәндерrecommendedeconomyhighhighestrecommendedШығарудың басымдылығын таңдау параметрі. Шығару комиссиясының құны таңдалған параметрге байланысты.Бұл параметр BTC, Eth, Polygon және BSC желілерін пайдаланған жағдайда ғана қолданылады.
memostringmin: 1max: 30Белгілі бір алушыны немесе нысананы көрсету үшін пайдаланылатын тонна үшін қосымша идентификатор

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

string

Анықтама

Төлем сомасы

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

string

Анықтама

Төлемге арналған валюталық кодЕгер валюта болса, егер FIAT болса, 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

Анықтама

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

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

string

Анықтама

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

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

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

Анықтама

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

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

stringmin: 1max: 30

Анықтама

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

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

Мысал сұрау


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",
}'
Еліктеу

Жауап

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

ЕсімАнықтама
uuidТөлемнің ууидері
amountТөлем сомасы currency
currencyТөлемге арналған валюталық код
networkТөлем жасалатын блок-камера желісінің коды
addressТөлем жасалған әмиянның мекен-жайы
txidБояудағы транзакция идентификаторы
statusТөлем мәртебесі Барлық қол жетімді күйлерді қараңыз
is_finalТөлем аяқталған ба, жоқ паТөлем процесі сәтті төленгеннен кейін немесе ол сәтсіз болған кезде аяқталады деп саналады. Төлем сәтсіз болған жағдайда қаражат сіздің төлем процесін қайтадан бастауға талап ететін қалдыққа қайтарылады.
balanceСаудагердің тепе-теңдігі бойынша қалған қаражат.
payer_currencyТөлем жасалған криптошалық коды іс жүзінде жасалады. Төлем мекен-жайы төлем валютасын алады.
payer_amount Төлеуші_курсиялық төлемін құрайды.

Анықтама

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

Анықтама

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

Анықтама

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

Анықтама

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

Анықтама

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

Анықтама

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

Анықтама

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

Анықтама

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

Анықтама

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

Анықтама

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

Анықтама

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

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


1{
2    "state": 0,
3    "result": {
4        "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594", 
5        "amount": "3",
6        "currency": "USDT",
7        "network": "TRON",
8        "address": "TJ...",
9        "txid": null,
10        "status": "process",
11        "is_final": false,
12        "balance": 129,
13        "payer_currency": "USD",
14        "payer_amount": 3
15    }
16}
17
Еліктеу

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

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

код : 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}
Еліктеу

Егер біз төлемді орындау қызметін таба алмасақ, сіз осы қате туралы хабарлама аласыз. Сіз криптоцерттіктің қолдау көрсетілетініне көз жеткізуіңіз керек. Енгізілген мәндердің дұрыстығын тексеріңіз. Валюта, желі, of_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}
Еліктеу

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


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}
Еліктеу