4단계: 결제 브리지링크 검증됨
- 0 · 로드맵
- 1 · 영수증과 보증
- 2 · 크리에이터 로열티
- 3 · B2B 인보이스
- 4 · 결제 브리지
- 5 · 시뮬레이터
- 6 · Devnet: 직접 재현
- 7 · 계산대
- 7.1 · 안전
- ✓ · 신뢰 사슬
- ★ · 이점과 활용
- ✎ · 열 가지 해설
- ▶ · 영상
- ? · 독자 발견

카드 결제 대행은 상점을 위해 세 가지를 합니다. 결제를 받고, 확인하고, 상점 시스템에 알립니다. 이 모델은 오픈 표준 Solana Pay로 Solana에서 같은 일을 합니다. 주문마다 결제 링크나 QR, 고유 참조로 결제를 찾는 감시기, 엄격한 검증, 상점으로 보내는 웹훅.
과제
온라인 상점이 Solana로 결제를 받고 주문을 자동으로 결제 완료 처리하게 합니다. 상점이 카드 결제 대행사에 기대하는 만큼 믿을 수 있게요.
모델
- 생성. 상점은 주문마다 수신자, 금액, 토큰, 고유한 무작위 reference 주소, 라벨, 메모
order:ID가 담긴 Solana Pay 링크를 만듭니다. 링크는 버튼이나 QR이 됩니다. - 결제. 고객이 Solana Pay를 지원하는 아무 지갑에서 열고 확인합니다.
- 찾기. 상점 서버가 참조 주소가 포함된 트랜잭션을 체인에 묻습니다.
- 검증. 수신자, 금액, 토큰, 참조, 메모를 확인합니다. 하나라도 틀리면 오류를 냅니다.
- 알림.
{orderId, status: "paid", signature}를 상점 웹훅으로 보냅니다. 주문 시스템이 상품을 발송합니다.
| 카드 결제 대행 | 이 브리지 | |
|---|---|---|
| 확인 | 승인은 몇 초, 정산은 며칠 | 몇 초 만에 확인, 약 13초 만에 확정 |
| 수수료 | 비율 수수료에 결제당 고정 수수료 | 1센트도 안 되는 네트워크 수수료, 여기에 환전 비용이 있다면 추가 |
| 지불 거절 | 있음: 구매자를 보호하지만 상점에는 위험 | 없음: 환불은 상점이 보내는 새 결제 |
| 규제 | 인가받은 결제 대행사가 처리 | 나라마다 다르며 인가받은 파트너가 필요할 수 있음 |
코드
파일: lab/code/src/04-solana-pay-bridge.ts · Apache-2.0
// Model 4: a payment bridge for e-commerce. The shop creates a Solana Pay link/QR for an order,
// watches the chain for the payment by its unique reference, validates amount and token,
// then notifies its own order system (the same role a card acquirer's callback plays).
// License: Apache-2.0. Example code, not audited. Devnet first. Built on @solana/pay + @solana/kit.
import { encodeURL, findReference, validateTransfer, FindReferenceError } from '@solana/pay';
import { address, createSolanaRpc, generateKeyPairSigner, type Address } from '@solana/kit';
/** Tokens a shop may accept. USDC for stable prices; $WEN as an optional community payment. */
export const ACCEPTED = {
USDC_MAINNET: address('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'),
WEN_MAINNET: address('WENWENvqqNya429ubCdR81ZmD69brwQaaBYY6p3LCpk'),
} as const;
export interface PaymentRequest {
orderId: string;
recipient: Address; // the shop's wallet
amount: number; // in token units, e.g. 24.99
splToken?: Address; // omit for SOL
reference: Address; // unique per order: how the shop finds the payment
url: string; // solana: URL to show as a link or QR
}
export async function createPaymentRequest(orderId: string, recipient: Address, amount: number, splToken?: Address): Promise<PaymentRequest> {
const reference = (await generateKeyPairSigner()).address; // random, never reused
const url = encodeURL({
recipient, amount, splToken, reference,
label: 'Wen Open Lab demo shop',
message: `Order ${orderId}`,
memo: `order:${orderId}`,
});
return { orderId, recipient, amount, splToken, reference, url: url.toString() };
}
/** Poll until the payment appears, then validate it and call the shop's webhook. */
export async function waitForPayment(req: PaymentRequest, opts: { rpcUrl: string; webhook: string; timeoutMs?: number }) {
const rpc = createSolanaRpc(opts.rpcUrl);
const deadline = Date.now() + (opts.timeoutMs ?? 5 * 60_000);
while (Date.now() < deadline) {
try {
const found = await findReference(rpc, req.reference, { commitment: 'confirmed' });
// Throws if recipient, amount, token, reference or memo do not match the request.
await validateTransfer(rpc, found.signature, {
recipient: req.recipient, amount: req.amount, splToken: req.splToken, reference: req.reference, memo: `order:${req.orderId}`,
}, { commitment: 'confirmed' });
await fetch(opts.webhook, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ orderId: req.orderId, status: 'paid', signature: found.signature }),
});
return found.signature;
} catch (e) {
if (!(e instanceof FindReferenceError)) throw e; // not found yet: keep waiting
await new Promise(r => setTimeout(r, 1500));
}
}
throw new Error(`Order ${req.orderId}: payment not found before timeout`);
}
검증한 내용
결제 링크는 공식 Solana Pay 파서를 왕복해도 수신자, 금액, 토큰, 참조, 메모가 그대로이며, 주문마다 고유한 참조를 받습니다. 감시기와 검증은 공식 findReference와 validateTransfer를 쓰고 타입 검사를 마쳤습니다. 실제 체인에서 돌려 보는 것은 devnet 단계의 일입니다.
쓸모 있는 곳
- 전 세계 크립토 네이티브 고객에게 파는 온라인 상점.
- 즉시 정산이 중요한 디지털 상품, 티켓, 구독.
- 카드와 함께 스테이블코인 수납을 검토하는 결제 사업자와 은행.
한계와 위험
- 가격 변동성: 스테이블코인으로 가격을 매기거나 계산 시 환전하세요.
- 법정화폐로 바꾸는 일(오프램프)에는 별도의 수수료와 규칙이 있습니다.
- 지불 거절이 없으니 상점은 명확한 환불 정책을 갖춰야 합니다.
- 운영 환경에서는 자체 RPC 엔드포인트를 쓰세요. 공개 엔드포인트는 호출 빈도가 제한됩니다.
내 상점의 숫자가 궁금하다면 시뮬레이터를 써 보세요.
그림으로 보는 Wen
이 모델에서 Wen의 자리
어떤 토큰을 받을지는 상점이 정합니다. USDC는 가격을 안정적으로 유지하고, WEN은 커뮤니티 결제 옵션으로 제공할 수 있으며 그 컨트랙트는 코드에 ACCEPTED.WEN_MAINNET으로 적혀 있습니다. 어떤 토큰이든 받기 전에 그 민트를 어느 토큰 프로그램이 소유하는지 확인하고(common.ts의 헬퍼 detectTokenProgram이 해 줍니다), devnet에서 전체 흐름을 테스트하세요.
Wen의 실: 하나의 컨트랙트, 어디에나
랩의 모든 모델은 무료이고 공개되어 있으며, 모두 같은 서명을 지닙니다. 바로 $WEN 토큰 컨트랙트입니다. 복사해 내 문서에도 적어 두고, 쓰기 전에는 반드시 익스플로러에서 확인하세요.
WENWENvqqNya429ubCdR81ZmD69brwQaaBYY6p3LCpk
확인: Solana Explorer · 컨트랙트 ID 찾는 법
오픈 사용 정책
- 무료이고 공개. 랩의 모든 코드는 Wen Program Library와 같은 Apache License 2.0으로 공개됩니다. 상업적이든 아니든 쓰고, 고치고, 배포하세요. 라이선스 고지만 유지하면 됩니다.
- 오픈 도구만. 공개되어 있고 문서화된 도구로 만듭니다: Solana SPL Token-2022(Token Extensions), Wen New Standard(WNS) 토큰 구조, Solana Pay, 로컬 테스트용 LiteSVM.
- 규칙: 내 모델은 언제나 직접 검증하라. 테스트를 돌리고, devnet에서 시작하고, 공식 문서를 읽고, 모든 계정과 금액을 검토하고, 메인넷에 쓰기 전에 독립 감사를 받으세요. 검증하지 않은 모델은 모델이 아니라 추측입니다.
- 감사받지 않았고, 조언이 아닙니다. 교육용 예제입니다. 금융·법률·세무 조언이 아니며, 인가받은 결제나 은행 상품도 아닙니다. 대부분의 나라에서 결제, 스테이블코인, 결제 대행은 규제 대상 활동입니다.
- 보안. 개인 키를 웹사이트에 절대 붙여 넣지 마세요. npm 패키지
@wen-community/wen-new-standard는 설치하지 마세요. npm이 악성으로 삭제했습니다. 공식 소스로 빌드하세요.
Wen이 커뮤니티를 위해 전합니다. 자세한 내용은 편집 및 데이터 정책에서.
Wen Open Lab · 로드맵 · 전체 코드 · GitHub의 Wen Program Library





