결제 채널
관리자 메뉴 위치: Finance › Payment channels (
/payments). 스위치 및 수수료 설정: Finance › Payment channels › Fees & limits (/payments/fees).
NexCMP는 선불 USD 지갑 시스템을 사용합니다. 고객은 결제 채널을 통해 지갑에 잔액을 충전하며, 모든 서비스 이용 요금은 지갑에서 차감됩니다. 채널은 활성화 및 설정이 모두 완료된 경우에만 고객에게 표시됩니다.
작동 내용
결제 채널은 결제 계정(Stripe, PayPal, Binance, 베트남 은행 등)을 고객 지갑과 연결합니다. 결제가 완료되면 정확히 하나의 지갑 크레딧이 생성됩니다. 각 크레딧은 게이트웨이 결제 ID로 식별되므로 웹훅이 중복 수신되어도 잔액이 두 번 충전되지 않습니다. 이 페이지에서 준비된 채널, 지난 30일간의 실적, 주의가 필요한 채널을 확인할 수 있습니다.
요구 사항
| 항목 | 요구 사항 |
|---|---|
| 공용 HTTPS 주소 | 게이트웨이가 https://<domain>/v1/billing/...(으)로 웹훅을 전송하므로, 패널은 유효한 TLS를 통해 인터넷에서 접근할 수 있어야 합니다(DNS and Cloudflare 참고). |
| 계정 | 사용하려는 각 제공업체의 자체 계정입니다. 자격 증명은 관리자 페이지에 입력되며 다시 표시되지 않고 마지막 4글자만 표시됩니다. |
| 관리자 역할 | 관리자 계정입니다. |
| 의존성 | 없음. VN 은행 채널에는 환율이 추가로 필요합니다. |
지원 채널
| 채널 | 고객 화면 | 설정 위치 | 문서 |
|---|---|---|---|
| 카드 (Stripe) | 카드 양식, 저장된 카드 | Payment channels › Stripe | Stripe |
| Apple Pay, Google Pay, Link | 월렛 버튼 (Stripe Express Checkout) | Stripe 및 도메인 등록 | Stripe |
| Alipay | Alipay로 리디렉션 (Stripe에서 JPY로 청구) | Stripe 및 Fees & limits | Stripe |
| PayPal | PayPal 버튼, 저장된 PayPal 계정 | Payment channels › PayPal | PayPal |
| USDT | 입금 주소 및 정확한 금액 | Payment channels › USDT | USDT |
| VN 은행 송금 | QR 코드 및 송금 세부 정보 (베트남어 인터페이스 전용) | Payment channels › VN bank transfer 메뉴 | Bank transfer (Vietnam) |
인프라 준비
필요하지 않습니다. 모든 설정은 관리자 페이지에서 이루어지며 서버에 설치할 항목이 없습니다.
NexCMP에서 연결
- Finance › Payment channels(
/payments)을 엽니다. 개요 표에 각 채널과 상태가 나열됩니다. - 각 채널의 탭(Stripe, PayPal, USDT, VN bank transfer)을 열고 관련 문서를 따릅니다. 각 탭의 하단에는 Save 버튼과 (사용 가능한 경우) Test 버튼이 있습니다.
- Fees & limits(
/payments/fees)을 열고 카드 **Payment gateways & fees (wallet top-up)**을 찾은 후, 스위치를 켜고 Save channels & fees를 클릭합니다.
스위치 및 수수료 (Fees & limits)
| 설정 | Default | 의미 |
|---|---|---|
| 카드 (Stripe) | On | 예치 화면의 카드 양식. Stripe 비밀 키가 설정될 때까지 숨겨집니다. |
| Apple Pay, Google Pay, Link | On | 월렛 버튼. Stripe에서 도메인이 인증된 경우에만 표시됩니다. |
| Alipay | 꺼짐 | Stripe 대시보드에서 Alipay가 활성화되어 있어야 합니다. |
| PayPal | 꺼짐 | PayPal이 설정된 경우에만 표시됩니다. |
| USDT (Binance) | 꺼짐 | Binance에서 입금 주소가 검증될 때까지 스위치가 잠깁니다. |
| Stripe 수수료 % / 고정 금액 (센트) | 3.6 % 및 0 | 고객에게 수수료를 표시하고 적립 금액을 계산하는 데 사용됩니다. 실제 Stripe 요율로 설정하세요. |
| PayPal 수수료 % / 고정 금액 | 4.4 % 및 30 센트 | PayPal용 동일 설정. |
| USDT 수수료 % | 1 % | USDT용 동일 설정. |
| 고객이 충전 수수료 부담 | 꺼짐 | On: 고객이 금액 + 수수료를 결제하고 지갑에는 전액이 충전됩니다. Off: 수수료가 차감된 후 남은 금액이 지갑에 충전됩니다. |
고객은 결제 전에 항상 수수료와 최종 지갑 크레딧을 확인합니다. 채널을 끄면 버튼이 숨겨지고 서버는 method_disabled (HTTP 403)과 함께 새로운 결제를 거부합니다.
충전 한도
충전당 최소 및 최대 금액은 동일한 페이지에 있습니다 — Minimum top-up을 참고하세요.
확인
- 요약 표에서 해당 채널은 Enabled 및 Configured로 표시되며, Test을 클릭한 후 Last test 열이 채워집니다.
- 테스트 고객으로 포털에 로그인한 후 Billing › Deposit을 엽니다. 결제 채널 버튼이 표시됩니다.
- 소액을 결제합니다 (테스트 카드 또는 샌드박스 계정에 대해서는 해당 채널 문서 참고). 잔액이 증가하고 Top-up received 알림이 표시되며, 결제 내역이 Finance › Billing › Top-ups에 나열됩니다 (
/billing/deposits).
한도 및 참고 사항
- 요약 열: 30 days (결제 건수, 성공, 실패 및 볼륨), Stuck 24h (하루가 지나도 대기 중인 결제) 및 Unmatched (도착했으나 주문과 일치하지 않는 USDT 또는 은행 송금). KPI 행에는 30일 볼륨, 오류 채널 수 (활성화되었으나 설정되지 않았거나 결제 지연됨) 및 총 미일치 건수가 추가됩니다.
- 웹훅 이벤트는 Payment channels › Gateway events에 나열됩니다 (
/payments/events). Stripe에는 전용 탭이 있으며, PayPal과 USDT는 탭을 공유합니다. 실패한 이벤트는 재전송할 수 있습니다 — 지갑 원장은 멱등성이 유지되므로 재전송해도 중복 크레딧이 발생하지 않습니다. - Resellers는 자체 Stripe, PayPal, USDT 및 은행 채널을 가질 수 있습니다. 이들의 행도 여기에 표시되며 상단의 사이트 선택기로 필터링할 수 있습니다. Resellers를 참조하세요.
- 환불: Stripe 및 PayPal 결제는 결제 목록에서 환불할 수 있으며, USDT 결제는 원본으로 환불할 수 없습니다 (서버가
usdt_no_refund로 응답함). - 유지보수 모드에서도 게이트웨이 웹훅을 계속 수신하므로, 유지보수 직전에 이루어진 결제는 유실되지 않습니다.
Troubleshooting
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 고객의 입금 화면에 채널이 누락됨 | 꺼져 있음, 설정되지 않음, 또는 (베트남 은행) 인터페이스가 베트남어가 아님 | Fees & limits 및 채널 탭을 확인하세요; Bank transfer (Vietnam)을 참고하세요. |
| KPI Faulty channels가 0보다 큼 | 자격 증명 없이 채널이 활성화되었거나 24시간 이상 결제가 대기 중임 | 행을 열고 Configure를 클릭하세요. 지연된 결제의 경우 Gateway events를 열고 재전송하세요. |
| 고객은 결제했으나 잔액이 변경되지 않음 | 웹훅이 도착하지 않음 | 채널 탭에서 웹훅 URL을 확인한 후 Gateway events에서 이벤트를 다시 전송하세요. |
서버 응답 method_disabled | 스위치가 꺼져 있음 | Fees & limits에서 켜고 저장하세요. |
| USDT 스위치가 회색으로 비활성화됨 | 입금 주소가 확인되지 않음 | USDT 탭에서 Test & verify address를 클릭하세요. |