이 문서는 Unifi Pay Direct 이용 가이드입니다. Direct는 사용자가 별도의 사전 심사 없이 직접 연동 설정을 진행할 수 있는 스마트 컨트랙트 프로그램입니다. 본 가이드에서는 프로그램 연동 설정부터 결제, 정산, 환불 송금 보조 기능, 계정 해지 및 지원 환경까지 전체 이용 흐름을 안내합니다.

이미 별도 절차를 거쳐 온보딩이 완료된 Classic 가맹점은 본 가이드의 대상이 아니므로, 관련 문의는 담당자에게 별도로 요청해 주세요.

연동 설정 절차

콘솔 가입부터 API Key 발급까지 직접 설정

정산 및 결제 흐름

스마트 컨트랙트를 통한 즉시 정산 구조와 결제 링크·API 연동 방식

환불(송금 보조 기능)

판매자가 구매자에게 직접 송금할 수 있도록 기능 지원

탈퇴 및 해지

기술지원 채널을 통한 계정 해지 요청

지원 환경

지원 코인, 네트워크 등 환경 정보

1. Unifi Pay Direct란

Unifi Pay Direct는 사용자가 별도의 사전 심사 없이 직접 연동 설정을 진행할 수 있는 스마트 컨트랙트 프로그램입니다.

이용 대상 사업자등록번호 없이 개인·개인사업자·법인 등이 이용 가능. 단, 이용약관과 이용정책 및 지원 환경에 따른 제한이 적용될 수 있습니다.
연동 설정 콘솔에서 사용자가 직접 연동 설정
정산 방식 결제 즉시 스마트 컨트랙트에 따라 사용자가 등록한 정산 지갑으로 결제 대금이 즉시 분배됩니다.
수수료 거래 금액의 1%가 스마트 컨트랙트에 따라 Protocol Fee로 자동 분배됩니다.
결제 수단 Unifi Wallet에서 지원하는 스테이블코인(USDT/JPYC) 중 선택(스토어별로 하나 또는 두 자산을 모두 설정 가능하며, IDRP는 순차적으로 지원 예정)
연동 방식 결제 링크 생성 기능(No-code) 또는 API 연동 중 선택
환불(송금 보조 기능) 기존 결제를 취소하는 방식이 아니라, 판매자가 구매자에게 직접 송금하는 보조 기능을 제공
페이백 프로모션 적용 대상에서 제외

2. 셀프 연동 설정 절차

콘솔 가입부터 결제 시작까지 사용자가 직접 연동 설정을 진행할 수 있습니다.

1
콘솔 가입
2
판매자 정보 등록
3
정산 지갑 등록
4
스토어 설정
5
API 키 발급 (선택)
✓
연동 완료
1

콘솔 가입

별도의 사전 심사 없이 약관 동의 후 가입할 수 있으며, 가입과 동시에 Owner 권한이 자동으로 부여됩니다.

2

판매자 정보 등록

App ID(저장 후 영구 잠금), 사업 형태(개인/개인사업자/법인/기타), 서비스명, 서비스 URL(선택), 운영 국가를 입력하고 필수 확인·동의 항목 5개와 이용정책(AUP)에 동의합니다. App ID는 저장 후 변경할 수 없으므로 등록 전에 정확하게 확인해 주세요.

3

정산 지갑 등록

결제 대금은 Kaia Mainnet 지갑으로만 수령할 수 있습니다. 지원 결제 수단인 USDT와 JPYC가 Kaia 블록체인을 기반으로 처리되므로, 정산 지갑도 Kaia Mainnet 주소여야 합니다. 결제 대금을 수령하려면 정산 지갑 등록이 필수이며, 아래 두 가지 방식 중 하나를 선택할 수 있습니다. 잘못된 지갑 주소를 등록하면 정산이 정상적으로 처리되지 않거나 자산을 복구하기 어려울 수 있으므로, 등록 전에 지갑 주소와 네트워크를 반드시 확인해 주세요.

환불 송금 기능 이용 시 유의사항
환불 송금 보조 기능은 정산 지갑 등록 방식과 관계없이 Unifi Wallet을 통해서만 이용할 수 있습니다. 외부 지갑을 정산 지갑으로 등록한 경우에도 환불 송금 기능을 이용하려면 별도의 Unifi Wallet이 필요합니다. 환불을 실행하기 전에 해당 Unifi Wallet에 환불할 자산과 네트워크 수수료를 충당할 수 있는 잔액을 준비해 주세요. 정산과 환불 송금은 서로 독립적으로 실행되는 별개의 기능입니다.

① 지갑 주소 직접 입력

Kaia Mainnet을 지원하는 외부 지갑 또는 거래소 지갑의 주소를 직접 입력합니다. Web3 지갑과 네트워크 개념에 익숙하고 지갑 주소를 직접 관리할 수 있는 사용자에게 적합합니다.

② Unifi Wallet 연결

Web3 이용이 익숙하지 않거나 별도의 지갑 관리가 부담스러운 경우 권장합니다. Unifi 계정으로 로그인한 후 Unifi Wallet을 연결하면 등록이 완료됩니다.

4

스토어 설정

콘솔에서 스토어 정보를 직접 생성하고 설정합니다. 스토어 생성 과정에서 구매자가 사용할 결제 수단인 USDT와 JPYC를 선택할 수 있습니다. 스토어별로 하나의 결제 수단만 선택하거나 두 결제 수단을 모두 설정할 수 있습니다.

5

API 키 발급 (선택)

자체 서비스에 API로 직접 연동하려는 경우 콘솔에서 API Key를 발급받습니다. 콘솔의 결제 링크 생성 기능만 이용하는 경우에는 API Key를 발급하지 않아도 됩니다.

가입 시 Unifi Console 이용약관과 Unifi Pay Console 이용약관에 동의해야 합니다. 또한 서비스 유형, 서비스명, URL, 운영 국가 등 기본 운영 정보를 변경할 때에는 필수 확인 항목과 이용정책(AUP)을 다시 확인하고 동의해야 합니다.

API 키 발급 상세

발급 위치 콘솔 > 연동 정보 탭
발급 종류 Production 환경에서 사용하는 API Key를 발급합니다. 발급 버튼을 누르면 API Key, Secret 및 발급 일시가 표시됩니다.
Secret 노출 Secret은 발급 화면에서만 전체 값이 1회 표시됩니다. 이후에는 마스킹된 값과 발급 일시만 확인할 수 있으며, 전체 값을 다시 조회할 수 없습니다.
분실 시 콘솔에서 셀프 재발급(Regenerate)할 수 있습니다. 재발급 시 이전 키는 사용 권한이 만료되어 신규 결제 링크 생성과 거래 내역 조회는 불가능하지만, 이전 키로 이미 생성된 결제 링크는 계속 정상 작동합니다.
발급 필수 여부 선택 사항입니다. 결제 링크 생성 기능만 이용하는 경우에는 발급하지 않아도 되며, API로 직접 연동할 때만 필요합니다.
콜백 도메인 최대 5개까지 직접 등록할 수 있습니다. 선택 항목이며 https:// 형식만 허용됩니다.
Preview(테스트) 환경 콘솔에서 별도의 API Key를 발급하지 않고 외부 Preview 콘솔을 통해 이용합니다.

3. 정산 방식

결제가 완료되는 즉시 스마트 컨트랙트가 실행되어, Protocol Fee 1%를 제외한 결제 대금이 판매자가 등록한 정산 지갑으로 직접 분배되는 구조로 별도의 정산 주기가 없습니다.

즉시 정산

결제가 완료되면 별도의 정산 주기 없이 등록된 정산 지갑으로 결제 대금이 즉시 분배됩니다. Protocol Fee 1%도 스마트 컨트랙트에 따라 결제와 동시에 자동 분배됩니다.

1
결제 완료
✓
정산 지갑으로 즉시 분배

3.1 결제 수단

1 주문 표시통화

구매자 화면에 주문 금액을 표시할 때 사용하는 통화입니다. USD와 JPY를 지원합니다. KRW는 현재 지원하지 않으며, 오픈 이후 추가 지원 여부를 검토할 예정입니다.

2 결제 수단 (실결제)

구매자가 실제 결제에 사용하는 자산입니다. Kaia 블록체인 기반 스테이블코인인 USDT와 JPYC를 지원하며, IDRP는 순차적으로 지원할 예정입니다.

3 정산 수단

구매자가 결제한 스테이블코인이 별도의 환전이나 교환 과정 없이 그대로 판매자의 정산 지갑으로 분배됩니다.

  • ·정산 지갑은 Kaia Mainnet 지갑으로 한정됩니다.
  • ·Unifi Reward 페이백 프로모션 적용 대상에서 제외됩니다.

결제 금액 한도

주문 통화 최소 0.01 USD / 1 JPY
주문 통화 최대 999,999 USD / 999,999,999 JPY
결제 통화 최소 0.01 USDT / 1 JPYC — 결제 금액을 결제 수단으로 환산한 결과가 최소 지원 수량보다 작은 경우에는 해당 결제 수단을 이용할 수 없습니다. (예시: 1 JPY 상품은 JPYC로 결제할 수 있지만, USDT로 환산하면 최소 결제 금액(0.01 USDT) 미만이 되어 USDT 결제가 지원되지 않을 수 있습니다.)
결제 통화 최대 9,999,999 USDT / 999,999,999 JPYC

4. 결제 처리 흐름

별도의 개발 없이 콘솔에서 결제 링크를 생성하거나, API를 자체 서비스에 직접 연동할 수 있습니다.

4.2 API 연동

자체 서비스에 Direct 기능을 직접 연결하려는 경우 API를 이용할 수 있습니다. Direct API를 통해 결제를 생성하고 거래 내역을 조회할 수 있습니다.

1
Your Server → Unifi Pay

결제 생성

API를 호출하여 결제를 생성합니다.

2
Your Service

사용자 이동

응답으로 받은 startPageUrl로 구매자를 이동시킵니다.

3
Unifi Wallet

인증 및 결제

구매자가 Unifi Wallet을 통해 인증하고 결제를 진행합니다.

4
Your Service

결제 완료 및 복귀

결제가 완료되면 지정한 returnUrl로 구매자가 이동합니다.

5
Your Server

거래 내역 조회

Direct API를 통해 거래 내역을 조회할 수 있습니다.

API를 직접 연동하지 않더라도 콘솔의 결제 링크 생성 기능을 통해 결제를 생성할 수 있습니다. 환불 송금 API는 제공하지 않습니다.

5. 환불(송금 보조 기능)

Direct의 환불은 기존 결제를 취소하거나 이미 정산된 결제 대금을 회수하는 방식이 아닙니다. 판매자가 구매자에게 새로운 송금 거래를 직접 실행하는 방식으로 처리됩니다.

환불 여부, 금액 및 조건은 판매자와 구매자 간 협의를 통해 결정하며, Unifi Pay는 해당 결정이나 협의 과정에 관여하지 않습니다.

처리 주체 판매자가 Unifi Pay 콘솔의 ‘환불 관리’ 메뉴에서 본인이 관리하는 Unifi Wallet로 직접 서명하여 송금을 실행합니다.
API 제공 여부 환불 송금 기능은 콘솔에서만 제공합니다. 처리 과정에서 판매자의 지갑 서명이 필요하므로 API는 지원하지 않습니다.
환불 지갑 환불 송금 기능은 Unifi Wallet을 통해서만 이용할 수 있습니다. 외부 지갑을 정산 지갑으로 등록한 경우에도 별도의 Unifi Wallet이 필요합니다.
필요 잔액 환불을 실행하기 전에 Unifi Wallet에 환불할 자산과 네트워크 수수료를 충당할 수 있는 잔액이 있어야 합니다.
환불 주소 및 네트워크 원결제에 사용된 구매자 지갑 주소와 동일한 주소 및 네트워크로만 송금할 수 있습니다.
환불 금액 원결제 시 판매자가 수령한 스테이블코인의 수량을 기준으로 하며, 환율 변동 등에 따른 별도의 재산정은 이루어지지 않습니다. 실제 환불 수량은 판매자와 구매자 간 합의에 따라 판매자가 결정합니다.
환불 기준 Unifi Pay는 별도의 환불 기준이나 정책을 정하지 않습니다. 판매자와 구매자 간 협의가 완료된 건에 한하여 판매자가 직접 송금을 실행할 수 있는 보조 기능을 제공합니다.

Unifi Pay는 환불 자금을 보관하거나 회수하지 않으며, 판매자를 대신하여 환불 송금을 실행하지 않습니다.

6. 탈퇴 및 해지

콘솔에서 사용자가 직접 탈퇴하는 기능은 제공하지 않습니다. 이용 해지가 필요한 경우 기술지원 이메일 채널을 통해 요청해 주세요.

직접 탈퇴 미제공
해지 절차 기술지원 이메일로 해지 요청 → 요청 내용 확인 → 계정 비활성화 처리

7. 지원하는 환경

Unifi Pay에서 결제수단으로 사용하는 통화는 Kaia Blockchain 기반의 스테이블 코인입니다. 또한 연동 테스트 시 사용할 수 있는 Preview 환경을 제공합니다.

Preview 환경

Kairos Testnet (테스트넷)

Testnet

Preview 환경에서는 카이아 블록체인의 테스트넷인 Kairos 체인이 연동되며, 테스트 자금은 Faucet 서비스를 통해 확보할 수 있습니다.

Base URL https://app-api-pay.unifi.me

Production 환경

Kaia Mainnet (메인넷)

Mainnet

Production 환경에서는 카이아 블록체인의 메인넷인 Kaia 체인이 연동되며, 실 결제가 발생합니다.

Base URL https://api-pay.unifi.me

정산 지갑 및 환불 지갑은 Production 환경(Kaia Mainnet) 기준으로 한정하여 등록됩니다.