1
KYC 인증 완료
사용자가 지급을 받으려면 먼저 신원 인증(KYC)을 완료해야 합니다. 호스팅된 계정 온보딩 흐름을 사용해 사용자에게 이 과정을 안내하세요:응답으로 반환된
url로 사용자를 리디렉션하세요. 인증을 완료하면 사용자는 return_url로 다시 리디렉션됩니다.2
지급 수단 추가
지급을 생성하기 전에 계정에 지급 수단이 필요합니다. 하위 계정에 대한 액세스 토큰으로 Withdraw 엘리먼트를 마운트하세요. 이 엘리먼트는 계정의 지급 수단을 나열하고, 지급 수단이 없으면 새로 수집합니다:하위 계정 지급 활성화에 표시된 대로 서버에서 하위 계정에 대한
accessToken을 발급하세요. 대신 사용자를 호스팅된 지급 포털로 보낼 수도 있습니다. 소유자가 로그인하여 소유권을 증명한 후에만 PayPal 계정을 수락하려면 PayPal 지급 수단을 연결하세요.3
기본 지급 수단 가져오기
하위 계정의 지급 수단 목록을 조회하고
is_default: true인 수단을 찾으세요:4
지급 생성
API 버전 아래의 이 예시에서:
2026-11-03 이상에서는 견적이 필요합니다. 먼저 제출할 계정, 지급 수단, 금액, 통화, 속도로 POST /payouts/quotes를 호출하세요:QUOTE_TOKEN_FROM_RESPONSE를 반환된 quote_token으로 바꾸고 expires_at 이전에 제출하세요. 지급 요청이 시간 초과되면 동일한 지급 Idempotency-Key와 원래 토큰으로 재시도하세요. 견적 요청에는 다른 키를 사용하세요.account_id는 지급할 하위 계정입니다amount는 지급 금액(100.00 USD)이며, 수수료는 이 금액에서 차감됩니다currency는 ISO 통화 코드입니다payout_method_id는 사용할 지급 수단의 ID입니다(3단계에서 가져옴)
하위 계정의 지급 수수료 부담
기본적으로 지급 수수료는 하위 계정의 잔액에서 차감됩니다. 견적 요청과 지급 요청 모두에서platform_covers_fees를 true로 설정하면 대신 플랫폼 잔액에서 이 수수료를 부담할 수 있습니다:platform_covers_fees가 true이면 하위 계정은 전체 지급 금액을 받고, 수수료는 대신 플랫폼의 잔액에서 차감됩니다. 이를 위해서는 플랫폼의 수수료 부담 정책이 해당 지급 수단을 포함하거나, 하위 계정의 수수료를 관리할 권한이 있는 API 키가 필요합니다.API 레퍼런스
Create Payout API
지급 생성에 대한 전체 API 레퍼런스를 확인하세요
관련 리소스
하위 계정에 지급
하위 계정으로 자금 이체
지급 포털 렌더링
사용자가 자금을 출금할 수 있도록 하기

