지불금 생성

post
https://api.cryptomus.com/v1/payout
복사

API를 통한 지불금은 비즈니스 지갑 잔액에서만 이루어집니다.

지불금은 다양한 방식으로 이루어질 수 있습니다.

  1. 특정 cryptocurrency에서 지불금을 받도록 선택할 수 있으며 해당 특정 cryptocurrency에서 지불금이 자동으로 처리됩니다. 그렇게하려면 모든 관련 수수료를 충당하기에 특정 통화의 잔액이 충분히 확인되도록하십시오.
  2. 또는 피아트 통화로 지불금 금액을 지정할 수있는 옵션이 있습니다. 이 경우 금액은 사용 가능한 잔액에서 특정 암호 화폐로 자동 변환됩니다. 예를 들어, LTC에서 20 USD의 지불금을 요청하면 LTC 잔액에서 동등한 값이 공제됩니다. 해당 cryptocurrency에 충분한 자금을 지원하여 모든 해당 수수료를 충당하는 것이 중요합니다.
  3. 또 다른 가능성은 Fiat 통화로 지불금 금액을 지정하는 것입니다. 이는 USDT 잔액을 사용하여 특정 암호 화폐로 자동 변환됩니다. 이 옵션은 송장의 자금이 자동으로 USDT로 변환되므로 AutoConvert가 활성화 된 경우 특히 유용합니다. 예를 들어, LTC에서 20 USD를 지불하려는 경우 USDT에서만 잔액을 지불하려면 모든 수수료를 충당하기에 충분한 USDT 자금이 있는지 확인하십시오.
  4. 또한 선호하는 암호 화폐에서 지불금 금액을 지정하도록 선택할 수 있습니다. 그런 다음 지불 가능한 USDT 잔액을 사용하여 해당 특정 암호 화폐에서 지불금이 자동으로 처리됩니다. 모든 관련 수수료를 충당하기에 충분한 USDT 잔액을 갖는 것이 중요합니다.

요구

쿼리 매개 변수

이름매개 변수 유형기본값정의
amount*string지불 금액
currency*string지불금의 통화 코드화폐 인 경우 fiat 인 경우 to_currency 매개 변수가 필요합니다 .
order_id*stringmin:1max:100alpha_dash시스템에서 ID를 주문하십시오매개 변수는 알파벳 문자, 숫자, 밑줄 및 대시로 구성된 문자열이어야합니다. 공백이나 특수 문자를 포함해서는 안됩니다. order_id 는 판매자 지불금 내에서 독특해야합니다. order_id 로 기존 지불금을 찾으면 세부 정보를 반환하면 새로운 지불금이 생성되지 않습니다.
address*string철수가 이루어질 지갑의 주소
is_subtract*boolean인출 수수료가 공제되는 위치를 정의합니다사실 - 당신의 균형에서거짓 - 지불금 금액에서 지불금 금액이 줄어 듭니다.
network*string블록 체인 네트워크 코드 Currency/to_currency 가 cryptocurrency이고 네트워크가 하나만있는 경우 (예 : BTC) 필요하지 않습니다.
url_callback지불 상태가있는 webhooks가 전송 될 URL
to_currency지불금이 이루어질 cryptocurrency 코드. currency 매개 변수가 Fiat 일 때 사용됩니다. 아래 예제를 참조하십시오
course_sourcestring사용 가능한 값BinanceBinanceP2pExmoKucoin가맹점의 설정에서 값송장의 전환을 위해 환율을 취하는 서비스.매개 변수는 통화가 Fiat 인 경우에만 적용되며, 그렇지 않으면 기본값은 판매자의 설정에서 가져옵니다.
from_currencystringnull인출 금액을 자동으로 변환하고 From_Currency 잔액을 사용할 수 있습니다. USDT 만 사용할 수 있습니다.
prioritystringmin: 4max: 11사용 가능한 값recommendedeconomyhighhighestrecommended출금 우선순위를 선택하는 매개변수입니다. 출금 수수료 비용은 선택한 매개변수에 따라 다릅니다.이 매개 변수는 BTC, ETH, 다각형 및 BSC 네트워크를 사용하는 경우에만 적용됩니다.
memostringmin: 1max: 30특정 수신자 또는 대상을 지정하는 데 사용되는 TON의 추가 식별자

매개 변수 유형

string

정의

지불 금액

매개 변수 유형

string

정의

지불금의 통화 코드화폐 인 경우 fiat 인 경우 to_currency 매개 변수가 필요합니다 .

매개 변수 유형

stringmin:1max:100alpha_dash

정의

시스템에서 ID를 주문하십시오매개 변수는 알파벳 문자, 숫자, 밑줄 및 대시로 구성된 문자열이어야합니다. 공백이나 특수 문자를 포함해서는 안됩니다. order_id 는 판매자 지불금 내에서 독특해야합니다. order_id 로 기존 지불금을 찾으면 세부 정보를 반환하면 새로운 지불금이 생성되지 않습니다.

매개 변수 유형

string

정의

철수가 이루어질 지갑의 주소

매개 변수 유형

boolean

정의

인출 수수료가 공제되는 위치를 정의합니다사실 - 당신의 균형에서거짓 - 지불금 금액에서 지불금 금액이 줄어 듭니다.

매개 변수 유형

string

정의

블록 체인 네트워크 코드 Currency/to_currency 가 cryptocurrency이고 네트워크가 하나만있는 경우 (예 : BTC) 필요하지 않습니다.

정의

지불 상태가있는 webhooks가 전송 될 URL

정의

지불금이 이루어질 cryptocurrency 코드. currency 매개 변수가 Fiat 일 때 사용됩니다. 아래 예제를 참조하십시오

매개 변수 유형

string
사용 가능한 값
- Binance- BinanceP2p- Exmo- Kucoin

정의

송장의 전환을 위해 환율을 취하는 서비스.매개 변수는 통화가 Fiat 인 경우에만 적용되며, 그렇지 않으면 기본값은 판매자의 설정에서 가져옵니다.

매개 변수 유형

string

정의

인출 금액을 자동으로 변환하고 From_Currency 잔액을 사용할 수 있습니다. USDT 만 사용할 수 있습니다.

매개 변수 유형

stringmin: 4max: 11
사용 가능한 값
- recommended- economy- high- highest

정의

출금 우선순위를 선택하는 매개변수입니다. 출금 수수료 비용은 선택한 매개변수에 따라 다릅니다.이 매개 변수는 BTC, ETH, 다각형 및 BSC 네트워크를 사용하는 경우에만 적용됩니다.

매개 변수 유형

stringmin: 1max: 30

정의

특정 수신자 또는 대상을 지정하는 데 사용되는 TON의 추가 식별자

* - 필수 매개 변수

요청 예제


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지불금의 uuid
amount통화 의 지불 금액
currency지불금의 통화 코드
network결제가 이루어진 블록 체인 네트워크의 코드
address지불이 이루어진 지갑의 주소
txid블록 체인의 트랜잭션 ID
status지불 상태 사용 가능한 모든 상태를 참조하십시오
is_final지불금이 확정되는지 여부지불금 절차는 성공적으로 지불되거나 실패한 경우 지불 절차가 완료된 것으로 간주됩니다. 지불 실패가 발생하면 자금은 잔액으로 반환되어 지불 절차를 다시 시작해야합니다.
balance나머지 자금은 상인의 ​​잔액에 자금을 조달합니다.
payer_currency지불금이 실제로 이루어질 cryptocurrency 코드. 지불금 주소는 지불 통화를받습니다.
payer_amount지불금의 payer_currency 금액.

정의

지불금의 uuid

정의

통화 의 지불 금액

정의

지불금의 통화 코드

정의

결제가 이루어진 블록 체인 네트워크의 코드

정의

지불이 이루어진 지갑의 주소

정의

블록 체인의 트랜잭션 ID

정의

지불 상태 사용 가능한 모든 상태를 참조하십시오

정의

지불금이 확정되는지 여부지불금 절차는 성공적으로 지불되거나 실패한 경우 지불 절차가 완료된 것으로 간주됩니다. 지불 실패가 발생하면 자금은 잔액으로 반환되어 지불 절차를 다시 시작해야합니다.

정의

나머지 자금은 상인의 ​​잔액에 자금을 조달합니다.

정의

지불금이 실제로 이루어질 cryptocurrency 코드. 지불금 주소는 지불 통화를받습니다.

정의

지불금의 payer_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}
복사

지불금을 실행하기위한 서비스를 찾을 수 없으면이 오류 메시지를 받게됩니다. cryptocurrency가 지원되는지 확인해야합니다. 통화, 네트워크, 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}
복사

지불금 금액이 cryptocurrency의 최소 지원 금액보다 적은 경우이 오류 메시지를 받게됩니다.


1{
2    "state": 1,
3    "message": "Minimum amount 0.5 USDT"
4}
복사

지불금 금액이 cryptocurrency의 최대 지원 금액보다 큰 경우이 오류 메시지를 받게됩니다.


1{
2    "state": 1,
3    "message": "Maximum amount 10000000 USDT"
4}
복사

지불금을 지불 할 자금이 충분하지 않은 경우이 오류 메시지가 표시됩니다.


1{
2    "state": 1,
3    "message": "Not enough funds"
4}
복사

From_Currency에서 지불금 금액을 전환 할 자금이 충분하지 않은 경우이 오류 메시지가 표시됩니다.


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}
복사