인터페이스 개요
본 API는 서버측에서 주문 식별자를 기반으로 결제 서명을 생성하여 타사 결제 시스템 호출을 지원합니다.
엔드포인트
POST /v1/pay
데이터 포맷
전송 프로토콜
HTTP/POST
요청 매개변수
| 파라미터 | 타입 | 필수 | 설명 |
|---|
| token | String | 예 | 인증 토큰 |
| appId | string | 아니오 | 디바이스 고유 식별자 |
| appVersion | string | 아니오 | 애플리케이션 버전 |
| imei | string | 아니오 | 기기 IMEI 코드 |
| phoneModel | string | 아니오 | 휴대폰 모델명 |
| timestamp | string | 예 | 유닉스 타임스탬프 |
| orderId | string | 예 | 주문 식별자 |
| orderType | int | 예 | 서비스 유형 (1: 일반, 2: 기업, 3: 서비스A, 4: 미니앱) |
| payment | int | 예 | 결제 수단 (0: 무료, 1: 알리페이 앱, 2: 위챗 앱, 3: 기업, 4: 잔액, 5: 은련, 201: 공개계정/미니앱) |
| openId | String | 조건부 | payment=201 또는 421 시 필수 |
| appCode | String | 조건부 | payment=201 또는 421 시 필수 (예: 12021) |
appCode 예시: 10010(무료결제), 11010(알리페이), 12020(위챗앱), 12021(미니앱)
요청 샘플
orderId=ORD2023&orderType=2&payment=4
응답 구조
| 필드 | 타입 | 필수 | 설명 |
|---|
| code | Integer | 예 | 결과 상태 코드 |
| msg | String | 아니오 | 오류 메시지 |
| data | Object | 아니오 | 결제 데이터 객체 |
결제 수단별 응답
알리페이 응답
{
"data": "암호화된_결제_문자열"
}
위챗페이 응답
| 필드 | 타입 | 설명 |
|---|
| app_id | String | 위챗 앱 식별자 |
| partnerid | String | 가맹점 ID |
| prepayid | String | 결제 세션 ID |
| package | String | 고정값(Sign=WXPay) |
| noncestr | String | 32자 이내 난수 |
| timestamp | String | 타임스탬프 |
| sign | String | 전자서명 |
미니앱 결제 응답
{
"code": 0,
"data": {
"appId": "APP123",
"timeStamp": "1685000000",
"nonceStr": "RAND_STR",
"package": "prepay_id=PREPAY123",
"signType": "MD5",
"paySign": "SIGNATURE_HASH"
}
}
기업 결제 응답
{
"code": 0,
"msg": "결제 완료"
}
상태 코드
| 코드 | 메시지 |
|---|
| 200 | 결제 성공 |
| 4001 | 이미 처리된 주문 |
| 4002 | 취소된 주문 |
| 4003 | 유효하지 않은 주문 |
| 4004 | 지원되지 않는 결제 수단 |
| 4005 | 메시지 큐 오류 |
| 4006 | 처리 실패 |