멱등성
고정 식별자를 확인해 동일한 결제의 중복 처리를 방지하도록 돕습니다.
결제팀용 도구
Pix 이벤트를 붙여 넣어 운영에 영향을 주기 전에 구조, 멱등성, 보안 문제를 확인하세요.
분석은 브라우저에서 수행되며 페이로드는 AZPay로 전송되지 않습니다.
분석할 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을 결제 흐름에 연동하는 방법을 살펴보세요.