Skip to content

결제 결과 검증 ​

Webhook으로 수신한 이벤트의 결제 정보를 검증하는 방법입니다.

1단계: HMAC 서명 검증 ​

Webhook 서명 시크릿을 설정한 경우, 페이로드를 처리하기 전에 X-SoloPay-Signature 헤더를 검증하세요. 자세한 내용은 Webhook 가이드를 참조하세요.

2단계: API로 결제 검증 ​

Webhook payload에 포함된 paymentId를 이용하여 서버에서 SoloPay API를 직접 호출해 결제 상태를 확인합니다.

반드시 서버에서 검증하세요

Webhook payload의 내용을 그대로 신뢰하지 마세요. 반드시 API를 통해 실제 결제 상태를 재확인해야 합니다.

bash
curl https://gateway.dev.solonetwork.io/api/v1/payments/0xabc123... \
  -H "x-public-key: pk_xxxxx"

검증 체크리스트

멱등성 처리 ​

같은 이벤트가 여러 번 전송될 수 있습니다. paymentId를 기준으로 중복 처리를 방지하세요.

typescript
// 이미 처리된 paymentId인지 확인 (DB 조회)
const alreadyProcessed = await db.orders.isPaymentProcessed(data.paymentId);
if (alreadyProcessed) {
  return res.status(200).json({ received: true }); // 중복 이벤트 무시
}

다음 단계 ​

Non-custodial Web3 payment infrastructure for ERC-20 checkout, sponsored gas, and wallet-to-wallet settlement.