TRON, BNB Smart Chain, Ethereum의 암호화폐 결제 최종성

TRON의 solidified 블록, BSC의 finalized 태그, Ethereum 에포크를 살펴보고 Suawave 확정 콜백을 받은 뒤 언제 주문을 이행할 수 있는지 알아보세요.

게시일 , 수정일

밝은 테이블 위 파란색, 투명색, 주홍색 유리 블록으로 표현한 암호화폐 결제 최종성

암호화폐 결제 최종성은 결제가 포함된 블록이 네트워크의 최종성 규칙을 충족하는 시점을 말합니다. 지갑이나 최근 블록에 트랜잭션이 보인다고 해서 반드시 이 시점에 도달한 것은 아닙니다. Suawave를 사용하는 판매자에게는 한 단계가 더 있습니다. 게이트웨이가 처리 가능한 입금을 정산하고 해당 출금 트랜잭션까지 확정한 뒤 확정 콜백을 보내야 합니다.

이 차이를 알면 흔한 문의를 이해할 수 있습니다. “지갑에서는 전송됐다고 나오는데 쇼핑몰은 아직 대기 중이에요.” 구매자와 쇼핑몰이 같은 결제의 서로 다른 단계를 말하는 것일 수 있습니다. 결제 화면은 정확한 완료 시각을 약속하는 타이머 대신 각 단계를 명확히 표시하는 것이 좋습니다.

판매자에게 결제 확정은 무엇을 뜻하나요?

Suawave 공개 API에서 pending이 "0"이면 입금액의 정산 전송이 이루어졌고 정산 트랜잭션도 확정되었다는 뜻입니다. 서명을 검증하고 입금을 주문과 대조한 뒤 이벤트 중복을 제거하고 금액을 판단하세요. 이 과정을 마친 뒤에만 애플리케이션이 주문을 결제 완료로 처리하거나 이행 작업을 예약해야 합니다.

주소 생성 시 pending=1을 지정하면 처리 가능한 입금이 감지될 때 pending이 "1"인 이벤트도 받을 수 있습니다. 감지는 별도의 mempool 구독이 아니라 인덱싱된 체인 데이터를 기반으로 합니다. 진행 상황을 표시하는 데 유용하지만 상품 발송의 근거로는 사용할 수 없습니다.

단계 확인된 사실 쇼핑몰에 표시할 내용
주소 생성 입금 목적지 할당 결제 대기 중
처리 가능한 입금 감지 인덱서가 일치하는 전송 확인 입금 감지됨
입금 최종성 검증 통과 입금 증거가 체인 정책 충족 정산 대기 계속
정산 확정 정산 트랜잭션 확정 확정 콜백 검토

공개 이벤트는 콜백 가이드에 정의되어 있습니다. 이 표의 모든 내부 단계에 별도 공개 콜백이 있는 것은 아닙니다. 연동에서 받을 수 없는 중간 웹훅을 가정하지 마세요.

게이트웨이는 왜 결제를 인정하기 전에 기다리나요?

구매자가 40 USDT를 보냈다고 가정해 보세요. 노드가 블록 1,000에 포함된 트랜잭션을 보고하고 블록 탐색기에 표시합니다. 이후 네트워크가 해당 최근 블록을 교체하면, 보이던 결제가 정규 체인에서 사라질 수 있습니다. 처음 관측한 사실만으로 결제를 인정하면 잠정적인 체인 데이터를 판매자의 잔액으로 취급하게 됩니다.

최종성 검증은 이러한 간극을 줄입니다. 트랜잭션 자체도 확인합니다. 성공한 트랜잭션 해시 하나만으로는 예상한 토큰이 예상 목적지로 예상 금액만큼 이동했는지 입증할 수 없습니다.

Suawave의 EVM 검증기는 트랜잭션 receipt를 정규 블록 헤더와 finalized 헤드에 대조합니다. 토큰 컨트랙트, 전송 당사자, 정수 금액을 확인하고 removed 로그는 거부합니다. TRON 경로에는 성공한 토큰 실행과 일치하는 solidified receipt 증거가 필요합니다. 일치하지 않는 전송은 정상 결제 처리 경로에 포함되지 않습니다.

따라서 화면 캡처로 검증된 콜백을 대체할 수 없습니다. 캡처에는 다른 자산, 다른 목적지, 게이트웨이 검증을 통과하지 않은 트랜잭션이 표시될 수 있습니다. 조사에 필요한 트랜잭션 해시는 지원 담당자에게 전달하되, 주문 업데이트는 실제 결제 증거를 기준으로 처리하세요.

TRON의 solidification은 어떻게 작동하나요?

TRON은 최신 체인 헤드와 solidified 헤드를 구분합니다. 블록 생성자는 Super Representative입니다. 활성 대표 27명 중 최소 19명이 해당 블록 위에 블록을 생성하면 그 블록이 solidified 상태가 됩니다. TRON 용어집에 따르면 solidified 헤드는 일반적으로 최신 헤드보다 약 1분 뒤처집니다.

Suawave의 TRON 레지스트리는 3초의 블록 간격과 solidified 최종성 정책을 사용합니다. 3초는 블록 간격이지 판매자가 결제를 최종 확정으로 취급할 수 있는 시간이 아닙니다. 브로드캐스트 이후 몇 초를 세는 방식은 블록 포함과 solidification을 모두 건너뜁니다.

검증기는 solidity 증거를 읽습니다. solidity receipt가 없으면 이전에 조회한 헤드 높이가 충분해 보이더라도 입금을 대기 상태로 둡니다. 풀노드에서 블록에 포함되었다는 사실만으로는 최종성을 입증할 수 없습니다. 일치하는 성공 토큰 전송 증거가 반드시 있어야 하므로 의도된 동작입니다.

컨펌 19회와 solidification은 같은 뜻인가요?

아니요. 이 규칙은 서로 다른 블록 생성자가 해당 블록 위에 블록을 생성하는 것에 관한 것입니다. 일반적인 컨펌 횟수만으로 이 규칙을 표현할 수는 없습니다. Suawave는 쇼핑몰이 탐색기의 숫자를 최종성 판단으로 변환하도록 요구하지 않고 solidified 뷰를 따릅니다.

입금이 이 검증을 통과한 뒤에도 리소스 준비와 USDT 정산 전송에 시간이 걸립니다. 결제 화면에 “TRON 블록은 3초이므로 결제도 3초면 완료됩니다”라고 표시하면 두 단계 모두에 잘못된 기대를 줍니다.

결제 흐름은 주소 생성, 입금 감지, 최종성 검증, 정산 확정 순서입니다. 입금 감지에서 바로 주문 이행으로 넘어가지 않도록 구현하세요.

BNB Smart Chain은 finalized 태그를 어떻게 사용하나요?

BNB Smart Chain 메인넷에서 Suawave 레지스트리는 finalized_tag를 선택하고 메인넷 제공자 설정은 finalized 헤더를 활성화합니다. 검증기에는 유효한 finalized 헤드가 필요하며, receipt의 블록 높이가 해당 헤드 이하인지 확인합니다. receipt가 정규 블록에 속하는지도 확인합니다.

BNB Chain RPC 문서는 latest, safe, finalized 블록 태그를 구분합니다. 이 값들은 체인 진행 상태를 서로 다른 관점에서 보여 줍니다. latest에서 receipt를 확인했다고 해서 이미 finalized 범위에 포함된 것은 아닙니다.

저장소에는 BSC 블록 간격이 450밀리초로 설정되어 있습니다. 공개 티커 가이드는 블록 포함 후 일반적인 확정 시간을 1분 미만으로 설명합니다. 어느 수치도 Suawave 정산과 콜백 전달의 모든 단계를 포함하지 않습니다. 주문 이행 기한이 아니라 대기 상태를 이해하기 위한 참고 정보로 사용하세요.

판매자가 더 적은 컨펌 수를 요청할 수 있나요?

공개 create 엔드포인트에서는 호출자가 컨펌 수를 지정할 수 없습니다. 더 빠른 최종성 정책을 구매하는 우선순위 설정도 제공하지 않습니다. API 레퍼런스의 지원 create 파라미터를 사용하세요. 다른 게이트웨이에서 복사한 파라미터가 작동할 것으로 추측해 추가하지 마세요.

콜백의 컨펌 수는 유용한 정보지만 주문 로직은 문서에 정의된 이벤트 의미를 따라야 합니다. “모든 네트워크에서 12컨펌이면 발송” 같은 임의의 규칙은 게이트웨이가 이미 처리하는 네트워크별 차이를 무시합니다.

Ethereum 에포크는 결제 최종성에 어떤 영향을 주나요?

Suawave에서는 Ethereum 메인넷이 아직 활성화되어 있지 않습니다. 여기서는 구조를 설명하고 추후 Ethereum 연동에 BSC의 가정을 그대로 적용하지 않도록 시간을 함께 소개합니다. Ethereum Sepolia 테스트넷을 사용할 수 있다고 해서 Ethereum 메인넷이 결제 경로로 제공되는 것은 아닙니다.

Ethereum 지분 증명 문서에 따르면 Ethereum은 시간을 12초 슬롯과 32슬롯의 에포크로 나눕니다. 따라서 한 에포크는 384초, 즉 6.4분입니다. 검증자는 체크포인트에 투표하며 최종성은 실행 블록 하나의 등장 대신 이 합의 과정을 따릅니다.

Suawave 티커 가이드는 블록 포함 후 일반적인 Ethereum 확정 시간을 약 13분으로 안내합니다. 이는 대략적인 예상치이며 타임아웃 규칙이나 모든 전송이 정확히 두 에포크 후 확정된다는 뜻이 아닙니다. 비활성 메인넷 레지스트리 항목은 finalized 태그 정책, 32슬롯 에포크, 12초 블록 간격을 사용합니다.

이 설정을 주문을 자동으로 결제 완료 처리하는 카운트다운으로 바꾸지 마세요. 최종성이 지연되더라도 실제 경과 시간으로 finalized 증거를 대체할 수는 없습니다.

네트워크 최종성 판단 기준
TRON 활성 대표 27명 중 최소 19명이 해당 블록 위에 블록 생성
BNB Smart Chain 정규 블록과 finalized 헤드 확인
Ethereum 6.4분 단위 에포크에서 이루어지는 체크포인트 합의

결제 최종성을 기다리는 동안 화면은 어떻게 동작해야 하나요?

새로 고쳐도 상태가 유지되는 대기 페이지를 제공하세요. 선택한 티커, 입금 주소, 주문 상태를 서버에 저장합니다. pending 콜백으로 입금이 감지되었음을 표시하면 불필요한 두 번째 결제를 줄일 수 있습니다.

브라우저의 복귀 URL은 서버 상태를 보여 주는 역할만 해야 합니다. 지갑 앱에서 돌아왔거나 QR을 스캔했거나 고객이 “결제했어요”를 눌렀다는 이유로 주문을 결제 완료 처리하면 안 됩니다. 전체 주소 및 콜백 흐름은 USDT 결제 구현 가이드를 참고하세요.

콜백 도착 순서가 바뀌어도 처리 상태가 뒤로 돌아가지 않도록 하세요. 지연된 pending 콜백이 확정된 입금을 대기 상태로 되돌리면 안 됩니다. pending과 확정 콜백의 UUID는 서로 다르며, 같은 이벤트의 재시도는 UUID를 유지합니다. 반복 이행을 막는 데이터베이스 처리 범위는 암호화폐 결제 웹훅 보안에서 설명합니다.

계속 대기 중인 결제는 어떻게 조사하나요?

선택한 네트워크와 자산부터 확인한 뒤 할당된 주소와 트랜잭션 해시를 확인하세요. 전송 금액이 티커의 최소 금액을 충족하는지, 주문이 허용한 시간 범위 내에 도착했는지 살펴보세요. 최소 금액 미만이나 지연 전송은 공개 콜백이 없을 수 있습니다. 더 기다린다고 처리 조건이 바뀌지는 않습니다. 해당 흐름은 부족 입금과 지연 암호화폐 결제를 참고하세요.

처리 대상 입금은 최초 콜백 URL로 로그를 조회하세요. pending은 정산이 미확정이라는 뜻입니다. sent는 정산이 확정되었지만 확정 콜백의 수신 확인을 받지 못했다는 뜻이며 재시도가 소진된 경우도 포함합니다. done은 확정 콜백의 수신 확인을 받았다는 뜻입니다. 이 상태로 결제 지연과 알림 전달 문제를 구분할 수 있습니다.

결제 네트워크를 비교할 때는 구매자와 쇼핑몰이 사용하는 전체 경로를 비교하세요. USDT TRC20과 BEP20 비교는 최종성 정책을 지갑 동작 및 입금 건별 비용과 연결해 설명합니다. 해결되지 않은 주문은 지원 담당자가 결제 참조값과 검증된 증거를 확인할 수 있게 유지하고, 금액 정책을 충족할 때까지 이행을 대기하세요.