Developer Portal

본문 바로가기
대 메뉴 바로가기

간편결제 승인요청

케이뱅크페이 결제승인요청

API 명 (URI)	/api/v1/payment/approve
Method	POST
Content-Type	application/json; charset=UTF-8

케이뱅크페이로 결제승인을 요청합니다.

API 명 (URI)	/api/v1/payment/approve
Method	POST
Content-Type	application/json; charset=UTF-8

케이뱅크페이로 결제승인을 요청합니다.

요청 메시지

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Header	HMAC_SINGNATURE	HMAC 인증	Y	Field	String	400
Header	HMAC_TIMESTAMP	HMAC 요청시간	Y	Field	String	14
Body	STLM_APRVL_AMT	결제요청금액	Y	Field	Number	12
Body	APRVL_REQ_DT	승인요청일자	Y	Field	String	8
Body	AUTH_RSLT_VAL	결제인증키	Y	Field	String	20
Body	ALCO_ID	제휴사 식별자	Y	Field	String	15
Body	ALCO_ORDN_NBR	제휴사 주문번호	Y	Field	String	40
Body	APRVR_REQ_TM	승인요청시간	Y	Field	String	6

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Header	HMAC_SINGNATURE	HMAC 인증	Y	Field	String	400
Header	HMAC_TIMESTAMP	HMAC 요청시간	Y	Field	String	14
Body	STLM_APRVL_AMT	결제요청금액	Y	Field	Number	12
Body	APRVL_REQ_DT	승인요청일자	Y	Field	String	8
Body	AUTH_RSLT_VAL	결제인증키	Y	Field	String	20
Body	ALCO_ID	제휴사 식별자	Y	Field	String	15
Body	ALCO_ORDN_NBR	제휴사 주문번호	Y	Field	String	40
Body	APRVR_REQ_TM	승인요청시간	Y	Field	String	6

요청 메시지 예제

Header

Content-Type: application/json

Body

{ "STLM_APRVL_AMT": 70000, "APRVL_REQ_DT": "20241023", "AUTH_RSLT_VAL": "TL202410231030353663", "ALCO_ID": "AL2024011101001", "ALCO_ORDN_NBR": "20241023103035eADOrCtNWN", "APRVL_REQ_TM": "103045" }

응답 메시지

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	ALCO_ID	제휴사 식별자	Y	Field	String	15
Body	APRVL_REQ_DT	승인요청일자	Y	Field	String	8
Body	APRVL_REQ_TM	승인요청시간	Y	Field	String	6
Body	ALCO_ORDN_NBR	제휴사 주문번호	Y	Field	String	40
Body	STLM_APRV_AMT	결제요청금액	Y	Field	Number	12
Body	AUTH_RSLT_VAL	결제 인증키	Y	Field	String	20
Body	APRVL_NBR	승인번호		Field	String	20
Body	APRVL_DT	승인일자		Field	String	8
Body	APRVL_TM	승인시간	Y	Field	String	6
Body	TX_FEE	수수료	Y	Field	Number	12
Body	RSLT_CD	결과코드	Y	Field	String	4
Body	RSLT_MSG	결과메시지	Y	Field	String	100

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	ALCO_ID	제휴사 식별자	Y	Field	String	15
Body	APRVL_REQ_DT	승인요청일자	Y	Field	String	8
Body	APRVL_REQ_TM	승인요청시간	Y	Field	String	6
Body	ALCO_ORDN_NBR	제휴사 주문번호	Y	Field	String	40
Body	STLM_APRV_AMT	결제요청금액	Y	Field	Number	12
Body	AUTH_RSLT_VAL	결제 인증키	Y	Field	String	20
Body	APRVL_NBR	승인번호		Field	String	20
Body	APRVL_DT	승인일자		Field	String	8
Body	APRVL_TM	승인시간	Y	Field	String	6
Body	TX_FEE	수수료	Y	Field	Number	12
Body	RSLT_CD	결과코드	Y	Field	String	4
Body	RSLT_MSG	결과메시지	Y	Field	String	100

응답 메시지 예제

Body

{ "ALCO_ID": "AL2024011101001", "APRVL_REQ_DT": "20241023", "APRVL_REQ_TM": "103045", "ALCO_ORDN_NBR": "20241023103035eADOrCtNWN", "STLM_APRVL_AMT": 70000, "AUTH_RSLT_VAL": "TL202410231030353663", "APRVL_NBR": "2024102301", "APRVL_DT": "20241023", "APRVL_TM": "103047", "TX_FEE": 0, "RSLT_CD": "0000", "RSLT_MSG": "성공", }

테스트

API 이용 신청