무엇을 도와드릴까요?

Unifi Pay Direct는 사용자가 별도의 사전 심사 없이 직접 연동 설정을 진행할 수 있는 스마트 컨트랙트 프로그램입니다. 결제 대금은 Unifi Pay에 보관되지 않으며, 스마트 컨트랙트에 따라 판매자의 정산 지갑으로 분배됩니다.

Unifi Pay Direct는 스테이블코인 거래를 지원하는 스마트 컨트랙트 프로그램입니다. 사용자는 결제 링크 또는 API를 통해 프로그램을 연동할 수 있으며, 결제 대금은 Unifi Pay에 보관되지 않고 스마트 컨트랙트에 따라 판매자의 정산 지갑으로 직접 분배됩니다.

Direct는 별도의 사전 심사 없이 콘솔에서 가입 후 셀프 연동 설정 절차를 통해 사용할 수 있습니다.

별도의 가입비·초기 세팅비는 없으며, 스마트 컨트랙트 사용 수수료로 결제 금액에 대한 Protocol Fee 1%는 스마트 컨트랙트에 따라 결제 시 자동으로 분배됩니다.

App ID는 시스템 내부에서 사용하는 식별자로, 가입 시 자동으로 부여됩니다. 판매자 정보 등록 단계에서 직접 입력하는 항목이 아니며, 내부 식별자이므로 콘솔 화면에는 표시되지 않습니다. 기존에 발급된 App ID는 그대로 유지되므로 별도의 재발급이나 이전 작업은 필요하지 않습니다.

네, 스토어는 콘솔에서 직접 생성해 여러 개 운영할 수 있습니다. 결제 통화(USDT/JPYC) 선택은 기본 정보가 아니라 스토어 생성 시점에 스토어별로 설정합니다. 스토어 설정에는 기본값 사용 토글이 있어, 이 토글을 켜면 파트너 기본값을 그대로 상속하고 끄면 해당 스토어에만 적용되는 값을 개별 설정합니다.

정산 지갑은 연동 설정 과정에서 판매자가 직접 등록합니다. ① Unifi Wallet을 연결하거나 ② 보유하고 있는 외부 지갑 또는 거래소 지갑 주소를 직접 입력하는(Kaia Mainnet) 두 가지 방식 중 선택할 수 있으며, 자금은 등록된 정산 지갑으로 스마트 컨트랙트에 따라 분배됩니다. Unifi Wallet은 Unifi 계정 소셜 로그인으로 간편하게 등록할 수 있습니다. 다만 환불 송금은 정산 지갑 등록 방식과 무관하게 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을 통해서만 이용할 수 있으며, 구매자가 결제할 때 사용한 지갑 주소·네트워크로만 보낼 수 있습니다. 환불 송금은 원결제의 블록체인 정산이 완료된 이후에 실행할 수 있습니다. 결제 직후 정산이 처리되는 짧은 시간(통상 수 초) 동안에는 환불 신청이 제한되며, 정산이 완료되면 정상적으로 실행할 수 있습니다.

네, 결제 링크 ID(linkId)와 조회 종료 시각(to)을 지정해 해당 링크의 거래 내역을 조회하실 수 있습니다. 웹훅은 가맹점 서버가 응답하지 않거나 5xx 오류를 반환하는 경우 정해진 간격으로 다시 보내드리지만, 재전송을 기다리지 않고 직접 확인하고 싶으실 때 이 방법을 사용하시면 됩니다. 결제 링크 거래 내역 조회는 v2 경로에서만 제공되며, 호출 방법은 API 레퍼런스를 참고해 주세요.

네, 실제 결제 전 연동 테스트가 가능한 Preview 환경(Kairos Testnet)을 제공합니다.

Preview와 Production은 로그인 세션이 각각 따로 관리되어, 같은 브라우저에서 두 환경을 번갈아 접속하면 앞서 로그인한 정보가 유효하지 않게 될 수 있습니다. 결제 화면에 오류가 표시되면 다시 로그인해 주세요.

Direct API는 현재 v1과 v2 두 가지 버전을 제공하고 있습니다. 신규로 연동을 진행하시는 파트너사는 반드시 최신 버전인 v2를 적용해 주시기를 바랍니다. 기존에 v1으로 연동하신 파트너사의 경우 당분간 기존 버전을 그대로 사용하실 수 있습니다. 하지만 v1 서비스가 무한정 제공되는 것은 아니므로, 가급적 빠른 시일 내에 v2로 전환해 주시기를 권장해 드립니다. v1부터 제공해 온 API는 v1과 v2의 요청 및 응답 형식이 동일하고 호출 경로만 다릅니다. 다만 v1.6.0에서 신설된 API(결제 링크 목록 조회, 결제 링크 강제 만료, 결제 링크 거래 내역 조회, 결제 내역 조회, 정산 내역 cursor 조회, 스토어 목록 조회, Blacklist)는 v2 경로에서만 제공되므로 v1에는 대응하는 호출 경로가 없습니다. 또한 인증에 사용하는 서명(Signature) 값에 호출 경로가 포함되기 때문에 v2로 전환하실 때는 API 주소뿐만 아니라 서명을 생성하는 로직도 함께 수정해 주셔야 하는 점 참고 부탁드립니다.

API 키 재발급은 콘솔에서 셀프로 진행할 수 있습니다. 재발급 시 이전 키는 사용 권한이 만료되어 신규 결제 링크 생성과 거래 내역 조회는 불가능하지만, 이전 키로 이미 생성된 결제 링크는 계속 정상 작동합니다.

결제 링크는 개수 제한 없이 생성할 수 있습니다. 링크마다 24시간 / 7일 / 30일(기본) / 90일 중 유효기간을 선택하며, 기간이 지나면 자동으로 만료되어 더 이상 결제를 받을 수 없습니다. 생성한 링크는 콘솔에서 목록으로 관리하거나 강제로 만료시킬 수도 있습니다. 링크를 생성하면 QR 코드가 함께 발급되며, 구매자는 Unifi 앱의 스캐너로 이 QR 코드를 인식해 결제를 진행할 수 있습니다.

QR 코드에는 링크를 만들 때 입력한 금액이 담기며, 결제가 완료된 뒤에도 링크와 QR은 유효기간이 남아 있는 동안 계속 사용하실 수 있습니다. 유효기간이 지나면 링크와 함께 QR도 만료되므로, 인쇄해 두고 사용하시는 경우에는 만료 시점을 확인해 주세요.

콘솔에서 직접 등록할 수 있으며, allowlist는 최대 5개까지 지원합니다. https:// 형식만 허용됩니다. 등록은 선택 사항이며, 결제 링크만 사용하는 경우에는 등록하지 않아도 됩니다.

허용 여부는 도메인 단위로 확인하므로, 등록하신 도메인이라면 그 뒤에 붙는 경로나 파라미터는 자유롭게 구성하실 수 있습니다. 예를 들어 자체 주문번호를 파라미터로 덧붙여 전달하셔도 됩니다. 등록하지 않은 도메인을 지정하면 결제 링크를 생성하는 단계에서 오류가 반환됩니다.

결제 취소라는 별도 기능은 없으며, 이미 완료된 결제를 되돌리려면 판매자가 구매자에게 환불 송금을 직접 실행해야 합니다. 결제 대금은 Unifi Pay에 보관되지 않고 스마트 컨트랙트에 따라 정산 지갑으로 분배되므로, 플랫폼에 별도로 보관된 자금을 회수해 취소하는 구조가 아닙니다. 환불 접수는 콘솔 또는 환불 API 로 가능합니다. 어느 경로든 환불은 판매자가 본인의 Unifi Wallet로 직접 서명하여 실행하는 신규 송금이며, 콘솔에서는 Refund 메뉴에서, API 로 접수한 경우에는 응답의 startPageUrl 페이지에서 서명합니다. 외부 지갑으로 정산 지갑을 등록하신 경우에도 환불에는 별도의 Unifi Wallet 준비가 필요합니다. 환불 시 Protocol Fee 1%는 반환되지 않으며, 환불 금액은 원결제 시 수령한 스테이블코인 수량을 기준으로 산정하고, 환율 변동 등에 따른 별도의 재산정은 이루어지지 않습니다. 환불 송금은 원결제의 블록체인 정산이 완료된 이후에 실행할 수 있습니다. 결제 직후 정산이 처리되는 짧은 시간(통상 수 초) 동안에는 환불 신청이 제한됩니다.

계정 보안을 위해 로그인 인증번호는 24시간 동안 5회까지 받으실 수 있습니다. 비밀번호 재설정 인증번호도 각각 5회까지 가능합니다. 한도를 초과하면 24시간 후에 다시 받으실 수 있습니다.

정산 내역 API 는 정산 대상 (CONFIRMED) 건만 돌려줍니다. 실패 (FAILED) 나 취소 (CANCELED) 를 포함한 전 상태의 결제는 결제 내역 조회 API 로 기간 조회하거나, 결제 링크 거래 내역 조회 API 로 링크 단위로 조회할 수 있습니다. 상세는 API 레퍼런스의 2.10 결제 링크 거래 내역 조회 API 와 2.11 결제 내역 조회 API 를 참고하세요.

결제 링크 발급과 관리 (목록 조회, 강제 만료, 거래 내역 조회), 결제 상태 확인, 환불 접수와 조회, 정산 내역과 결제 내역 조회, 스토어 목록 조회, 지갑 차단 관리를 API 로 처리할 수 있습니다. 인증은 API Key 와 HMAC 서명이며 상세는 API 레퍼런스를 참고하세요.

환불도 결제와 같은 상태값 (PENDING, PAID, CONFIRMED, FAILED) 으로 표시됩니다. 판매자가 직접 서명하는 환불은 서명 직후 PAID, 블록체인 확정 후 CONFIRMED 로 바뀌며 PENDING 구간이 없습니다.

실수령액은 결제 금액에서 Protocol Fee 1% 를 뺀 금액으로, 판매자 정산 지갑에 실제 분배되는 값입니다. 정산 내역과 지급 명세서의 정산 금액과는 별개의 값입니다.