무엇을 도와드릴까요?

자주 묻는 질문부터 직접 문의까지 한 곳에서 해결하세요.

FAQ

자주 묻는 질문

Unifi Pay 서비스에 대해 자주 묻는 질문을 확인하세요.

Unifi Pay Direct는 사용자가 별도의 사전 심사 없이 직접 연동 설정을 진행할 수 있는 스마트 컨트랙트 프로그램입니다. 결제 대금은 Unifi Pay에 보관되지 않으며, 스마트 컨트랙트에 따라 판매자의 정산 지갑으로 분배됩니다.
Unifi Pay Direct는 스테이블코인 거래를 지원하는 스마트 컨트랙트 프로그램입니다. 사용자는 결제 링크 또는 API를 통해 프로그램을 연동할 수 있으며, 결제 대금은 Unifi Pay에 보관되지 않고 스마트 컨트랙트에 따라 판매자의 정산 지갑으로 직접 분배됩니다.
Direct는 별도의 사전 심사 없이 콘솔에서 가입 후 셀프 연동 설정 절차를 통해 사용할 수 있습니다.
별도의 가입비·초기 세팅비는 없으며, 스마트 컨트랙트 사용 수수료로 결제 금액에 대한 Protocol Fee 1%는 스마트 컨트랙트에 따라 결제 시 자동으로 분배됩니다.
App ID는 시스템 내부에서 사용하는 식별자로, 가입 시 자동으로 부여됩니다. 판매자 정보 등록 단계에서 직접 입력하는 항목이 아니며, 내부 식별자이므로 콘솔 화면에는 표시되지 않습니다. 기존에 발급된 App ID는 그대로 유지되므로 별도의 재발급이나 이전 작업은 필요하지 않습니다.
네, 스토어는 콘솔에서 직접 생성해 여러 개 운영할 수 있습니다. 결제 통화(USDT/JPYC) 선택은 기본 정보가 아니라 스토어 생성 시점에 스토어별로 설정합니다.
정산 지갑은 연동 설정 과정에서 판매자가 직접 등록합니다. ① 보유하고 있는 외부 지갑 또는 거래소 지갑 주소를 직접 입력하거나(Kaia Mainnet) ② Unifi Wallet을 연결하는 두 가지 방식 중 선택할 수 있으며, 자금은 등록된 정산 지갑으로 스마트 컨트랙트에 따라 분배됩니다. 다만 환불 송금은 정산 지갑 등록 방식과 무관하게 Unifi Wallet으로만 이용할 수 있습니다. ①번 방식으로 정산 지갑을 등록하신 경우에도 환불 송금을 위해서는 별도로 Unifi Wallet을 생성해야 하며, 환불하실 금액과 송금 수수료를 충당할 수 있는 잔액을 해당 Unifi Wallet에 미리 준비해 두셔야 합니다.
제출하지 않습니다. 판매자 정보 등록 단계에서는 사업 형태(개인/개인사업자/법인/기타), 서비스명, 서비스 URL(선택), 운영 국가만 입력합니다.
Kaia 블록체인 기반 스테이블코인인 USDT, JPYC 중 선택할 수 있으며(스토어별로 1개 또는 2개 모두 선택 가능), IDRP는 순차적으로 지원 예정입니다.
결제받은 스테이블코인은 별도 환전 과정 없이 스마트 컨트랙트에 따라 정산 지갑(Kaia Mainnet)으로 분배됩니다. 법정화폐 정산은 지원하지 않습니다.
결제가 발생하면 결제 대금은 별도 정산 주기 없이 스마트 컨트랙트에 따라 즉시 정산 지갑으로 분배됩니다.
네, 주문 통화 기준 최소 0.01 USD / 1 JPY, 최대 999,999 USD / 999,999,999 JPY이며, 결제 통화 기준 최소 0.01 USDT / 1 JPYC, 최대 9,999,999 USDT / 999,999,999 JPYC입니다. 결제 통화 최소 금액보다 낮은 소액 상품은 해당 통화로 결제가 지원되지 않을 수 있으니 유의해 주세요. (예시: 1엔 상품은 JPYC로 결제할 수 있지만, USDT로 환산하면 최소 결제 금액(0.01 USDT) 미만이 되어 USDT 결제가 지원되지 않을 수 있습니다.)
적용되지 않습니다. Direct 결제는 Unifi Reward 페이백 이벤트 대상에서 제외됩니다.
네, 부분 환불도 가능합니다. 환불 여부, 금액 및 조건은 판매자가 구매자와 합의한 범위 안에서 부분/전체 환불을 직접 결정합니다. Unifi Pay는 이 결정이나 협의 과정에 관여하지 않으며, 콘솔은 판매자가 직접 송금할 수 있도록 환불 송금 보조 기능을 제공합니다. 판매자가 콘솔의 Refund 메뉴에서 본인의 Unifi Wallet로 직접 서명하여 송금을 실행하면 온체인 전송이 진행됩니다. 환불 송금은 Unifi Wallet을 통해서만 이용할 수 있으며, 구매자가 결제할 때 사용한 지갑 주소·네트워크로만 보낼 수 있습니다. 환불 송금은 원결제의 블록체인 정산이 완료된 이후에 실행할 수 있습니다. 결제 직후 정산이 처리되는 짧은 시간(통상 수 초) 동안에는 환불 신청이 제한되며, 정산이 완료되면 정상적으로 실행할 수 있습니다.
네, 실제 결제 전 연동 테스트가 가능한 Preview 환경(Kairos Testnet)을 제공합니다.
Direct API는 현재 v1과 v2 두 가지 버전을 제공하고 있습니다. 신규로 연동을 진행하시는 파트너사는 반드시 최신 버전인 v2를 적용해 주시기를 바랍니다. 기존에 v1으로 연동하신 파트너사의 경우 당분간 기존 버전을 그대로 사용하실 수 있습니다. 하지만 v1 서비스가 무한정 제공되는 것은 아니므로, 가급적 빠른 시일 내에 v2로 전환해 주시기를 권장해 드립니다. v1과 v2는 요청 및 응답 형식이 동일하고 호출 경로만 다릅니다. 다만, 인증에 사용하는 서명(Signature) 값에 호출 경로가 포함되기 때문에 v2로 전환하실 때는 API 주소뿐만 아니라 서명을 생성하는 로직도 함께 수정해 주셔야 하는 점 참고 부탁드립니다.
API 키 재발급은 콘솔에서 셀프로 진행할 수 있습니다. 재발급 시 이전 키는 사용 권한이 만료되어 신규 결제 링크 생성과 거래 내역 조회는 불가능하지만, 이전 키로 이미 생성된 결제 링크는 계속 정상 작동합니다.
결제 링크는 개수 제한 없이 생성할 수 있습니다. 링크마다 24시간 / 7일 / 30일(기본) / 90일 중 유효기간을 선택하며, 기간이 지나면 자동으로 만료되어 더 이상 결제를 받을 수 없습니다. 생성한 링크는 콘솔에서 목록으로 관리하거나 강제로 만료시킬 수도 있습니다.
콘솔에서 직접 등록할 수 있으며, allowlist는 최대 5개까지 지원합니다. https:// 형식만 허용됩니다. 등록은 선택 사항이며, 결제 링크만 사용하는 경우에는 등록하지 않아도 됩니다.
결제 취소라는 별도 기능은 없으며, 이미 완료된 결제를 되돌리려면 판매자가 구매자에게 환불 송금을 직접 실행해야 합니다. 결제 대금은 Unifi Pay에 보관되지 않고 스마트 컨트랙트에 따라 정산 지갑으로 분배되므로, 플랫폼에 별도로 보관된 자금을 회수해 취소하는 구조가 아닙니다. 환불 API는 제공되지 않습니다. 콘솔에서 제공하는 환불 기능은 판매자가 콘솔의 Refund 메뉴에서 본인의 Unifi Wallet로 직접 서명하여 실행하는 신규 송금입니다. 외부 지갑으로 정산 지갑을 등록하신 경우에도 환불에는 별도의 Unifi Wallet 준비가 필요합니다. 환불 시 Protocol Fee 1%는 반환되지 않으며, 환불 금액은 원결제 시 수령한 스테이블코인 수량을 기준으로 산정하고, 환율 변동 등에 따른 별도의 재산정은 이루어지지 않습니다. 환불 송금은 원결제의 블록체인 정산이 완료된 이후에 실행할 수 있습니다. 결제 직후 정산이 처리되는 짧은 시간(통상 수 초) 동안에는 환불 신청이 제한됩니다.
계정 보안을 위해 로그인 인증번호는 24시간 동안 5회까지 받으실 수 있습니다. 비밀번호 재설정 인증번호도 각각 5회까지 가능합니다. 한도를 초과하면 24시간 후에 다시 받으실 수 있습니다.
CONTACT US

문의하기

FAQ로 해결되지 않는 내용은 직접 문의해 주세요. 영업일 기준 1~2일 내 순차적으로 답변드리고 있습니다.
기술지원 이메일 채널(pay-support@unifi.me)