Developer Portal

API 명 (URI)	/api/v1/payment/file
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	TX_DT	거래일자	Y	Field	String	8
Body	VRFC_REQ_STS_CD	요청상태코드	Y	Field	String	2
Body	PSWD	대사요청키	Y	Field	String	256
Body	VRFC_REQ_DS_CD	요청구분코드	Y	Field	String	2
Body	ALCO_ID	제휴사 식별자	Y	Field	String	15

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Header	HMAC_SINGNATURE	HMAC 인증	Y	Field	String	400
Header	HMAC_TIMESTAMP	HMAC 요청시간	Y	Field	String	14
Body	TX_DT	거래일자	Y	Field	String	8
Body	VRFC_REQ_STS_CD	요청상태코드	Y	Field	String	2
Body	PSWD	대사요청키	Y	Field	String	256
Body	VRFC_REQ_DS_CD	요청구분코드	Y	Field	String	2
Body	ALCO_ID	제휴사 식별자	Y	Field	String	15

요청 메시지 예제

Header

Content-Type: application/json

Body

{ "TX_DT": "20241115", "VRFC_REQ_STS_CD": "01", "PSWD": "*******************", "VRFC_REQ_DS_CD": "01", "ALCO_ID": "AL2024011101001" }

응답 메시지

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	ALCO_ID	제휴사 식별자	Y	Field	String	15
Body	VRFC_REQ_DS_CD	요청구분코드	Y	Field	String	2
Body	VRFC_REQ_STS_CD	요청상태코드	Y	Field	String	2
Body	TX_DT	거래일자	Y	Field	String	8
Body	REQ_DT	전송요청일자		Field	String	8
Body	VRFC_ITER_CNT	대사자료 총 건 수	Y	Field	Number	5
Body	VRFC_DATA	대사자료		Field	String[]
Body	RSLT_CD	결과코드	Y	Field	String	4
Body	RSLT_MSG	응답메시지	Y	Field	String	100

대사자료 배열(거래대사)

구분	필드명	길이	사용여부	설영
Header	레코드 구분 코드	1	Y	H(고정)
Header	자료 생성일시	14	Y	YYYYMMDDHH24MISS
Header	레코드 수	-	N	-
Header	제휴사 거래 고유번호	-	N	-
Header	제휴사 원거래 고유번호	-	N	-
Header	거래 구분 코드	-	N	-
Header	승인일시	-	N	-
Header	취소일시	-	N	-
Header	승인번호	-	N	-
Header	정산금액	-	N	-
Header	정산수수료	-	N	-
Header	부가세	-	N	-
Header	대사자료 결과 코드	4	Y	대사자료 결과 코드
Header	대사자료 결과 메시지	100	Y	대사자료 응답 메시지
Data	레코드 구분 코드	1	Y	B(고정)
Data	자료 생성일시	-	N	-
Data	레코드 수	12	Y	Sequence Number(1부터 시작, 1씩 증가)
Data	제휴사 거래 고유번호	40	Y	제휴사 거래 고유번호
Data	제휴사 원거래 고유번호	40	N	취소 거래 시
Data	거래구분 코드	1	Y	A:승인, C:취소
Data	승인일시	14	Y	YYYYMMDDHH24HISS
Data	취소일시	14	Y	YYYYMMDDHH24HISS(취소거래시)
Data	승인번호	20	Y	승인번호
Data	정산금액	22	Y	최초 1byte 부호(+/-)
Data	정산수수료	22	Y	최초 1byte 부호(+/-)
Data	부가세	22	Y	최초 1byte 부호(+/-)
Data	대사자료 결과 코드	-	N	-
Data	대사자료 결과 메시지	-	N	-
Tail	레코드 구분 코드	1	Y	H(고정)
Tail	자료 생성일시	-	N	-
Tail	레코드 수	12	Y	Data 부 레코드 합
Tail	제휴사 거래 고유번호	-	N	-
Tail	제휴사 원거래 고유번호	-	N	-
Tail	거래 구분 코드	-	N	-
Tail	승인일시	-	N	-
Tail	취소일시	-	N	-
Tail	승인번호	-	N	-
Tail	거래금액	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	거래수수료	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	부가세	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	대사자료 결과 코드	-	N	-
Tail	대사자료 결과 메시지	-	N	-

대사자료 배열(정산대사)

구분	필드명	길이	사용여부	설영
Header	레코드 구분 코드	1	Y	H(고정)
Header	자료 생성일시	14	Y	YYYYMMDDHH24MISS
Header	레코드 수	12	Y	대사 파일 총 레코드 수(Header, Data, Tail 전체)
Header	정산일자	-	N	-
Header	제휴사 거래 고유번호	-	N	-
Header	제휴사 원거래 고유번호	-	N	-
Header	거래 구분 코드	-	N	-
Header	승인일시	-	N	-
Header	취소일시	-	N	-
Header	승인번호	-	N	-
Header	정산금액	-	N	-
Header	정산수수료	-	N	-
Header	부가세	-	N	-
Header	지급보류/해제 금액	-	N	-
Header	입금금액	-	N	-
Header	대사자료 결과 코드	4	Y	대사자료 결과 코드
Header	대사자료 결과 메시지	100	Y	대사자료 응답 메시지
Data	레코드 구분 코드	1	Y	B(고정)
Data	자료 생성일시	-	N	-
Data	레코드 수	12	Y	Sequence Number(1부터 시작, 1씩 증가)
Data	정산일자	8	Y	YYYYMMDD
Data	제휴사 거래 고유번호	40	Y	제휴사 거래 고유번호
Data	제휴사 원거래 고유번호	40	N	취소 거래 시
Data	거래구분 코드	1	Y	A:승인, C:취소
Data	승인일시	14	Y	YYYYMMDDHH24HISS
Data	취소일시	14	Y	YYYYMMDDHH24HISS(취소거래시)
Data	승인번호	20	Y	승인번호
Data	정산금액	22	Y	최초 1byte 부호(+/-)
Data	정산수수료	22	Y	최초 1byte 부호(+/-)
Data	부가세	22	Y	최초 1byte 부호(+/-)
Data	지급보류/해제 금액	-	N	-
Data	입금금액	22	Y	최초 1byte 부호(+/-)
Data	대사자료 결과 코드	-	N	-
Data	대사자료 결과 메시지	-	N	-
Tail	레코드 구분 코드	1	Y	H(고정)
Tail	자료 생성일시	-	N	-
Tail	레코드 수	12	Y	Data 부 레코드 합
Tail	정산일자	-	N	-
Tail	제휴사 거래 고유번호	-	N	-
Tail	제휴사 원거래 고유번호	-	N	-
Tail	거래 구분 코드	-	N	-
Tail	승인일시	-	N	-
Tail	취소일시	-	N	-
Tail	승인번호	-	N	-
Tail	정산금액	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	정산수수료	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	부가세	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	지급보류/해제 금액	22	Y	지급보류/보류해제 금액, 최초 1byte 부호(+/-)
Tail	입금금액	22	Y	입금금액 총합, 최초 1byte 부호(+/-)
Tail	대사자료 결과 코드	-	N	-
Tail	대사자료 결과 메시지	-	N	-

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	ALCO_ID	제휴사 식별자	Y	Field	String	15
Body	VRFC_REQ_DS_CD	요청구분코드	Y	Field	String	2
Body	VRFC_REQ_STS_CD	요청상태코드	Y	Field	String	2
Body	TX_DT	거래일자	Y	Field	String	8
Body	REQ_DT	전송요청일자		Field	String	8
Body	VRFC_ITER_CNT	대사자료 총 건 수	Y	Field	Number	5
Body	VRFC_DATA	대사자료		Field	String[]
Body	RSLT_CD	결과코드	Y	Field	String	4
Body	RSLT_MSG	응답메시지	Y	Field	String	100

대사자료 배열(거래대사)

구분	필드명	길이	사용여부	설영
Header	레코드 구분 코드	1	Y	H(고정)
Header	자료 생성일시	14	Y	YYYYMMDDHH24MISS
Header	레코드 수	-	N	-
Header	제휴사 거래 고유번호	-	N	-
Header	제휴사 원거래 고유번호	-	N	-
Header	거래 구분 코드	-	N	-
Header	승인일시	-	N	-
Header	취소일시	-	N	-
Header	승인번호	-	N	-
Header	정산금액	-	N	-
Header	정산수수료	-	N	-
Header	부가세	-	N	-
Header	대사자료 결과 코드	4	Y	대사자료 결과 코드
Header	대사자료 결과 메시지	100	Y	대사자료 응답 메시지
Data	레코드 구분 코드	1	Y	B(고정)
Data	자료 생성일시	-	N	-
Data	레코드 수	12	Y	Sequence Number(1부터 시작, 1씩 증가)
Data	제휴사 거래 고유번호	40	Y	제휴사 거래 고유번호
Data	제휴사 원거래 고유번호	40	N	취소 거래 시
Data	거래구분 코드	1	Y	A:승인, C:취소
Data	승인일시	14	Y	YYYYMMDDHH24HISS
Data	취소일시	14	Y	YYYYMMDDHH24HISS(취소거래시)
Data	승인번호	20	Y	승인번호
Data	정산금액	22	Y	최초 1byte 부호(+/-)
Data	정산수수료	22	Y	최초 1byte 부호(+/-)
Data	부가세	22	Y	최초 1byte 부호(+/-)
Data	대사자료 결과 코드	-	N	-
Data	대사자료 결과 메시지	-	N	-
Tail	레코드 구분 코드	1	Y	H(고정)
Tail	자료 생성일시	-	N	-
Tail	레코드 수	12	Y	Data 부 레코드 합
Tail	제휴사 거래 고유번호	-	N	-
Tail	제휴사 원거래 고유번호	-	N	-
Tail	거래 구분 코드	-	N	-
Tail	승인일시	-	N	-
Tail	취소일시	-	N	-
Tail	승인번호	-	N	-
Tail	거래금액	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	거래수수료	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	부가세	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	대사자료 결과 코드	-	N	-
Tail	대사자료 결과 메시지	-	N	-

대사자료 배열(정산대사)

구분	필드명	길이	사용여부	설영
Header	레코드 구분 코드	1	Y	H(고정)
Header	자료 생성일시	14	Y	YYYYMMDDHH24MISS
Header	레코드 수	12	Y	대사 파일 총 레코드 수(Header, Data, Tail 전체)
Header	정산일자	-	N	-
Header	제휴사 거래 고유번호	-	N	-
Header	제휴사 원거래 고유번호	-	N	-
Header	거래 구분 코드	-	N	-
Header	승인일시	-	N	-
Header	취소일시	-	N	-
Header	승인번호	-	N	-
Header	정산금액	-	N	-
Header	정산수수료	-	N	-
Header	부가세	-	N	-
Header	지급보류/해제 금액	-	N	-
Header	입금금액	-	N	-
Header	대사자료 결과 코드	4	Y	대사자료 결과 코드
Header	대사자료 결과 메시지	100	Y	대사자료 응답 메시지
Data	레코드 구분 코드	1	Y	B(고정)
Data	자료 생성일시	-	N	-
Data	레코드 수	12	Y	Sequence Number(1부터 시작, 1씩 증가)
Data	정산일자	8	Y	YYYYMMDD
Data	제휴사 거래 고유번호	40	Y	제휴사 거래 고유번호
Data	제휴사 원거래 고유번호	40	N	취소 거래 시
Data	거래구분 코드	1	Y	A:승인, C:취소
Data	승인일시	14	Y	YYYYMMDDHH24HISS
Data	취소일시	14	Y	YYYYMMDDHH24HISS(취소거래시)
Data	승인번호	20	Y	승인번호
Data	정산금액	22	Y	최초 1byte 부호(+/-)
Data	정산수수료	22	Y	최초 1byte 부호(+/-)
Data	부가세	22	Y	최초 1byte 부호(+/-)
Data	지급보류/해제 금액	-	N	-
Data	입금금액	22	Y	최초 1byte 부호(+/-)
Data	대사자료 결과 코드	-	N	-
Data	대사자료 결과 메시지	-	N	-
Tail	레코드 구분 코드	1	Y	H(고정)
Tail	자료 생성일시	-	N	-
Tail	레코드 수	12	Y	Data 부 레코드 합
Tail	정산일자	-	N	-
Tail	제휴사 거래 고유번호	-	N	-
Tail	제휴사 원거래 고유번호	-	N	-
Tail	거래 구분 코드	-	N	-
Tail	승인일시	-	N	-
Tail	취소일시	-	N	-
Tail	승인번호	-	N	-
Tail	정산금액	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	정산수수료	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	부가세	22	Y	거래금액 총합. 최초 1byte 부호(+/-)
Tail	지급보류/해제 금액	22	Y	지급보류/보류해제 금액, 최초 1byte 부호(+/-)
Tail	입금금액	22	Y	입금금액 총합, 최초 1byte 부호(+/-)
Tail	대사자료 결과 코드	-	N	-
Tail	대사자료 결과 메시지	-	N	-

응답 메시지 예제

Body

{ "ALCO_ID": "AL2024011501001", "VRFC_REQ_DS_CD": "01", "VRFC_REQ_STS_CD": "01", "PSWD": "01", "TX_DT": "20241115", "REQ_DT": "20241115", "VRFC_ITER_CNT": 5, "VRFC_DATA": [ "H|20224111413000|7||||||||||0000|거래내역 정상 : AL2020052800001, 20240101 ", "B||1|kbanktest_1687773536000||A|20240101202047||AP202401012020474373|249400|748|0|| ", "B||2|kbanktest_1687773185000||A|20240101142641||AP202401011426423904|205000|615|0|| ", "B||3|kbanktest_1687773099000||A|20240101160539||AP202401011605403976|377000|1131|0|| ", "B||4|kbanktest_1686737199000||A|20240101143520||AP202401011435203911|130000|390|0|| ", "B||5||kbanktest_1686736775000|C||20240101152531|AP202401011525313944|-990000|-2970|0|| ", "T||5|||||||-28600|-86|0|| " ], "RSLT_CD": "0000", "RSLT_MSG": "처리성공" }

kbank

API 상세보기

Kbank

대사자료 전송요청

요청 메시지

요청 메시지 예제

응답 메시지

응답 메시지 예제

대사자료 전송요청

요청 메시지

요청 메시지 예제

응답 메시지

응답 메시지 예제

알림

알림

알림