사용자 자산 회수

사용자 출금

post

사용자 계정에서 금액을 출금합니다. 사용자 잔액에서 차감되어 에이전트 팟으로 이동합니다.

처리 과정:

1. 사용자 잔액에서 출금 금액을 차감

2. 에이전트 팟에 해당 금액을 추가

3. 파트너에게 거래 알림 전송 (Seamless wallet만 해당)

제한사항:

• 사용자 잔액이 부족하면 실패

• 출금 금액은 양수여야 함

• 최대 거래 금액 제한 있음

사용 시나리오:

• 사용자 출금 처리

• 계정 정산

• 위반 사용자 잔액 회수

권한 요구사항:

• API Key 헤더 필수

• Agent ID 헤더 필수

Authorizations

ApiKeyAuthAgentIdAuth

api-keystringRequired

에이전트별 발급된 API 키를 입력하세요

Body

application/json

usernamestringRequired

출금할 사용자명

Example: user123

amountnumber · min: 0.01Required

출금 금액 (양수)

Example: 5000

Responses

200

출금 성공

application/json

201Success

application/json

400

잘못된 요청 데이터

application/json

401

인증 실패

application/json

404

사용자를 찾을 수 없음

application/json

500

서버 내부 오류

application/json

post

/api/transfer/debit

HTTPcURLJavaScriptPython

POST /api/transfer/debit HTTP/1.1
Host: {HIGHEND-API-SERVER}
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "username": "user123",
  "amount": 5000
}

표준 출금위약금 차감

{
  "balance": 10000.5
}