본문으로 건너뛰기

5.1.1 디지털 화폐 생성 및 지갑으로 출금

#간단한 설명: 지갑의 출금 비즈니스 인터페이스로 디지털 화폐를 출금하여 사용자가 지정된 지갑 주소로 usdt를 전송할 수 있도록 합니다. (시장 환율)

요청 매개변수​
매개변수 이름유형필수매개변수 의미매개변수 설명
keystring예판매자 키API키
localOrderIdstring예판매자 플랫폼 현지 주문 번호판매자 플랫폼은 로컬에서 고유한 주문 번호를 생성합니다
localUserIdstring아니요판매자 플랫폼 로컬 사용자 ID판매자 플랫폼 로컬 사용자 ID
amountnumber예금액주문금액
networkstring예메인넷메인넷(현재 TRON, BSC, POLYGON, ETHEREUM만 지원)
addressstring예출금주소출금주소
notifyUrlstring아니요콜백 주소주문이 성공적으로 이루어진 후 API 콜백 요청을 통해 가맹점 주소가 통보됩니다. (콜백 내용은 문서 3 참조)
currencystring예통화주문 통화
userCurrencystring예사용자가 실제로 받은 통화사용자가 실제로 받은 통화
successRedirectUrlstring아니요주소성공 후 해당 주소로 자동 점프
isBlockchainboolean아니요블록체인 정보 반환 여부(기본값 false)true인 경우 콜백 요청은 주문 체인에 거래 정보를 전달합니다
expireSecondLong아니요만료 타임스탬프(초)
signstring예서명자세한 내용은 서명 알고리즘을 참조하세요.
json 샘플 요청​
{
  "key": "weOfDMRpUAvAeOs5",
  "localOrderId": "TestOTM0625ROB017",
  "notifyUrl": "http://www.baidu.com/728-TestOTM0625ROB01",
  "amount": 20,
  "network": "TRON",
  "currency": "CNY",
  "userCurrency": "USDT",
  "successRedirectUrl": "http://www.baidu.com",
  "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
  "isBlockchain": true,
  "sign": "834e924f7846fe3a65b53e6680c8e53a"
}

응답 JSON 예시

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
  
        "orderId": 473220978729221,
        "localUserId": null,
        "localOrderId": "TestOTM0625ROB017",
        "orderType": "WITHDRAW",
        "orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET",
        "targetType": "EXTERNAL",
        "network": "TRON",
        "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
        "currency": "CNY",
        "userCurrency": "USDT",
        "amount": "20",
        "userAmount": "2.994723",
        "userReceivableAmount": "2.994723",
        "rate": "6.67841204",
        "rateExpression": "1USDT≈6.6784CNY"
        }
}
응답 데이터 매개변수 설명​
매개변수 이름유형매개변수 의미비고
orderIdstring주문번호
localUserIdstring판매자 로컬 사용자 ID
localOrderIdstring판매자 지역 주문 번호
orderTypeenum주문 유형PAYMENT：支付订单 | WITHDRAW：提款订单
orderBizTypeenum주문업종orderBizType 유형 설명은 다음과 같습니다.
targetTypeenum대상 유형targetType 유형 설명은 다음과 같습니다
networkstring메인넷 유형
addressstring주소온체인 결제 주소
currencystring통화 주문
userCurrencystring도착통화
amountstring주문금액
userAmountstring사용자가 실제로 받은 금액
userReceivableAmountstring이용자 채권금액
ratestring환율
rateExpressionstring환율 표현

orderBizType 유형 설명:​

  1. PAYMENT_WALLET_SCAN MINPAY 지갑 스캔코드 결제
  2. PAYMENT_TRANSFER 디지털 화폐 바인딩 주소 직접 입금
  3. PAYMENT_ANY_DIGITAL_SCAN QR 코드를 스캔하여 원하는 금액의 디지털 화폐를 결제하세요.
  4. WITHDRAW_WALLET MINPAY 지갑으로 돈을 인출하세요.
  5. WITHDRAW_ANY_DIGITAL_WALLET 디지털 통화를 지갑으로 인출하세요.
  6. PAYMENT_FIXED_DIGITAL_SCAN 디지털화폐 한도금액 스캔코드 결제
  7. BATCH_PAY 일괄결제

targetType 유형 설명:​

  1. INTERNAL 내부 주소
  2. EXTERNAL 외부 주소
  3. USER 사용자 추상 주소

콜백은 json 데이터를 반환합니다​

기본적으로 모든 콜백 매개변수는 서명 확인에 참여합니다. 콜백 매개변수에 대한 자세한 내용은 콜백 ]를 참조하세요.

콜백 데이터​
{
"amount":"20",
"bizType":"WITHDRAW_ANY_DIGITAL_WALLET",
"blockchain":{
               "network":"TRON",
               "receiverAddress":"TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
               "senderAddress":"TE35TrUfHjbGEBsVS6zVXdHS8HxXCWwC2y",
        "txId":"c5503ecf1f0979d5bc7a7e16c3cad20290449913ab47a7e18dfca6ba6f2725fa"
              },
"currency":"CNY",
"localOrderId":"TestOTM0625ROB017",
"merchantActualAmount":"57.32",
"merchantCurrency":"CNY",
"merchantId":302992856974,
"merchantPaidAmount":"20",
"notifyTime":1772259079786,
"orderCreateTime":1772259032870,
"orderId":"473220978729221",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"2.994723",
"userCurrency":"USDT",
"userMinerFee":"0",
"userReceivableAmount":"2.994723",
"sign":"742e64d684648c32c7ad33cf8d5604e2",
"key":"9yUreYgTRtit39Dy"
}

콜백 알림을 받으면 처리가 완료된 후 메시지가 성공적으로 수신 및 처리되었음을 나타내는 성공 문자열을 직접 반환해 주세요. 시스템이 성공 응답을 받은 후에는 더 이상 콜백을 반복적으로 보내지 않습니다. 예상된 응답을 받지 못한 경우(성공이 반환되지 않거나 예외가 반환됨) 시스템은 단계적 재시도 메커니즘에 따라 최대 14회 재시도하여 콜백 알림을 다시 보냅니다. 현재 재시도 간격은 다음과 같습니다. 15대, 15대, 30대, 180년대, 600년대, 1200년대, 1800년대, 1800년대, 1800년대, 3600년대, 10800년대, 10800년대, 21600년대, 21600년대