2.4. 결제 결과 통보

2.4.1. 개요

2.2. MPM 결제 요청에서 응답URL(notify_url) 항목에 결과를 통하는 규격서 입니다.

해당 API는 웹 URL방식으로 전달이 되어, Agent에서 웹서버(WAS)를 운영을 해야 합니다.

전송 Protocol : HTTP(S)
Method : POST
Paramether name : req
DATA 형태 : XML(SDK내에서 Pasing을 하기 때문에 고객사에서는 따로 구현할 필요가 없습니다)

2.4.2. 사용 함수

@PostMapping("/otpCallback") // URI정보는 반드시 otpCallback일 필요가 없습니다.
public String otpCallback(@RequestParam(name = "req", required = false) String xmlData) throws Exception {

    TestConfig config = new TestConfig();
    FKChinaPay chinaPay = new FKChinaPay(config);

    Map<String, String> result = chinaPay.payResultCallback(xmlData);
    System.out.println(String.format("result_code : %s",        result.get("result_code")));        // 응답 코드
    System.out.println(String.format("result_msg : %s",         result.get("result_msg")));         // 응답 메시지
    System.out.println(String.format("merchant_id: %s",         result.get("merchant_id")));        // 가맹점 ID
    System.out.println(String.format("merchant_tid: %s",        result.get("merchant_tid")));       // 가맹점 거래번호
    System.out.println(String.format("fk_tid: %s",         	result.get("fk_tid")));        	    // FK거래번호
    System.out.println(String.format("pay_method: %s",    	result.get("pay_method")));         // 결제 수단
    System.out.println(String.format("pay_amt: %s",             result.get("pay_amt")));            // 결제 금액
    System.out.println(String.format("pay_datetime: %s",        result.get("pay_datetime")));       // 거래 일시

    // HTML페이지에 공백 또는 탭, 줄바꿈 없이 반드시 1 또는 0만 리턴이 되어야 합니다.
    if(고객사 처리 로직 == ture){
        return 1;
    }else{  // 실패 시
        return 0;
    }
}

2.4.3. 응답 규격

No	변수명	필수	자료형	길이	비고
1	result_code	O	String	16	응답코드
2	result_msg	O	String	128	응답메시지
3	merchant_id	O	String	15	가맹점 거래 ID
4	merchant_tid	O	String	30	결제금액
5	fk_tid	X	String	30	FK 거래번호
6	pay_method	O	String	20	결제 수단
7	pay_amt	O	Number	16	거래 금액
8	pay_datetime	X	String	30	결제 일시

2.4.4. 리턴

    
    // HTML페이지에 공백 또는 탭, 줄바꿈 없이 반드시 1 또는 0만 리턴이 되어야 합니다.

    // Java Spring
    if(고객사 처리 로직 == ture){
        return 1;
    }else{  // 실패 시
        return 0;
    }
    
    // JSP
    if(고객사 처리 로직 == ture){
        response.write("1");
    }else{  // 실패 시
        response.write("0");
    }