One-Time Token 요청

API Description

Doc. No. A7S6V1
API Title 결제 > One-Time Token 요청
API Description 결제/충전 요청을 위한 일회용 Token의 발급을 요청 하는 API 입니다.
일회용 Token의 유효시간은 30초 입니다.
Protocol HTTP Interface Type SYNC
HTTP METHOD POST Request URL /api/v1/payment/generate/onetimetoken
Data Encryption Request : YES / Response : YES

Request Parameter

Field Type Length MOC Description
cardNo STRING 16 MANDATORY 회원에게 발급된 실물카드 또는 모바일카드의 번호

Response Parameter

Field Type Length MOC Description
oneTimeToken STRING 16 MANDATORY 일회용 Token
dcvv STRING 3 MANDATORY DCVV
- Dynamic CVV (보안인증코드)
expiryTime NUMBER 0~999999999999 MANDATORY 발급된 일회용 Token의 유효시간
- 단위 : ms
response OBJECT MANDATORY 응답 결과 값
└ code STRING 1~7 MANDATORY 응답 결과 코드
└ description STRING 1~255 MANDATORY 응답 결과 상세 설명

Response Code

HTTP Status Error code Message Description
프로토콜 항목의 "공통 Error Message 정보"에서 추가 확인 바랍니다.
400 006_001 CardNo not found. 일치하는 카드를 찾을 수 없습니다.
400 006_002 Invalid cardNo. 잘못된 카드 번호입니다.
400 006_003 One time token generation failed. 일회용 token 생성에 실패했습니다.

Example

Request


            

        

        

            

                
Response