에러코드

소프트먼트 API 응답에서 반환되는 에러코드와 해결 방법을 확인하세요.

총 46개의 에러코드

공통 공통 에러코드

0000

정상

정상 처리 완료

S001

Authorization 이 비어 있습니다.

HTTP 헤더에 Authorization(Pay Key)을 포함해주세요.

S002

등록되지 않은 가맹점 입니다.

유효한 Pay Key인지 확인하세요. 소프트먼트 관리자 페이지에서 키를 재발급 받을 수 있습니다.

S003

사용 중지된 가맹점 입니다.

가맹점이 중지 상태입니다. 소프트먼트 고객센터에 문의하세요.

S004

보안인증에 실패하였습니다.

Pay Key가 올바른지 확인하세요.

S005

해당 API 호출 URL은 유효하지 않습니다.

API URL을 확인하세요. base URL: https://papi.softment.co.kr

S013

시스템 에러

일시적인 시스템 오류입니다. 잠시 후 재시도하거나 고객센터에 문의하세요.

거래등록 거래등록 에러코드

S006

returnUrl 이 비어 있습니다.

결제 완료 후 리다이렉트될 URL을 입력하세요.

S007

amount 가 비어 있습니다.

결제 금액을 입력하세요.

S008

goodsName 이 비어 있습니다.

상품명을 입력하세요.

S009

device 가 비어 있습니다.

디바이스 타입(pc/mobile)을 입력하세요.

S010

trackId 가 비어 있습니다.

가맹점 주문번호를 입력하세요.

S011

device 형식 오류입니다.

device는 "pc" 또는 "mobile"만 허용됩니다.

S012

amount 형식 오류입니다.

결제 금액은 숫자만 입력하세요.

S014

returnUrl 형식 오류입니다.

올바른 URL 형식으로 입력하세요. (https:// 포함)

S019

이미 등록된 거래번호 입니다.

trackId가 중복됩니다. 고유한 주문번호를 사용하세요.

S030

payerName 이 비어 있습니다.

결제자 이름을 입력하세요.

S031

payerTel 이 비어 있습니다.

결제자 전화번호를 입력하세요.

S032

payerTel 형식 오류입니다.

올바른 전화번호 형식으로 입력하세요. (예: 010-1234-5678)

S033

payerName 형식 오류입니다.

구매자 성명 형식을 확인하세요.

S034

device 형식 오류입니다. (ios/aos 미지원)

WebView에서는 device를 pc 또는 mobile로만 설정하세요.

S035

goodsName 형식 오류입니다.

상품명에 허용되지 않는 문자가 포함되어 있습니다.

S036

payerTel 형식 오류입니다.

구매자 전화번호 형식을 확인하세요. (예: 010-1234-5678)

S040

cpCode 가 비어 있습니다.

directPay=Y 설정 시 cpCode(간편결제사 코드)는 필수입니다.

S041

유효하지 않은 cpCode 입니다.

유효한 cpCode: KKO(카카오페이), NPAY(네이버페이), TOSS(토스페이), SAM(삼성페이), PCO(페이코)

S042

간편결제 미등록 가맹점 입니다.

해당 간편결제 서비스가 가맹점에 활성화되지 않았습니다. 소프트먼트에 문의하세요.

S043

허용되지 않은 결제수단입니다.

해당 결제수단은 가맹점에 활성화되어 있지 않습니다.

S044

cpType 형식 오류입니다.

cpType은 C(카드) 또는 M(머니/포인트)만 허용됩니다.

S045

rcptType 형식 오류입니다.

rcptType은 0(미발행), 1(소득공제용), 2(지출증빙용)만 허용됩니다.

S046

rcptNo 형식 오류입니다.

현금영수증 번호를 확인하세요. 휴대폰번호(10~11자) 또는 사업자번호(10자)

S047

appScheme 형식 오류입니다.

앱스킴 형식을 확인하세요. 최대 256자

승인 승인요청 에러코드

S015

trxId 가 비어 있습니다.

거래등록에서 받은 거래 ID를 입력하세요.

S016

amount 가 비어 있습니다.

승인 요청 금액을 입력하세요.

S017

authorizationId 가 비어 있습니다.

인증 완료 후 받은 인증 ID를 입력하세요.

S018

존재하지 않는 거래 정보 입니다.

trxId가 유효하지 않거나 만료되었습니다. 거래등록부터 다시 진행하세요.

S037

거래등록 금액과 다릅니다.

거래등록 시 금액과 승인요청 금액이 일치하지 않습니다. 동일한 금액을 사용하세요.

S038

이미 취소된 거래 입니다.

이미 취소 처리된 거래입니다.

S039

이미 승인된 거래 입니다.

이미 승인 완료된 거래입니다. 중복 승인은 불가능합니다.

취소 거래취소 에러코드

S020

rootTrxId 가 비어 있습니다.

원거래 ID를 입력하세요.

S021

trackId 가 비어 있습니다.

취소 요청 주문번호를 입력하세요.

S022

amount 가 비어 있습니다.

취소 금액을 입력하세요.

S023

존재하지 않는 원거래 정보 입니다.

rootTrxId가 유효하지 않습니다.

S024

취소 가능 금액이 부족합니다.

취소 요청 금액이 남은 결제 금액보다 큽니다.

S025

이미 전액 취소된 거래 입니다.

이미 전액 취소 처리된 거래입니다.

조회 거래조회 에러코드

S026

trxId 가 비어 있습니다.

조회할 거래 ID를 입력하세요.

S027

존재하지 않는 거래 정보 입니다.

해당 trxId로 등록된 거래가 없습니다.

공통 응답 형식

모든 API 응답은 아래 형식으로 반환됩니다.

{
  "data": { ... },
  "success": true,
  "message": "정상",
  "resCode": "0000"
}

거래 상태값

거래조회 응답에서 반환되는 거래 상태 코드입니다.

상태 코드	설명
WAITING	결제 대기
APPROVED	승인 완료
PARTIAL_CANCELLED	부분 취소
CANCELLED	전체 취소

카드사 코드

승인 응답에서 반환되는 카드사 식별 코드입니다.

코드	카드사
029	신한카드
016	국민카드
006	하나카드(외환)
018	농협카드
026	BC카드
031	삼성카드
027	현대카드
045	롯데카드
032	우리카드
035	수협카드
039	신협카드
037	우체국카드
049	광주카드
043	전북카드
041	제주카드
042	MG새마을금고카드
048	산은카드(KDB)
044	카카오뱅크카드
028	토스카드(하나머니)
070	케이뱅크카드
071	저축은행카드
080	한국씨티카드
034	중국은행카드
036	중국건설은행카드

간편결제 코드

거래등록 시 사용하는 간편결제 서비스 식별 코드입니다.

코드	서비스
KKO	카카오페이
NPAY	네이버페이
TOSS	토스페이
SAM	삼성페이
PCO	페이코

결제수단 코드

승인 응답의 payMethodTypeCode에서 반환되는 결제수단 분류 코드입니다.

코드	결제수단
11	신용카드
50	간편결제 (포인트/머니)
60	간편결제 (카드)