본문으로 건너뛰기

거래인증 등록

인증 화면 호출을 하기 위해 결제정보를 등록하면 인증창 호출 URL을 응답으로 받을 수 있습니다.

정보

요청​

요청 URL
POST https://{API 도메인}/easycheck/auth/paymentAuthReg.do
Content-type: application/json; charset=euc-kr
참고

API 멱등성 지원 대상 (API 멱등성 참조)

파라미터​

필드명타입길이필수여부설명
customerKeyString60Byte✅간편결제 회원 고유키
easypayVirtualNoString60Byte✅고객이 선택한 결제수단 가상번호
payMethodTypeCodeString2Byte✅고객이 선택한 결제수단 코드 (결제수단 코드 참고)
payMethodDetailCodeString3Byte✅고객이 선택한 결제수단 상세코드 (결제수단 코드 참고)
shopTransactionIdString60Byte✅제휴사 거래고유번호 (API 멱등성 키)
shopOrderNoString40Byte✅제휴사 주문번호
currencyString2Byte통화코드(온라인일 경우 필수) 원화 : “00”
returnUrlString256Byte✅인증 후 되돌아갈 제휴사 리턴URL
해당 리턴URL로 Redirect됨(HTTPS만 허용)
shopParameterString4000Byte제휴사 예비필드(개인정보에 해당하는 데이터는 제외하여 전달해야 합니다.)
요청 예시
{  
"channelType": "ON",
"customerKey": "{간편결제 회원 고유키}",
"easypayVirtualNo": "{고객이 선택한 결제수단 가상번호}",
"payMethodTypeCode": "11",
"payMethodDetailCode": "026",
"shopTransactionId": "{API 멱등성 키}",
"shopOrderNo": "{제휴사 주문번호}",
"currency": "00",
"amount": 1000,
"goodsName": "예시 상품명",
"returnUrl": "{제휴사 리턴 URL}"
}

응답​

파라미터​

필드명타입길이설명
resCdString4Byte결과코드(정상 : “0000”)
resMsgString1000Byte결과 메시지
shopTransactionIdString60Byte요청 시 전송한 값 그대로 사용
authPageUrlString256Byte인증창 호출 URL(URL Encoding 됨)
응답 예시
{
"resCd": "0000",
"resMsg": "정상처리",
"shopTransactionId": "{API 멱등성 키}",
"authPageUrl": "{인증창 호출 URL}"
}