본문으로 건너뛰기

결제팀용 도구

Pix Webhook Inspector

Pix 이벤트를 붙여 넣어 운영에 영향을 주기 전에 구조, 멱등성, 보안 문제를 확인하세요.

분석은 브라우저에서 수행되며 페이로드는 AZPay로 전송되지 않습니다.

웹훅 페이로드

이전 알림(A, 선택)
분석할 준비가 되었습니다.

진단 결과

분석할 JSON을 붙여 넣으세요.

검사 항목

endToEndId는 송금을 식별하고 txid는 청구와 연결합니다. 결제사에서 입금을 확인한 후 한 번만 기록하세요. Banco Central do Brasil · API Pix 2.10.0 · WebhookPixBody

빠른 검사로 안정적인 웹훅 수신기를 구현할 수 있습니다. 서명은 서버에서 검증하세요.

멱등성

고정 식별자를 확인해 동일한 결제의 중복 처리를 방지하도록 돕습니다.

결제 상태

pending, confirmed, failed, refunded 등의 상태 전이를 명확하게 하는 데 도움이 됩니다.

보안

예시를 공유하기 전에 토큰, 비밀번호, 카드 데이터로 의심되는 정보를 표시합니다.

모든 기술 스택에서 안전한 수신기 구현

부수 효과가 발생하기 전에 이벤트 ID를 기록하고 신속하게 응답한 뒤 비동기로 처리하세요.

for (const pix of payload.pix) {
  await db.transaction(async tx => {
    if (await tx.insertReceiptIfAbsent(pix.endToEndId)) {
      await tx.enqueueReconciliation(pix);
    }
    for (const refund of pix.devolucoes ?? []) {
      await tx.reconcileRefundOnce(refund.rtrId, refund.status);
    }
  });
}
return response(200);

자주 묻는 질문

페이로드가 서버로 전송되나요?

아니요. 기본 분석은 브라우저에서 수행됩니다. 실제 토큰, 키, 개인정보, 카드 정보는 붙여 넣지 마세요.

웹훅 서명을 검증하나요?

연동에 사용하는 비밀키와 알고리즘이 필요합니다. 이 도구는 구조 및 보안 문제를 표시합니다. 암호학적 검증은 백엔드에서 수행하세요.

결제에서 멱등성이 중요한 이유는 무엇인가요?

시간 초과나 네트워크 오류로 웹훅이 재전송될 수 있습니다. 고정 ID로 처리된 이벤트를 식별해 중복 청구, 기록, 배송을 방지할 수 있습니다.

결제를 연동할 준비가 되셨나요?

AZPay Checkout을 결제 흐름에 연동하는 방법을 살펴보세요.

Checkout 살펴보기