간편결제 승인취소(v2)

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

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


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


영문명한글명내용필수암호화
HMAC_SIGNATUREHMAC 인증 값Base64(HMAC(body부 + 발송시간))Y
HMAC_TIMESTAMPHMAC 타임스탬프HMAC 추출 시 사용했던 발송 시간(yyyyMMddHHmmss)Y

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


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


영문명한글명내용필수암호화
HMAC_SIGNATUREHMAC 인증 값Base64(HMAC(body부 + 발송시간))Y
HMAC_TIMESTAMPHMAC 타임스탬프HMAC 추출 시 사용했던 발송 시간(yyyyMMddHHmmss)Y

요청 메시지

영문명한글명내용필수암호화
ALCO_ID제휴사 식별자케이뱅크에서 제공한 제휴사 고유 식별자Y
CNCL_REQ_DT취소요청일자YYYYMMDDY
CNCL_REQ_TM취소요청시간HH24MISSY
ALCO_ORDN_NBR원거래 주문번호제휴사 원거래 주문번호Y
ORG_APRVL_DT원거래 승인일자원거래 승인일자(망취소시 NULL 허용)N
CNCL_AMT취소금액전체취소:원거래 결제금액, 부분취소:부분취소 금액Y
CNCL_TAXF_AMT취소 면세금액취소 금액 중 면세금액Y
CNCL_SRTX_AMT취소 부가가치세취소 금액 중 과세에 대한 부가세 금액Y
CNCL_SERV_AMT취소 봉사료취소 금액 중 봉사료Y
APRVL_NBR원거래 승인번호원거래 승인번호(망취소시 NULL 허용)N
CNCL_DS_CD취소 구분 코드C:고객취소 / N:망취소Y
영문명한글명내용필수암호화
ALCO_ID제휴사 식별자케이뱅크에서 제공한 제휴사 고유 식별자Y
CNCL_REQ_DT취소요청일자YYYYMMDDY
CNCL_REQ_TM취소요청시간HH24MISSY
ALCO_ORDN_NBR원거래 주문번호제휴사 원거래 주문번호Y
ORG_APRVL_DT원거래 승인일자원거래 승인일자(망취소시 NULL 허용)N
CNCL_AMT취소금액전체취소:원거래 결제금액, 부분취소:부분취소 금액Y
CNCL_TAXF_AMT취소 면세금액취소 금액 중 면세금액Y
CNCL_SRTX_AMT취소 부가가치세취소 금액 중 과세에 대한 부가세 금액Y
CNCL_SERV_AMT취소 봉사료취소 금액 중 봉사료Y
APRVL_NBR원거래 승인번호원거래 승인번호(망취소시 NULL 허용)N
CNCL_DS_CD취소 구분 코드C:고객취소 / N:망취소Y

요청 메시지 예제

  • Header

    Content-Type: application/json

  • Body

응답 메시지

영문명한글명내용필수암호화
ALCO_ID제휴사 식별자케이뱅크에서 제공한 제휴사 고유 식별자Y
CNCL_REQ_DT취소요청일자YYYYMMDDY
CNCL_REQ_TM취소요청시간HH24MISSY
ALCO_ORDN_NBR원거래 주문번호제휴사 원거래 주문번호Y
ORG_APRVL_DT원거래 승인일자원거래 승인일자(망취소시 NULL 허용)N
CNCL_AMT취소금액전체취소:원거래 결제금액, 부분취소:부분취소 금액Y
CNCL_TAXF_AMT취소 면세금액취소 금액 중 면세금액Y
CNCL_SRTX_AMT취소 부가가치세취소 금액 중 과세에 대한 부가세 금액Y
CNCL_SERV_AMT취소 봉사료취소 금액 중 봉사료Y
APRVL_NBR원거래 승인번호원거래 승인번호(망취소시 NULL 허용)N
CNCL_DS_CD취소 구분 코드C:고객취소 / N:망취소Y
RSLT_CD결과 코드결과 코드 : 0000(성공), 그 외 실패Y
RSLT_MSG결과 메시지결과 메시지Y
영문명한글명내용필수암호화
ALCO_ID제휴사 식별자케이뱅크에서 제공한 제휴사 고유 식별자Y
CNCL_REQ_DT취소요청일자YYYYMMDDY
CNCL_REQ_TM취소요청시간HH24MISSY
ALCO_ORDN_NBR원거래 주문번호제휴사 원거래 주문번호Y
ORG_APRVL_DT원거래 승인일자원거래 승인일자(망취소시 NULL 허용)N
CNCL_AMT취소금액전체취소:원거래 결제금액, 부분취소:부분취소 금액Y
CNCL_TAXF_AMT취소 면세금액취소 금액 중 면세금액Y
CNCL_SRTX_AMT취소 부가가치세취소 금액 중 과세에 대한 부가세 금액Y
CNCL_SERV_AMT취소 봉사료취소 금액 중 봉사료Y
APRVL_NBR원거래 승인번호원거래 승인번호(망취소시 NULL 허용)N
CNCL_DS_CD취소 구분 코드C:고객취소 / N:망취소Y
RSLT_CD결과 코드결과 코드 : 0000(성공), 그 외 실패Y
RSLT_MSG결과 메시지결과 메시지Y

응답 메시지 예제

  • Body

테스트
API 이용 신청