콜백 알림
경고 (WARNING)
참고: 동일한 알림이 가맹점 시스템으로 여러 번 전송될 수 있습니다. 가맹점 시스템은 동일한 알림을 올바르게 처리할 수 있어야 합니다. 권장되는 방법은 다음과 같습니다. 알림을 처리할 때 먼저 해당 비즈니스 데이터의 상태를 확인하여 알림이 처리되었는지 확인합니다. 아니오인 경우 다시 처리합니다. 예인 경우 바로 성공 결과를 반환합니다. 상태 확인 및 비즈니스 데이터 처리 전에 함수 재진입으로 인한 데이터 혼란을 피하기 위해 데이터 잠금을 사용하여 동시성 제어를 수행합니다.
위험 (DANGER)
주의: 가맹점 시스템은 주문 콜백 내용에 대해 서명 검증을 수행하고 반환된 주문 금액이 주문 금액과 일치하는지 확인해야 합니다. 자금 손실을 초래하는 "허위 알림"으로 인한 데이터 유출을 방지하기 위해 이 작업을 수행하는 이유입니다.
인터페이스 주소 (Interface address)
POST 통합 주문 인터페이스에서 제출한 notify_url 매개변수가 설정되어 있습니다. 해당 링크에 접근할 수 없는 경우 서비스 시스템에서 결제 센터의 알림을 수신할 수 없습니다.요청 본문 (Request Body)
app_id
string
애플리케이션
mch_id
string
가맹점
create_time
time
알림 시간
resource_type
string
알림의 리소스 데이터 유형입니다. 결제 성공 알림은 encrypt-resource입니다.
event_type
string
알림 유형입니다. 결제 성공 알림의 유형은 SUCCESS입니다.
resource
object
알림 리소스 데이터
» original_type
string
원래 콜백 유형은 transaction입니다.
» algorithm
string
결과 데이터를 암호화하는 암호화 알고리즘에 대해 현재 AES-256-ECB만 지원됩니다.
» ciphertext
string
Base64로 인코딩된 온/오프 결과 데이터 암호문입니다. 활성화된 경우 암호화된 콘텐츠가 반환됩니다. 복호화 후에는 TransactionNotifyDetail의 json 문자열입니다.
» nonce
string
무작위 문자열을 사용하여 암호화
요청 예시 (Request example)
반환 예시 (Return example)
콜백 요청을 성공적으로 수신한 후 알림 서버에 알리려면 success를 반환하십시오. 알림 서버가 success를 수신하면 알림이 중지됩니다. 그렇지 않으면 알림은 0초/15초/30초/3분/10분/20분/30분/60분/3시간/6시간의 빈도로 10회 전송됩니다.
마지막 업데이트