Төлем жасау
API арқылы төленетін төлемдер сіздің бизнесіңіздің әмияндарыңыздың қалдықтарынан ғана жасалады.
Төлемдерді әр түрлі жолдармен жасауға болады:
- Сіз төлемді белгілі бір криптоцерттіктен алуды таңдай аласыз, ал төлем автоматты түрде әр нақты криптокурлылықпен өңделеді. Ол үшін, барлық байланысты төлемдерді жабу үшін нақты валютада жеткілікті теңгерім болғанына көз жеткізіңіз.
- Сонымен қатар, сізде Fiat валютасындағы төлем сомасын көрсету мүмкіндігі бар. Бұл жағдайда, сома автоматты түрде қол жетімді теңгерімдегі криптокарттылыққа ауыстырылады. Мысалы, егер сіз LTC-де 20 АҚШ доллары мөлшерін сұрасаңыз, онда LTC теңгеріміңізден балама мән алынып тасталады. Барлық қолданылатын төлемдерді қамту үшін тиісті криптокуралықта жеткілікті қаражат алу маңызды.
- Тағы бір мүмкіндік - Fiat валютасындағы төлем сомасын анықтау, ол сіздің USDT теңгеріміңіз арқылы автоматты түрде белгілі бір криптокарттықтан автоматты түрде өзгертіледі. Бұл опция әсіресе AutoConvert қосылған кезде пайдалы, өйткені сіздің шот-фактураларыңыздан қаражат автоматты түрде USDT-ге ауыстырылады. Мысалы, егер сіз LTC-де 20 АҚШ доллары төлегіңіз келсе, бірақ тек USDT-де теңгерім болса, барлық төлемдерді қамту үшін сізде USDT қаражаты жеткілікті екеніне көз жеткізіңіз.
- Сонымен қатар, сіз өзіңіздің қалауыңыз бойынша кез-келген крипточкадағы төлем сомасын көрсетуді таңдай аласыз. Төлем қол жетімді 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_source | stringҚол жетімді мәндер• Binance• BinanceP2p• Exmo• Kucoin | Сатушының параметрлерінің мәні | Валюта бағамдары шот-фактурада айырбастау үшін қабылданады.Параметр валюта Fiat болған жағдайда ғана қолданылады, әйтпесе, сатушы параметрлерден әдепкі мән алынады. | 
| from_currency | string | null | Шығару сомасын автоматты түрде түрлендіріп, ішінен rongrience тепе-теңдігін пайдалануға мүмкіндік береді. Тек USDT қол жетімді. | 
| priority | stringmin: 4max: 11Қол жетімді мәндер• recommended• economy• high• highest | recommended | Шығарудың басымдылығын таңдау параметрі. Шығару комиссиясының құны таңдалған параметрге байланысты.Бұл параметр BTC, Eth, Polygon және BSC желілерін пайдаланған жағдайда ғана қолданылады. | 
| memo | stringmin: 1max: 30 | - | Белгілі бір алушыны немесе нысананы көрсету үшін пайдаланылатын тонна үшін қосымша идентификатор | 
- Параметр түрі 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: 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}Егер біз төлемді орындау қызметін таба алмасақ, сіз осы қате туралы хабарлама аласыз. Сіз криптоцерттіктің қолдау көрсетілетініне көз жеткізуіңіз керек. Енгізілген мәндердің дұрыстығын тексеріңіз. Валюта, желі, 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}