간편결제 승인요청(v2)

케이뱅크 페이(간편 결제) 승인 요청

API 명 (URI)	/api/v1/payment/v2/approve
Method	POST
Content-Type	application/json

Authorization	Bearer {access_token}
HMAC_SIGNATURE	HMAC 인증값
HMAC_TIMESTAMP	HMAC 타임스탬프

케이뱅크 페이(간편결제) 승인 제휴사 요청 API

API 명 (URI)	/api/v1/payment/v2/approve
Method	POST
Content-Type	application/json

Authorization	Bearer {access_token}
HMAC_SIGNATURE	HMAC 인증값
HMAC_TIMESTAMP	HMAC 타임스탬프

케이뱅크 페이(간편결제) 승인 제휴사 요청 API

요청 메시지

-헤더

No	구분	이름	설명	필수여부	항목유형	데이터유형	길이
1	Header	HMAC_SIGNATURE	HMAC 인증값		Field	String	255
2	Header	HMAC_TIMESTAMP	HMAC 타임스탬프		Field	String	12

-바디

No	구분	이름	설명	항목유형	데이터유형	길이
3	Body	ALCO_ID	제휴사 식별자	Field	String	15
4	Body	APRVL_REQ_DT	승인요청일자	Field	String	8
5	Body	APRVL_REQ_TM	승인요청시간	Field	String	6
6	Body	ALCO_ORDN_NBR	제휴사 주문번호	Field	String	40
7	Body	STLM_APRVL_AMT	결제요청금액	Field	String	12
8	Body	STLM_TAXF_AMT	결제면세금액	Field	String	12
9	Body	STLM_SRTX_AMT	결제부가가치세	Field	String	12
10	Body	STLM_SERV_AMT	결제봉사료	Field	String	12
11	Body	AUTH_RSLT_VAL	결제인증키	Field	String	20

-헤더

No	구분	이름	설명	필수여부	항목유형	데이터유형	길이
1	Header	HMAC_SIGNATURE	HMAC 인증값		Field	String	255
2	Header	HMAC_TIMESTAMP	HMAC 타임스탬프		Field	String	12

-바디

No	구분	이름	설명	항목유형	데이터유형	길이
3	Body	ALCO_ID	제휴사 식별자	Field	String	15
4	Body	APRVL_REQ_DT	승인요청일자	Field	String	8
5	Body	APRVL_REQ_TM	승인요청시간	Field	String	6
6	Body	ALCO_ORDN_NBR	제휴사 주문번호	Field	String	40
7	Body	STLM_APRVL_AMT	결제요청금액	Field	String	12
8	Body	STLM_TAXF_AMT	결제면세금액	Field	String	12
9	Body	STLM_SRTX_AMT	결제부가가치세	Field	String	12
10	Body	STLM_SERV_AMT	결제봉사료	Field	String	12
11	Body	AUTH_RSLT_VAL	결제인증키	Field	String	20

요청 메시지 예제

Header

Content-Type: application/json

Body

{ "ALCO_ID" : "sample_ALCO_ID", "APRVL_REQ_DT" : "sample_APRVL_REQ_DT", "APRVL_REQ_TM" : "sample_APRVL_REQ_TM", "ALCO_ORDN_NBR" : "sample_ALCO_ORDN_NBR", "STLM_APRVL_AMT" : "sample_STLM_APRVL_AMT", "STLM_TAXF_AMT" : "sample_STLM_TAXF_AMT", "STLM_SRTX_AMT" : "sample_STLM_SRTX_AMT", "STLM_SERV_AMT" : "sample_STLM_SERV_AMT", "AUTH_RSLT_VAL" : "sample_AUTH_RSLT_VAL" }

응답 메시지

No	구분	이름	설명	항목유형	데이터유형	길이
1	Body	ALCO_ID	제휴사 식별자	Field	String	15
2	Body	APRVL_REQ_DT	승인요청일자	Field	String	8
3	Body	APRVL_REQ_TM	승인요청시간	Field	String	6
4	Body	ALCO_ORDN_NBR	제휴사 주문번호	Field	String	40
5	Body	STLM_APRVL_AMT	결제요청금액	Field	String	12
6	Body	STLM_TAXF_AMT	결제면세금액	Field	String	12
7	Body	STLM_SRTX_AMT	결제부가가치세	Field	String	12
8	Body	STLM_SERV_AMT	결제봉사료	Field	String	12
9	Body	AUTH_RSLT_VAL	결제인증키	Field	String	20
10	Body	APRVL_NBR	승인번호	Field	String	20
11	Body	APRVL_DT	승인일자	Field	String	8
12	Body	APRVL_TM	승인시간	Field	String	6
13	Body	TX_FEE	수수료	Field	String	12
14	Body	RSLT_CD	결과코드	Field	String	4
15	Body	RSLT_MSG	결과메시지	Field	String	100

No	구분	이름	설명	항목유형	데이터유형	길이
1	Body	ALCO_ID	제휴사 식별자	Field	String	15
2	Body	APRVL_REQ_DT	승인요청일자	Field	String	8
3	Body	APRVL_REQ_TM	승인요청시간	Field	String	6
4	Body	ALCO_ORDN_NBR	제휴사 주문번호	Field	String	40
5	Body	STLM_APRVL_AMT	결제요청금액	Field	String	12
6	Body	STLM_TAXF_AMT	결제면세금액	Field	String	12
7	Body	STLM_SRTX_AMT	결제부가가치세	Field	String	12
8	Body	STLM_SERV_AMT	결제봉사료	Field	String	12
9	Body	AUTH_RSLT_VAL	결제인증키	Field	String	20
10	Body	APRVL_NBR	승인번호	Field	String	20
11	Body	APRVL_DT	승인일자	Field	String	8
12	Body	APRVL_TM	승인시간	Field	String	6
13	Body	TX_FEE	수수료	Field	String	12
14	Body	RSLT_CD	결과코드	Field	String	4
15	Body	RSLT_MSG	결과메시지	Field	String	100

응답 메시지 예제

Body

{ "ALCO_ID" : "sample_ALCO_ID", "APRVL_REQ_DT" : "sample_APRVL_REQ_DT", "APRVL_REQ_TM" : "sample_APRVL_REQ_TM", "ALCO_ORDN_NBR" : "sample_ALCO_ORDN_NBR", "STLM_APRVL_AMT" : "sample_STLM_APRVL_AMT", "STLM_TAXF_AMT" : "sample_STLM_TAXF_AMT", "STLM_SRTX_AMT" : "sample_STLM_SRTX_AMT", "STLM_SERV_AMT" : "sample_STLM_SERV_AMT", "AUTH_RSLT_VAL" : "sample_AUTH_RSLT_VAL", "APRVL_NBR" : "sample_APRVL_NBR", "APRVL_DT" : "sample_APRVL_DT", "APRVL_TM" : "sample_APRVL_TM", "TX_FEE" : "sample_TX_FEE", "RSLT_CD" : "sample_RSLT_CD", "RSLT_MSG" : "sample_RSLT_MSG" }

테스트

API 이용 신청

kbank

API 상세보기

Kbank

간편결제 승인요청(v2)

요청 메시지

-헤더

-바디

-헤더

-바디

요청 메시지 예제

응답 메시지

응답 메시지 예제

간편결제 승인요청(v2)

요청 메시지

-헤더

-바디

-헤더

-바디

요청 메시지 예제

응답 메시지

응답 메시지 예제

알림

알림

알림