API 문서
전체 API
서비스
신용카드 충전 거래 생성동기
버전: v1
버전: v1
/api/v1/recharges/online-payment/transaction/generate
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
transactionId
string
필수
길이 : 20
신용카드 충전 요청 거래 번호
redirectUrl
string
필수
길이 : 200
신용카드 결제창 오픈 요청 URL 주소
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
400
에러 코드
000_002
메시지
Invalid input parameter. userId
설명
입력 파라미터 오류.
400
에러 코드
000_003
메시지
Missing required values. sequenceId
설명
필수 파라미터가 누락되었습니다.
400
에러 코드
007_008
메시지
Same sequenceId already exists.
설명
같은 sequenceId로 요청한 이력이 있을 경우 발생.
400
에러 코드
007_025
메시지
Charging request has already been received.
설명
신용카드 충전하기 거래가 진행 중인 상태에서 충전하기 요청이 유입되었을 경우
400
에러 코드
007_020
메시지
Less than minimum transaction amount.
설명
거래 가능 최소 금액 이하로 충전 시도한 경우
400
에러 코드
007_021
메시지
Expired card.
설명
만료된 카드로 충전 시도한 경우
400
에러 코드
007_032
메시지
Incorrect affiliate id.
설명
올바른 affiliateId 가 아님
400
에러 코드
007_033
메시지
Exceed max holding amount.
설명
보유 한도를 초과 하였음
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.