콜백 알림

팁 (TIP)

지급이 완료된 후 시스템은 관련 지급 결과 및 정보를 가맹점에게 전송하며, 가맹점은 이를 수신하여 응답을 반환해야 합니다. 백그라운드 알림과 상호 작용할 때 시스템이 가맹점의 응답이 실패하거나 시간이 초과되었다는 것을 수신하면 시스템은 알림이 실패한 것으로 간주합니다. 알림은 알림의 성공률을 극대화하기 위해 특정 정책에 따라 주기적으로 다시 시작되지만 알림이 성공한다는 보장은 없습니다. (알림 빈도는 0초/15초/30초/3분/10분/20분/30분/60분/3시간/6시간입니다)

경고 (WARNING)

참고: 동일한 알림이 가맹점 시스템으로 여러 번 전송될 수 있습니다. 가맹점 시스템은 중복 알림을 올바르게 처리할 수 있어야 합니다. 권장되는 방법은 다음과 같습니다. 알림을 처리할 때 먼저 지급 상태를 확인하여 알림이 처리되었는지 확인합니다. 아니오인 경우 다시 처리합니다. 예인 경우 바로 성공 결과를 반환합니다. 상태 확인 및 비즈니스 데이터 처리 전에 함수 재진입으로 인한 데이터 혼란을 피하기 위해 데이터 잠금을 사용하여 동시성 제어를 수행합니다.

위험 (DANGER)

가맹점은 데이터 유출 및 자금 손실을 초래하는 "허위 알림"의 출현을 방지하기 위해 지급 콜백 내용에 대해 서명 검증을 수행하고 반환된 결제 금액이 올바른지 확인해야 합니다.

POST

'지급 생성(Create Payout)'에서 제출한 notify_url 매개변수입니다. 해당 링크에 접근할 수 없는 경우, 
귀하의 가맹점은 시스템에서 알림을 수신할 수 없습니다.

Request Body

이름	유형	설명	설명
app_id	string	애플리케이션
mch_id	string	가맹점
create_time	time	알림 시간
resource_type	string	알림의 리소스 데이터 유형입니다. 결제 성공 알림은 encrypt-resource입니다.
event_type	string	알림 유형입니다. 결제 성공 알림의 유형은 PAYPAYOUT.SUCCESS입니다.
resource	object	알림 리소스 데이터
» original_type	string	원래 콜백 유형은 payout입니다.
» algorithm	string	결과 데이터를 암호화하는 암호화 알고리즘에 대해 현재 AES-256-ECB만 지원됩니다.
» ciphertext	string	Base64로 인코딩된 온/오프 결과 데이터 암호문입니다. 활성화된 경우 암호화된 콘텐츠가 반환됩니다. 복호화 후에는 PayoutTransactionDetail의 json 문자열입니다.
» nonce	string	무작위 문자열을 사용하여 암호화

요청 예시 (Request example)

{
	"app_id": "xxxxx",
	"mch_id": "zzzzzz",
	"create_time": "2023-06-26T17:21:17.754429+08:00",
	"resource_type": "encrypt-resource",
	"event_type": "PAYPAYOUT.SUCCESS",
	"resource": {
		"original_type": "payout",
		"algorithm": "AEAD_AES_256_GCM",
		"ciphertext": "I/psKgdkVwxbkEIWtwRxfxLzViuRS+gJTQSdLf+lmK7awoqUcIJisTAJx0Qbv4K6wV8WgyMRFYHD5CCLKmFNU2OnmEm2f2vGhaoS2h28A9BEGx1CWEUw3tfldf/+VWlBAnIBylFjHzbSo7fgn7S3fFEAZHTxoy+9jNIoynqHZbn4Y6eucj1YCw0ZmuKHPpPPrvclbhHmaZHfau+SKyag3C0/cj7zu4mBkRZ39zuk9B7DAADzaRENOZ/ZyibU+zs3gibnCbI2NWEnQWIiCi7vK0jq/FCBWytHihQM364zlVrPPCBDbv2MSqk4fyAM7IDeT6h/z/2kmDOQ6aFPYlLojIkgCCOIevQITS9E+BS1rgmmH+DRKsJNiD257aLhX2/F53VEnjfqqKdDs2lqfX0dCMLqselGUT981fFKceXg+r6hQqcUzLlF28XL5NrfVPreRDo6jI2K0tCy9cOx+cxH3yoDzOFBzM0RlxWqvUhRsMv9ZGfpgCZ0o9HxNObqLjVCQzE5SWPXvmkw+QpWk0oNUvpCEDhj9Vfq6XCV8j3tT3tZTYCa5UQy9VCdmval/2vb50QaAgDYXU6PH/9Xv7AXg6kg29iK+Ec0euxZxosRoVczzRg+0Arl/zvBcphWNIUTdx5IcA12WtP+krk9NNGtj7igk21DhcseJrKBpG7ll9O/Wmq1L8BwW+ypuJS+kHV61jRNYMFJY48Pt11Zoukgqu94kzrhz+KET8q463zlyu/Kp2z5yWI8xwvOtuyjosszfm6/YFQTFdhcmHY3X1yz44NaVG9FPev1QPoPmI7K3Jqa0Q8Q5kQTbe/KrB0eyRpXtyAaShOEeiS2ypmFAC81/m4mjuTd24yAjBcTIfBYzjxwjPbKfv+OYKahDwJP1b7EhsM+Sgu48wQ+pp6wc8TYCOkiRR1pKeb3kaxpQGzlq7VNbWHFPw9TDiyCIEnr8T5eiJtzJJ0U0iIfqN5WHk7iHiNK4Y4TvmdF4f6UyeMTHvaprvzUZI8il5wvoCgIiRUY7qvv5V/KL4ZWHN6Y3EEvQmP4WDo3Wx5IFW8C1gkyFv8lQ1COSNYMPog6RLAI0rNvKZjvc4baWwcHmk/fM92X19F2Y0DArqLFFUTJVE5bUQXQexiUO1e8IL07wqY=",
		"nonce": "d8816e8d6dca4409b790a4bcaa25c621"
	}
}

반환 예시 (Return example)

success

콜백 요청을 성공적으로 수신한 후 알림 서버에 알리려면 success를 반환하십시오. 알림 서버가 success를 수신하면 알림이 중지됩니다. 그렇지 않으면 알림은 0초/15초/30초/3분/10분/20분/30분/60분/3시간/6시간의 빈도로 10회 전송됩니다.