Konaplate logo

API 문서

전체 API

서비스


충전 및 충전취소 결과 확인동기

버전: v1


버전: v1

POST

/api/v1/recharges/by-bank-account/result/inquiry

회원에 등록된 계좌를 이용하여 선불카드의 잔액으로 충전 및 충전취소 처리된 결과를 확인 합니다.

요청 헤더


X-KM-User-AspId

string

필수

길이 : 15

ASP ID

  • 서비스 사업자에게 부여한 ID입니다.
  • ID는 계약 시 제공됩니다.

X-KM-Correlation-Id

string

필수

길이 : 20

전문 추적을 위한 거래번호

  • 형식 : yyMMddHHmiSS-xxxxxxx
  • xxxxxxx : 7자리, Hex String

X-KM-Access-Key

string

조건부

길이 : 40

프로젝트에서 생성된 Access Key

  • Callback API 인 경우는 제외합니다.

X-KM-Crypto-Key-Id

string

옵션

길이 : 32

데이터암복호화 키 ID

  • 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
  • 데이터 암호화 요청 시 필수 입력값입니다. (Data Encryption = Y)

X-KM-Tran-Token

string

필수

길이 : 66

공통 Header 정보 - X-KM-Tran-Token

X-KM-Tran-Time

string

필수

길이 : 14

클라이언트 요청 시간

  • 형식 : YYYYMMDDHHMMSS

X-KM-Time-Zone

string

필수

길이 : 3

시간대 정보 (UTC, KST, ...)

요청 파라미터


sequenceId

string

필수

최소 : 1 , 최대 : 30

관리번호

충전 및 충전취소 요청 시 입력하였던 값입니다.

응답 헤더


X-KM-Correlation-Id

string

필수

길이 : 20

전문 추적을 위한 거래번호

  • 형식 : yyMMddHHmiSS-xxxxxxx
  • xxxxxxx : 7자리, Hex String

X-KM-Crypto-Key-Id

string

옵션

길이 : 32

데이터암복호화 키 ID

  • 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
  • Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.

응답 파라미터


result

string

필수

최소 : 6 , 최대 : 9

충전/충전 취소 거래 결과

  • COMPLETED
    • 충전/충전 취소 거래 완료
  • FAILED
    • 충전/충전 취소 거래 실패
  • PENDING
    • 거래 과정에서 PG(쿠콘 또는 오픈뱅킹)에 고객 계좌로부터 출금 이체 요청 시, 네트워크 불안 등의 원인으로, PG로부터 정상적으로 응답을 받지 못하는 경우 은행 또는 PG의 상황에 따라. 다소 시간이 걸릴 수 있으며, 지속적으로 PG에 해당 출금 이체의 성공 여부를 체크합니다. 성공할 경우, 카드 충전 거래를 완료하며, 실패할 경우, 충전 실패 처리를 합니다.

응답 코드

Detailed classification and addition of error for unseccessful withfrawal


200

에러 코드

000_000

메시지

Success

설명

성공


400

에러 코드

000_002

메시지

Invalid input parameter. sequenceId

설명

잘못된 요청, api의 request한 parameter가 부정확


400

에러 코드

007_009

메시지

Previous transaction not found.

설명

잘못된 요청, api의 request한 parameter가 부정확


400

에러 코드

007_009

메시지

Previous transaction not found.

설명

해당 sequenceId와 merchantId로 조회 되는 카드 충전/ 충전 취소 결과가 없음

테스트 데이터

200 - 성공 테스트


200 - 성공 테스트
400 - 잘못된 요청, api의 request한 parameter가 부정확
400 - 해당 sequenceId와 merchantId로 조회 되는 카드 충전/ 충전 취소 결과가 없음
Loading ...

Request

Loading...

Response

Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.


회원 가입회원 정보 조회회원 비밀번호 재설정 및 변경회원 정보 변경회원 탈퇴회원 로그인 ID 확인휴면 회원 해제약관 목록 조회약관 동의 및 철회CI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회금융사 목록 조회계좌 예금주 실명 검증ARS 인증 전 인증코드 생성PG를 통한 은행 계좌 등록계좌 등록 상태 조회기명화 및 한도상향(개인)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제일회용 토큰 발급계좌 충전계좌 충전취소충전 및 충전취소 결과 확인거래내역 확인선불카드 발급 및 배송 신청카드 신청 취소선불카드 재발급(교체발급)만료 예정 선불카드 재발급 갱신카드 배송 상태 조회실물카드와 연결 가능한 모바일카드 신청 정보 조회실물카드 등록보유카드 조회미등록 카드 조회카드 상태 변경카드 폐기기명화 및 한도상향(개인)기명화 및 한도상향(법인)법인 기명화 여부 조회소득공제 신청카드 소득공제 신청 여부 조회카드 매핑 회원 조회카드 상품ID로 상품 정보 조회주카드 설정카드에 연결된 가상계좌 조회회원 가입회원 정보 조회회원 비밀번호 재설정 및 변경회원 정보 변경회원 탈퇴회원 로그인 ID 확인휴면 회원 해제약관 목록 조회약관 동의 및 철회CI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회금융사 목록 조회계좌 예금주 실명 검증ARS 인증 전 인증코드 생성PG를 통한 은행 계좌 등록계좌 등록 상태 조회기명화 및 한도상향(개인)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제