클라이언트가 요청한 작업의 비동기 처리 결과를 실시간으로 전달하기 위한 방식이다.
서버는 작업 완료 시점에 클라이언트가 등록한 Webhook URL로 결과를 POST 방식으로 전송한다.
config.xml)확인사항: DBPitcher는 반드시 발송 요청 파라미터 SENDERID 를 설정한 정보로 발송 요청해야 한다. 아래 예제는 SENDERID 를 "TEST_SYS01" 로 발송 요청한 경우이다.
<webhook>
<use>Y</use>
<!-- 발송 필수 파라미터 SENDERID를 기준으로 해당 URL을 호출해 준다 -->
<callApis>
<callApi>{"TEST_SYS01":"http://127.0.0.1:28888/webhookReceive"}</callApi>
</callApis>
</webhook>
{
"MASTERTABLE_SEQNO": 123456789,
"TRANS_TYPE": "REAL",
"UMS_MSG_TYPE": "I",
"START_SEND_TYPE": "SMS",
"SENDERID": "UMS001",
"SENDGROUPCODE": "GRP1001",
"APP_ID": "APP_UMS_01",
"CUID": "CUID202512120001",
"TRANSACTION_KEY": "TXNKEY-ABC-123456",
"CUST_TRANSGROUPKEY": "CTG-20251212-001",
"CUST_TRANSKEY": "CTK-20251212-987",
"VAR1": "홍길동",
"VAR2": "100,000원",
"VAR3": "2025-12-12",
"VAR4": "강남점",
"VAR5": "VIP",
"VAR6": "Y",
"VAR7": "A001",
"VAR8": "192.168.0.10",
"VAR9": "기타정보",
"UMS_SUCC_STATUS": "1",
"ERRCODE": "0000",
"RESULT_MSG": "SUCCESS",
"PROVIDER_SVCID": "SVC_KKO_01"
}