SAFO 백오피스

가맹점·파트너가 직접 쓰는 포털(/portal)의 로그인 계정을 발급하고 관리하는 화면입니다. 스스로 가입하는 경로는 없고, 전부 여기서 만듭니다.

허용 IP

그 계정이 접속할 수 있는 IP. 하나도 없으면 로그인 자체가 안 됩니다 — 비어 있음을 ‘전부 허용’ 으로 읽지 않습니다.

대표 / 담당자

대표(owner)만 출금 요청을 할 수 있습니다. 담당자(member)는 조회만 합니다.

잠김

로그인 5회 실패하면 15분 잠깁니다. IP 가 틀려서 막힌 것도 실패로 셉니다.

IP 를 지우면 그 계정의 열려 있던 세션도 즉시 끊깁니다.

가맹점·파트너가 포털에서 보낸 출금(정산) 요청을 승인하고 지급을 기록하는 화면입니다. 회차 마감과는 다른 경로로, 잔액에서 당겨가는 방식입니다.

요청 시점 잔액 / 현재 잔액

요청 뒤에 회차가 돌았으면 두 숫자가 달라집니다. 승인 전에 현재 잔액을 보세요.

상계

여기서 먼저 나간 금액만큼 다음 회차의 지급 지시가 줄어듭니다. 같은 돈이 두 번 나가지 않게 하는 장치입니다.

지급 기록

보내는 것은 사람이고 여기는 그 사실을 적는 칸입니다. tx id 는 한 번만 쓸 수 있습니다.

출금 요청이 들어오면 텔레그램 그룹챗으로 알립니다. 봇 토큰과 그룹챗 id 를 여기에 넣으면 그 방으로 메시지가 갑니다.

봇 토큰

마스터 키로 봉인해 보관합니다. 한 번 넣으면 화면에 다시 보여주지 않습니다 — 보여주는 순간 그 화면도 토큰의 보관처가 됩니다.

그룹챗 id

그룹은 보통 음수입니다(-100… 형태). 봇을 방에 먼저 초대해야 보낼 수 있습니다.

건너뜀(SKIPPED)

설정이 없어서 안 보낸 것입니다. 실패와 다릅니다 — 고칠 사람도 고칠 것도 다릅니다.

내가 볼 수 있는 가맹점과, 가맹점마다의 연동 정보를 보는 화면입니다. 왼쪽에서 가맹점을 고르면 오른쪽에 그 가맹점의 설정이 나옵니다.

콜백 엔드포인트

결제 상태가 바뀔 때 알림(웹훅)을 받는 가맹점 서버 주소입니다. 가맹점 하나에 여러 개를 둘 수 있고, 주소마다 받을 이벤트를 고릅니다.

요율

가맹점이 결제 한 건마다 내는 수수료율입니다.

담당 노드

이 가맹점이 속한 에이전트(또는 마스터)입니다. 수수료 배분이 이 소속을 따라갑니다.

결제창 오리진

결제창을 띄울 수 있는 가맹점 사이트 주소입니다. 등록한 사이트에서만 결제창이 열립니다.

API 시크릿

발급할 때 한 번만 보입니다. 잃어버리면 재발급해야 하고, 이전 시크릿은 즉시 무효가 됩니다.

가맹점 서버로 보낸 알림 한 건 한 건이 제대로 전달됐는지 확인하는 화면입니다. 가맹점이 "결제 알림을 못 받았다"고 할 때 여기를 봅니다.

이벤트

무슨 일을 알렸는지입니다. 예: payment.confirmed 는 결제 확정.

DELIVERED

가맹점 서버가 정상 응답(200번대)을 돌려준 전송입니다.

FAILED

다시 보내기를 모두 시도했지만 가맹점 서버가 받지 못한 전송입니다. 응답 칸에 가맹점 서버가 돌려준 오류가 나옵니다.

시도

같은 알림을 보낸 횟수입니다. 실패하면 간격을 두고 다시 보냅니다.

보는 방법: 가맹점 목록에서 가맹점을 고른 뒤 콜백 엔드포인트의 ‘이력’ 을 누릅니다.

가맹점이 “결제가 안 된다” 고 문의했을 때 원인을 찾는 화면입니다. API 호출 실패, 콜백 전송 실패, 결제 흐름의 사고를 한 목록에서 시간순으로 봅니다. 내 범위의 가맹점 건만 보입니다.

요청 id / 전송 id

가맹점이 받은 오류 응답이나 콜백에 적혀 있는 번호입니다. 가맹점이 알려준 값을 그대로 붙여넣으면 그 건을 바로 찾습니다.

종류

API 호출은 가맹점이 우리 API 를 부르다 실패한 것, 콜백 전송은 우리가 보낸 알림을 가맹점 서버가 받지 못한 것, 결제 흐름은 미달 입금·만료처럼 결제 자체에서 생긴 일입니다.

진단 안내

건을 고르면 무슨 일인지, 거래가 반영됐는지, 누가 무엇을 해야 하는지가 위쪽에 나옵니다. 가맹점에 그대로 안내하면 됩니다.

코드 칩

장애 종류별 건수입니다. 누르면 그 종류만 보이고, 다시 누르면 풀립니다.

재전송

실패한 콜백을 다시 보내는 기능입니다. 횟수와 기간에 제한이 있어, 가맹점 서버의 원인을 먼저 고친 뒤에 누릅니다.

장애 기록은 일정 기간만 보관됩니다. 보관 기간은 조회 칸 아래에 표시됩니다.

청구액보다 적게 들어온 결제를 모아 보는 화면입니다. 얼마나 자주, 얼마나 부족하게 들어오는지 봅니다.

부족

청구액에서 실제 입금액을 뺀 금액입니다.

부족분 중앙값

부족 금액들을 크기순으로 세웠을 때 가운데 값입니다. 평균보다 한두 건의 큰 값에 덜 흔들립니다.

허용 오차

이만큼 부족해도 결제로 인정하는 한도입니다. 올리면 미달 결제가 줄지만 그만큼을 가맹점이 부담합니다.

이미 끝난 주문의 입금 주소로 뒤늦게 들어온 자금을 찾아 처리하는 화면입니다. 주문이 만료된 뒤에 고객이 송금한 경우가 여기에 잡힙니다.

스캔

끝난 주문의 주소를 주기적으로 다시 살펴 잔액이 생겼는지 확인하는 작업입니다.

발견

잔액이 확인됐지만 아직 처리하지 않은 건입니다.

회수 예약

정산 지갑으로 옮기도록 예약한 건입니다.

더스트

옮기는 데 드는 네트워크 비용보다 작은 소액입니다. 회수하면 오히려 손해라 그대로 둡니다.

무시

운영자가 처리하지 않기로 표시한 건입니다.

확정된 입금이 모이는 지갑과, 입금 자금을 검사하는 기준을 설정하는 화면입니다.

정산 지갑

확정된 입금을 주문별 주소에서 모아 두는 지갑입니다. 정산 지급이 여기서 나갑니다.

격리 지갑

검사에 걸린 자금을 정산 지갑과 섞지 않고 따로 보내는 지갑입니다. 정산 지갑과 반드시 달라야 합니다.

스크리닝

입금을 보낸 주소를 차단 주소 목록과 대조하는 검사입니다. 걸려도 결제는 확정되고, 가맹점에 경고가 전달되며 자금은 격리 지갑으로 갑니다.

차단 주소

걸러낼 주소 목록입니다. 목록에 정확히 그 주소가 있을 때만 걸립니다.

정산 관련 설정값을 확인하고, 누가 무엇을 바꿨는지 기록을 보는 화면입니다.

자동 스윕

확정된 입금을 주문별 주소에서 정산 지갑으로 자동으로 옮기는 기능입니다.

최소 스윕 금액

이 금액보다 작은 입금은 옮기지 않습니다. 옮기는 비용이 더 들기 때문입니다.

감사 로그

설정이나 요율을 바꾼 기록입니다. 바꾸기 전 값과 바꾼 뒤 값이 함께 남습니다.

본사 → 마스터 → 에이전트 → 가맹점으로 이어지는 소속 관계를 나무 모양으로 보는 화면입니다. 내 조직과 그 아래만 보입니다.

화살표와 이름

화살표는 아래 조직을 접고 펼칩니다. 이름을 누르면 오른쪽에 상세 정보가 나옵니다.

공급 요율

상위 조직이 이 업체에 주는 요율입니다. 단위는 bps 이고 100 bps 가 1% 입니다. 내 공급 요율과 내 아래 업체 요율의 차이가 내 수익이 됩니다.

고정액

결제 한 건마다 요율과 별도로 붙는 고정 수수료입니다.

직속 하위 / 전체 하위

바로 아래에 있는 업체 수와, 그 아래까지 모두 합친 수입니다.

요율과 조직 구성은 본사 오너 계정만 바꿀 수 있습니다.

고른 기간에 확정된 결제에서 각 조직이 가져간 수수료 몫을 보는 화면입니다.

자기 몫

그 조직 자신이 가져간 금액입니다. 아래 조직의 몫은 들어 있지 않습니다.

건수

그 조직에 수수료가 배분된 결제 건수입니다.

직속 하위 내역

바로 아래 조직 각각의 몫입니다. 그 아래까지 합친 값이 아닙니다.

기간

시작일은 포함하고 종료일은 포함하지 않습니다. 9월 한 달을 보려면 9월 1일 ~ 10월 1일로 고릅니다.

정산을 기간 단위로 끊어 확정하는 화면입니다. 마감된 회차의 목록을 여기서 확인합니다.

회차

정산을 끊는 기간 한 단위입니다. 예: 9월 1일부터 10월 1일 전까지가 한 회차.

마감

그 기간에 들어온 결제를 모아 “누구에게 얼마를 지급할지” 를 확정하는 일입니다. 마감하면 지급 지시가 만들어지고, 마감한 회차의 숫자는 바뀌지 않습니다.

미리보기

마감하기 전에 숫자만 계산해 보는 기능입니다. 아무것도 저장하지 않습니다.

대사

정산 입금액이 가맹점 몫 + 노드 몫 + 플랫폼 몫의 합과 정확히 맞는지 확인하는 검산입니다. 맞지 않으면 마감되지 않습니다.

이월

최소 지급액에 못 미치거나 지급 주소가 없어 이번에 보내지 못하고 다음 회차로 넘긴 금액입니다.

마감은 본사 오너 계정이 실행합니다. 다른 계정은 마감된 회차를 조회합니다.

마감된 회차에서 대상별로 얼마를 어느 주소로 지급하는지, 그리고 실제로 지급됐는지 보는 화면입니다.

지급 지시

지급 대상 한 곳에 대한 한 줄입니다. 대상(가맹점 또는 조직), 금액, 지급 주소가 적혀 있습니다.

보낼 차례 / 지급 완료

아직 보내지 않은 지시와, 보낸 뒤 트랜잭션 id 를 기록한 지시입니다.

tx

지급을 보낸 블록체인 트랜잭션 id 입니다. 송금은 운영자가 직접 하고, 여기에는 그 id 만 기록합니다.

체인 검증

기록한 트랜잭션을 블록체인에서 다시 읽어 금액과 받는 주소가 지시와 같은지 대조한 결과입니다.

체인 일치 / 불일치 / 체인에 없음

지시와 같음 / 금액이나 주소가 다름 / 그 트랜잭션을 찾지 못함. 불일치와 없음은 사람이 확인해야 합니다.

정산금을 받을 TRON 주소를 등록하고, 지금 어떤 주소로 지급되는지 확인하는 화면입니다.

효력 있는 주소

지금 지급에 실제로 쓰이는 주소입니다.

대기 중 주소

새로 등록했지만 아직 적용되지 않은 주소입니다. 대기 시간이 지나야 효력이 생깁니다.

대기 시간을 두는 이유

계정이 도용되어 주소가 바뀌더라도 바로 그 주소로 지급되지 않게 하기 위해서입니다. 대기 중에 이상을 발견하면 막을 수 있습니다.

변경 이력

주소를 언제 요청했고 언제 효력이 생겼는지의 기록입니다.

주소가 등록되지 않은 대상은 지급되지 않고 다음 회차로 이월됩니다.