PayApp 서비스 연동 매뉴얼 입니다.

  • 판매자 관리 사이트의 메뉴 "설정"탭의 "연동 Key", "연동 Value" 값으로 연동이 가능합니다.
  • 본 연동 매뉴얼에 설명하는 API는 서버에서 호출하는 API로 사용자에게 보여지는 디자인이 되어있지 않습니다.
  • 샘플 파일은 결제연동을 위해 기본적인 사항만 기재되어 있으므로 실제 개발 시에는 샘플 페이지를 참고하여 고객사의 환경에 맞게 연동 하시기 바랍니다.
  • 연동 매뉴얼에 설명하는 API의 값을 임의로 변조,변형 하신 경우 결제가 원활하게 이뤄지지 않을 수 있으며, 최신 업데이트가 적용되지 않기 때문에 동작을 보장할 수 없습니다.
  • 결제 샘플 코드는 참조용으로 결제 연동 개발에 대한 모든 책임은 가맹점에 있습니다.
  • 매뉴얼 다운로드

연동 API 구성방법

연동 환경

  • 자체개발된 서버사이드 스크립트 언어가 연동가능한 개발환경이라면 페이앱 API 연동이 가능합니다.
  • 임대형 쇼핑몰을 이용중이시라면 임대를 해준 업체에 페이앱 API 연동을 문의하셔야 합니다.(예 : 카페24, 고도몰, 메이크샵 등..)
  • 템플릿형 사이트나 쇼핑몰을 이용중이시라면 소스코드의 편집 및 수정이 가능한 템플릿에서만 페이앱 API 연동이 가능합니다.

연동 방법

  • 웹사이트 api.payapp.kr의 REST URL 페이지를 호출해서 응답 값을 받아 연동합니다.
  • REST API URL 페이지 호출은 서버에서 실행이 되어야 합니다. (Server Side 호출)

REST API URL 주소

  • https://api.payapp.kr/oapi/apiLoad.html

호출 파라메터

  • 호출 파라메터는 FORM POST 방식으로 REST API URL 주소에 전달합니다.
  • 호출 파라메터의 각 값은 UTF-8로 인코딩된 문자열 이어야 합니다.

응답 파라메터

  • 응답 파라메터는 KEY, VALUE 쌍으로 URL encoding된 query 값으로 생성됩니다.

연동 KEY, VALUE

  • 판매자 회원가입 후 판매자 관리 사이트의 메뉴 “설정” 탭의 “연동 정보” 값이 있어야 연동이 가능합니다.
  • 연동 정보 값은 판매자 회원마다 값이 다르며 영문 대/소문자, 숫자, 기호로 구성되어 있습니다.
  • 연동 정보 값은 보안상의 이유로 외부로 유출이 되지 않도록 주의 하시기 바랍니다.

테스트 정보

  • 판매자 회원 아이디 userid payapptest

연동 예제

  • 현재 페이지의 연동 예제는 기본 PHP 제공
  • 매뉴얼을 다운로드 하시면 PHP, JSP 예제파일이 있으며 연동문서를 같이 다운받을 수 있습니다.

오류코드

코드번호 설명 해결
70001 보안접속(https)으로 호출하지 않을 경우 https로 호출하도록 수정
70010 userid, linkkey값이 정확하지 않을 경우 userid, linkkey값을 확인 후 수정
70020 파라메터값이 정확하지 않을 경우 전달한 파라메터값중 공백이나 잘못된 값이 입력된 경우 수정
70040 cmd값이 정확하지 않은 경우 cmd값을 확인 후 연동하고자 하는 api cmd값으로 수정
70060 권한이 없는 경우 userid의 사용권한을 확인
70080 고객사 응답 실패일 경우 고객사 feedbackurl로 접속하여 SUCCESS 확인
80010 취소가 가능한 상태가 아닙니다
80020 취소가 가능한 상태가 아닙니다
80030 취소금액을 확인하세요

빠른시작(Quick Start)

  • 고객사의 프로그램에 맞게 수정 하셔서 사용하셔야 합니다.
  • 매뉴얼의 예제 프로그램으로 작성되었습니다.(결제 요청 JS API 연동)
  • 매뉴얼의 JS(https://lite.payapp.kr/public/api/v2/payapp-lite.js)를 임의로 변경하실 경우, 연동이 원활하게 이뤄지지 않을 수 있으며, 최신 업데이트가 적용되지 않기 때문에 동작을 보장할 수 없습니다.

결제요청 API

파라메터 설명
페이앱 아이디
상점명
상품명
결제요청 금액
수신 휴대전화번호
결제요청 메모
주소요청
통화단위
국제전화 식별코드
결제요청 성공 URL
결제요청 성공 URL 방향
결제요청 웹노티 URL
"Feedbackurl 전달" 참고
feedbackurl 재시도
결제완료 이동 URL
임의 사용 변수1
임의 사용 변수2
결제요청 SMS 발송여부
캐릭터셋
결제수단 선택
신용카드card휴대전화phone
카카오페이kakaopay네이버페이naverpay
스마일페이smilepay계좌이체rbank
가상계좌vbank애플페이applepay
페이코payco위챗페이wechat
콤마(,) 구분으로 결제수단 선택이 가능합니다.
값이 없는 경우 이용 가능한 결제수단이 모두 선택됩니다.
ex) phone,card 인 경우 휴대전화,신용카드 결제만 가능합니다.
판매자 결제 설정의 값이 우선합니다.
결제창으로 리다이렉션
과세대상 금액
면세금액
부가세
부계정 아이디
구매자 아이디
매출전표 페이지 이동
← 좌우 스크롤하세요 →
  • 파라메터 판매자 회원 아이디(userid), 상점명(shopname)은 필수 항목입니다.
  • 자세한 내용은 API연동 매뉴얼("결제요청")을 참고하시기 바랍니다.

결제요청 연동 구성

연동 방식

연동 구성

  • REST API를 이용할 경우 샘플기준 payapp_payrequest.php, payapp_feedbackurl.php 를 참고하시면 됩니다.
  • JS API를 이용할 경우 payapp_payrequest_js.php, payapp_feedbackurl.php 를 참고하시면 됩니다.

결제 요청 – JS 방식

  • JS 방식은 자바스크립트를 이용해 고객사 웹페이지에 쉽게 연동을 진행하는 API입니다.
  • "JS API" 는 PAYAPP REST API 를 HTML 및 자바스크립트를 이용해 연동할 수 있도록 제작된 WRAPPER API 입니다.
  • 연동 매뉴얼 "빠른 시작"을 참고 하시기 바랍니다.
  • 매뉴얼의 JS(https://lite.payapp.kr/public/api/v2/payapp-lite.js)를 임의로 변경하실 경우, 연동이 원활하게 이뤄지지 않을 수 있으며, 최신 업데이트가 적용되지 않기 때문에 동작을 보장할 수 없습니다.

시작하기

연동을 원하는 페이지 내에 스크립트를 삽입합니다.
<script src="https://lite.payapp.kr/public/api/v2/payapp-lite.js"></script>
팝업창 API 연동

파라메터 설정

결제 파라메터는 두 가지 방식으로 설정이 가능합니다.
자바스크립트는 반드시 <script></script> 태그 내에 작성되어야 합니다.

1. HTML 폼 사용

HTML 로 폼을 작성한 후 자바스크립트로 해당 폼을 등록할 수 있습니다.

HTML

<form name="{폼이름}">
    <input type="hidden" name="{파라메터1}" value="{설정값1}">
    <input type="hidden" name="{파라메터2}" value="{설정값2}">
</form>

자바스크립트

PayApp.setForm('{폼이름}');

2. 자바스크립트 사용

제공되는 자바스크립트 메써드를 통해 파라메터를 설정할 수 있습니다.
PayApp.setParam('{파라메터1}','{설정값1}');
PayApp.setParam('{파라메터2}','{설정값2}');
팝업창 API 연동

결제창 호출

설정된 파라메터를 사용하여 결제창을 호출합니다.
PayApp.payrequest();
팝업창 API 연동

파라메터 목록

기본 정보

파라메터 필수 Type Description
userid 필수 string 판매자 회원 아이디

판매자 회원 아이디 userid 필수

페이앱에 로그인하는 판매자 아이디를 입력합니다.

결제 정보

파라메터 필수 Type Description
shopname 필수 string 상점명
goodname 필수 string 상품명
price 필수 int 결제요청 금액
recvphone string 수신 휴대폰번호
memo string 메모
reqaddr int 주소요청
currency string 통화단위
vccode string 국가번호

상점명 shopname 필수

결제창에 표시할 상점명을 입력합니다.

상품명 goodname 필수 사용자입력

결제창에 표시할 상품명을 입력합니다.
빈값으로 입력될 경우 사용자가 직접 입력할 수 있는 입력박스가 결제창에 표시됩니다.

결제요청 금액 price 필수 사용자입력

결제창에 표시할 결제금액을 입력합니다.
빈값으로 입력될 경우 사용자가 직접 입력할 수 있는 입력박스가 결제창에 표시됩니다.

수신 휴대폰번호 recvphone 미리입력 사용자입력

결제창에 표시할 휴대폰번호를 입력합니다.
전송된 값으로 미리 입력이 되어 있으며 사용자가 직접 입력하거나 수정할 수 있습니다.

메모 memo

사용자 휴대폰으로 전송된 결제페이지에 입력된 메모가 표시됩니다.

주소요청 reqaddr

0 [기본값] 요청안함 1 요청함
사용자 휴대폰으로 전송된 결제페이지에서 주소를 입력받을 수 있습니다.

통화단위 currency

krw [기본값] KRW usd USD
결제를 받을 통화단위를 설정할 수 있습니다.

국가번호 vccode 미리입력 사용자입력

SMS 전송에 필요한 국제전화 국가번호를 입력합니다.
currencyusd로 설정하는 경우 결제창에 입력란이 표시됩니다.
전송된 값으로 미리 입력이 되어 있으며 사용자가 직접 입력하거나 수정할 수 있습니다.

연동 정보

파라메터 필수 Type Description
redirecturl string 결제요청 성공 URL
redirect string 결제요청 성공 URL 방향
feedbackurl string 결제요청 피드백 URL
returnurl string 결제완료 이동 URL
var1 string 임의 사용 변수 1
var2 string 임의 사용 변수 2
smsuse string 결제요청 SMS 발송여부
charset string 캐릭터셋
openpaytype string 결제수단 선택
checkretry string feedbackurl 재시도
redirectpay string 결제창으로 리다이렉션
amount_taxable int 과세대상 금액
amount_taxfree int 면세 금액
amount_vat int 부가세
subuserid string 판매자 부계정 아이디
buyerid string 구매자 아이디
skip_cstpage string 매출전표 페이지 이동 여부 (y:매출전표 페이지 이동 안함)

결제요청 성공 URL redirecturl

결제요청 성공시 결제창이 이동할 URL 을 입력합니다.
설정된 값이 없을 경우 결체요청 완료 후 결제창이 닫히며 종료됩니다.

결제요청 성공 URL 방향 redirect

opener [기본값] 부모창 self 현재창
결제요청 성공시 결제요청 성공 URL redirecturl로 이동할 방향을 지정합니다.

결제요청 피드백 URL feedbackurl

결제 데이터가 생성되거나 상태가 변경될 경우 해당 URL 로 결과값을 전송합니다.
전송시점: 최초 결제요청, 사용자가 결제를 완료했을 경우, 요청취소 또는 승인취소
JS API에서 feedbackurl에 값이 있는 경우 요청상태(pay_state=1)으로 최초 노티되며 응답으로 'SUCCESS'가 있어야 결제진행이 가능합니다.
결과값에 대한 자세한 내용은 PAYAPP REST API 매뉴얼 '결제통보'를 참고하시길 바랍니다.

결제완료 이동 URL returnurl

사용자의 결제페이지에서 사용자가 결제를 완료할 경우
특정 URL 로 페이지가 이동하도록 설정할 수 있습니다.
해당 API를 통해 호출된 현재 결제창에는 영향을 주지 않습니다.
(가상계좌의 경우 입금대기)

임의 사용 변수 var1 var2

필요한 임의의 값을 입력하여 사용할 수 있습니다.

결제수단 선택 openpaytype

결제수단 선택 (휴대전화:phone, 신용카드:card, 계좌이체:rbank, 가상계좌:vbank, 카카오페이:kakaopay, 네이버페이:naverpay, 스마일페이:smilepay, 애플페이:applepay, 페이코:payco, 위챗페이:wechat)
콤마(,) 구분으로 결제수단 선택이 가능합니다.
값이 없는 경우 이용 가능한 결제수단이 모두 선택됩니다.
ex) phone,card 인 경우 휴대전화,신용카드 결제만 가능합니다.
판매자 결제 설정의 값이 우선합니다.

feedbackurl 재시도 checkretry

feedbackurl 재시도 (y:재시도,n:재시도 안함)
feedbackurl의 응답이 성공이 아니면 feedbackurl 호출을 재시도 합니다. (총 10회 재시도)

결제창으로 리다이렉션 redirectpay

결제창으로 바로 이동할 경우 1로 입력 (1:결제창 리다이렉션)
파라메터 shopname,goodname,price,recvphone 의 값이 있고 redirectpay 파라메터가 '1'인 경우 결제하는 창으로 이동되어 결제를 빠르게 진행할 수 있도록 합니다.

결제요청 SMS 발송여부 smsuse

y [기본값] 발송함 n 발송안함
결제요청 SMS 발송이 필요없는 경우 'n'으로 설정 하시기 바랍니다.

캐릭터셋 charset 주의

auto [기본값] UTF-8/EUC-KR 자동감지 euc-kr EUC-KR 고정
페이지나 시스템에서 UTF-8 이외의 캐릭터셋을 사용할 경우 사용합니다.
결제창에 한글이 정상적으로 표시되지 않는 경우 euc-kr로 설정해 보시길 바랍니다.

파라메터 처리

입력받은 파라메터 값은 모두 자동으로 TRIM(앞뒤 공백 제거) 처리됩니다.
결제금액이나 휴대폰 등의 숫자 파라메터의 경우 숫자 외의 문자는 제거됩니다.
팝업창 API 연동

자바스크립트 메써드

.setForm()

HTML 로 폼을 작성한 후 등록합니다.
등록된 폼을 이용해 결제창에 파라메터를 전달하게 됩니다.
.setParam() 등을 통한 별도의 파라메터 설정은 적용되지 않습니다.

.setForm(string)

폼의 이름이나 아이디를 입력하여 폼을 등록합니다.
PayApp.setForm('{폼이름}');

.setForm(object HTMLFormElement)

폼의 객체를 직접 넘겨 폼을 등록합니다.
var form;
form = document.forms['{폼이름}'];
form = document.getElementById('{폼아이디}');
PayApp.setForm(form);

.setDefault()

파라메터 기본값을 설정합니다.
변경되지 않는 고정값 설정시 사용하시면 됩니다.
폼을 등록하는 경우 동작하지 않습니다.

.setDefault(string, string)

파라메터 기본값을 개별적으로 설정합니다.
PayApp.setDefault('{파라메터1}', '{설정값1}');
PayApp.setDefault('{파라메터2}', '{설정값2}');

.setDefault(object Object)

파라메터 기본값을 오브젝트로 일괄 설정합니다.
PayApp.setDefault({
    '{파라메터1}': '{설정값1}',
    '{파라메터2}': '{설정값2}'
});

.setParam()

파라메터 값을 설정합니다.
.payrequest() 호출 후 설정된 값은 초기화됩니다.
폼을 등록하는 경우 동작하지 않습니다.

.setParam(string, string)

파라메터 값을 개별적으로 설정합니다.
PayApp.setParam('{파라메터1}', '{설정값1}');
PayApp.setParam('{파라메터2}', '{설정값2}');

.setParam(object Object)

파라메터 값을 오브젝트로 일괄 설정합니다.
PayApp.setParam({
    '{파라메터1}': '{설정값1}',
    '{파라메터2}': '{설정값2}'
});

.setTarget()

결제창을 띄울 타겟을 설정합니다.
타겟이 지정되지 않은 경우 PayAppWindow 이름의 새창을 띄워 결제창이 호출됩니다.
작성된 폼을 등록하는 경우에도 해당 메써드를 통해서만 타겟 설정이 가능합니다.
타겟을 설정하는 경우 추가적으로 redirect 파라메터 설정이 필요할 수 있습니다.

.setTarget(string)

별도의 타겟 이름을 사용하거나 HTML 스펙으로 지정된 _ 키워드를 사용할 수 있습니다.
예를 들어 결제창을 현재창에서 페이지 전환하려는 경우 _self로 설정합니다.
PayApp.setTarget('{타겟}');

.payrequest()

결제창을 호출합니다.

.payrequest()

설정된 파라메터를 사용하여 결제창을 호출합니다.
PayApp.payrequest();

.payrequest(object Object)

파라메터 설정과 동시에 결제창을 호출할 수 있습니다.
폼을 등록하는 경우 설정값은 무시됩니다.
PayApp.payrequest({
    '{파라메터1}': '{설정값1}',
    '{파라메터2}': '{설정값2}'
});

Method Chaining

메써드들은 체인으로 연결 가능합니다.
.payrequest() 메써드가 호출되면 체인은 종료됩니다.
// 폼 등록. 결제창 호출
PayApp.setForm('MyForm').payrequest();

// 상품명 설정. 가격 설정. 결제창 호출.
PayApp.setParam('goodname', '좋은상품').setParam('price', '2000').payrequest();

jQuery

결제 연동시 jQuery 가 필요한 경우 PayApp.$ 또는 PayApp.jQuery를 통해 내부에 포함된 jQuery 를 사용할 수 있습니다.
// jQuery 버전 확인
alert(PayApp.$().jquery);

// 1. 결제버튼 비활성화
PayApp.$('#pay-button').attr('disabled', 'disabled');
// 2. 결제창 호출
PayApp.payrequest();
// 3. 결제버튼 활성화
PayApp.$('#pay-button').removeAttr('disabled');
팝업창 API 연동

연동 예제

HTML 폼 사용

<script src="https://lite.payapp.kr/public/api/v2/payapp-lite.js"></script>
<script>
function myPay() {
    PayApp.setForm('MyForm');
    PayApp.call();
}
</script>

<form name="MyForm">
    <input type="hidden" name="userid"   value="payapptest">
    <input type="hidden" name="shopname" value="좋은상점">
    <input type="hidden" name="goodname" value="착한상품">
    <input type="hidden" name="price"    value="1000">
</form>

<a href="#" onclick="myPay();">결제하기</a>

자바스크립트 사용

<script src="https://lite.payapp.kr/public/api/v2/payapp-lite.js"></script>
<script>
PayApp.setDefault('userid',     'payapptest');
PayApp.setDefault('shopname',   '좋은상점');

function myPay() {
    PayApp.setParam('goodname', '착한상품');
    PayApp.setParam('price',    '1000');
    PayApp.call();
}
</script>

<a href="#" onclick="myPay();">결제하기</a>

자바스크립트 사용 #2

<script src="https://lite.payapp.kr/public/api/v2/payapp-lite.js"></script>
<script>
PayApp.setDefault('userid',     'payapptest');
PayApp.setDefault('shopname',   '좋은상점');
</script>

<a href="#" onclick="PayApp.setParam('goodname', '좋은상품').setParam('price', '1000').call();">좋은상품 결제하기</a>
<a href="#" onclick="PayApp.call({'goodname': '보통상품', 'price': '2000'});">보통상품 결제하기</a>
<a href="#" onclick="PayApp.call({'goodname': '나쁜상품', 'price': '3000'});">나쁜상품 결제하기</a>

사용자 입력 결제창

<script src="https://lite.payapp.kr/public/api/v2/payapp-lite.js"></script>
<script>
PayApp.setDefault('userid',     'payapptest');
PayApp.setDefault('shopname',   '좋은상점');
</script>

<a href="#" onclick="PayApp.call();">결제하기</a>

결제요청 연동

결제 요청 – REST 방식

  • REST 방식은 모바일 기기, 브라우저 등 다양한 단말기와 프로그램을 지원하는 API입니다.
  • 호출 파라메터 중 userid,goodname,price,recvphone 값은 필수 입니다.
  • feedbackurl 의 값은 “http://” 가 포함된 url 주소 값입니다.
  • 구매자가 결제완료시feedbackurl로 아래 “feedbackurl 전달”파라메터가 POST방식으로 전달 됩니다.
  • feedbackurl에서 다른 url로 리다이렉션(http code 302, 또는 javascript) 처리하시면 자료전달이 되지 않습니다.
    (feedbackurl 이외 다른페이지로 이동되지 않습니다.)
  • var1, var2 의 값은 임의로 사용이 가능하며 결제 완료시feedbackurl로 그대로 전달이 됩니다.
  • 결제요청 구분 (reqmode)가 usd (달러결제) 인 경우 openpaytype은 무시됩니다.
    (신용카드 결제만 가능)
  • goodname, memo 항목에는 URI 주소가 포함될 수 없습니다.
  • 안드로이드와 아이폰 앱의 연동일 경우 하단 파라메터 목록의 appurl을 반드시 포함하여 전송해 주셔야 합니다.
    예제 파일을 다운로드 받으셔서 카드사 스키마를 참고 후 연동바랍니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html
REST API 연동

호출 파라메터 목록

파라메터 필수 Type Description
cmd 필수 String 결제요청 payrequest
userid 필수 String 판매자 회원 아이디
goodname 필수 String 상품명
price 필수 int 결제요청 금액
recvphone 필수 String 수신 휴대폰번호
memo String 메모
reqaddr int 주소요청 (1:요청, 0:요청안함)
feedbackurl String 결제완료 후 결과값을 리턴받을 고객사 URL ("결제통보" 참고)
var1 String 임의 사용 변수 1
var2 String 임의 사용 변수 2
smsuse String 결제요청 SMS 발송여부 (n: SMS발송안함)
reqmode String 결제요청 구분 (krw:원화결제,usd:달러결제)
vccode String 국제전화 국가번호 (currency가 usd일 경우 필수)
returnurl String 결제완료 후 이동할 링크 URL (매출전표 페이지에서 "확인"버튼 클릭시 이동, 가상계좌의 경우 입금대기)
amount_taxable int 과세 공급가액
amount_taxfree int 면세 공급가액
amount_vat int 부가세
openpaytype String 결제수단 선택
신용카드card휴대전화phone
카카오페이kakaopay네이버페이naverpay
스마일페이smilepay계좌이체rbank
가상계좌vbank애플페이applepay
페이코payco위챗페이wechat
콤마(,) 구분으로 결제수단 선택이 가능합니다.
값이 없는 경우 이용 가능한 결제수단이 모두 선택됩니다.
ex) phone,card 인 경우 휴대전화,신용카드 결제만 가능합니다.
판매자 결제 설정의 값이 우선합니다.
checkretry String feedbackurl 재시도 (y:재시도,n:재시도 안함)
feedbackurl의 응답이 성공이 아니면 feedbackurl 호출을 재시도 합니다. (총 10회 재시도)
recvemail String 수신 이메일 주소
skip_cstpage String 매출전표 페이지 이동 여부 (y:매출전표 페이지 이동 안함)
y 일 경우 returnurl 페이지로 POST로 페이지 이동합니다.
( 보안을 위해 결제완료 처리는 feedbackurl 페이지에서 하셔야 합니다. )
appurl String 앱스키마는 카드사앱 스키마가 아닌 앱제작사의 스키마를 사용합니다.
subuserid String 부계정 아이디
buyerid String 구매자 아이디
호출 예제)
curl -d "cmd=payrequest" \
-d "userid=[고객사 아이디]" \
-d "goodname=api%20test" \
-d "price=1000" \
-d "recvphone=[구매자 휴대전화 번호]" \
-d "smsuse=n" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage "" String 실패시 오류 문자열
mul_no "" int 성공시 결제요청 번호
payurl "" String 결제창URL
qrurl "" String 결제창 QR URL
응답 예제)
state=1&errorMessage=&mul_no=2000&payurl=http%3A%2F%2Fpayapp.kr%2F000000000000
REST API 연동

연동 예제

  • http://고객사 도메인/payapp_popup.php
  • 구매자가 결제를 요청하는 페이지입니다. 고객사에서 개발하시는 페이지입니다.
  • 예제파일 payapp_request.php로 post전송합니다.
  • "{변수}"는 개발환경에 맞추어서 정의바랍니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.
  • http://고객사 도메인/payapp_request.php
  • 고객사 서버에서 페이앱서버로 결제를 요청하는 페이지입니다.
  • 결제요청 후 리턴되는 $oResData값으로 결제요청성공 또는 결제요청실패를 확인하셔야 합니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.
  • http://고객사 도메인/payapp_lib.php
  • 결제요청시 사용되는 라이브러리 파일입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

실행순서 참고

payapp_popup.php -> payapp_request.php ( payapp_lib.php ) -> payapp_feedbackurl.php
결제통보(feedbackurl)

Feedbackurl 전달

  • 결제요청 API의 feedbackurl 파라메터에 해당하는 웹노티 페이지입니다.
  • “공통 통보 URL” (판매자 관리 사이트의 “설정” > “연동정보”)에서도 동일한 웹노티 데이터를 전달합니다.
    결제요청 API의 feedbackurl을 사용하실 때에는 공통통보URL을 설정하지 않아도 이용이 가능합니다.
  • 판매자 관리 사이트의 메뉴 “설정” 탭의 “연동 VALUE” 값과 feedbackurl로 전달되는 linkval 값이 같은 경우에만 정상 호출입니다.
  • 유효성 검증을 위해 결제 요청 금액을 확인 하시기 바랍니다.
  • feedbackurl, 공통 통보 URL은 여러 번 호출 될 수 있습니다. 중복처리 되지 않도록 mul_no, var1, var2를 이용해 중복방지 하셔야 합니다
  • feedbackurl에 해당되는 페이지의 HTTP Code '200'이고 응답(response)으로 'SUCCESS'인 경우 성공, 아닌경우 응답 실패로 확인합니다.
  • 결제요청 상태(pay_state)의 1:요청 상태는 JS API 연동을 하신 경우에만 NOTI됩니다.
  • 통보받은 데이터는 반드시 Server-Side에서 처리 하고, 민감 정보가 외부에 노출되지 않도록 주의하셔야 합니다.
  • 기능 추가 및 결제수단 추가에 따라 통보되는 데이터의 필드가 추가될 수 있습니다. 가맹점에서는 통보 데이터에 필드가 추가될 수 있음을 고려해서 연동해야 합니다.
파라메터 Type Description
userid String 판매자 회원 아이디
linkkey String 연동 KEY
linkval String 연동 VALUE
goodname String 상품명
price int 결제요청 금액
recvphone String 수신 휴대폰번호
memo String 메모
reqaddr int 주소요청 (1:요청, 0:요청안함)
reqdate String 결제요청 일시
pay_memo String 결제시 입력한 메모
pay_addr String 결제시 입력한 주소
pay_date String 결제승인 일시
pay_type int 결제수단
1 신용카드 2 휴대전화 3 해외결제 4 대면결제
6 계좌이체 7 가상계좌 15 카카오페이 16 네이버페이
17 등록결제 21 스마일페이 23 애플페이
payco (페이코) 결제는 "신용카드"(1) 으로 응답됩니다. (페이코는 paymethod_group=35)
pay_state int 결제요청 상태
1 요청 4 결제완료 8, 32 요청취소
9, 64 승인취소 10 결제대기 70, 71 부분취소
가상계좌 결제의 경우 "10:결제대기"(입금전), "4:결제완료"(입금완료) 상태로 진행됩니다.
"1:요청" 상태는 연동방식에 따라 NOTI되지 않을 수 있습니다.
var1 String 임의 사용 변수 1
var2 String 임의 사용 변수 2
mul_no int 결제요청번호(결제취소시 사용함)
payurl String 결제페이지 주소
csturl String 신용카드 결제시 매출전표 URL
currency String 통화 (krw:원화,usd:달러)
vccode String 국제전화 국가번호
feedbacktype int 0 : 결제요청 연동, 1 : 공통 통보 URL
orig_mul_no int 원거래 결제요청번호 (부분취소일 경우 값이 있음)
orig_price int 원거래 결제요청금액 (부분취소일 경우 값이 있음)
amount_taxable int 과세 공급가액
amount_taxfree int 면세 공급가액
amount_vat int 부가세
buyerid string 구매자 아이디
canceldate string 취소일시
cancelmemo string 취소메모
rebill_no string 정기결제 등록번호 (정기결제일 경우)
card_name String 신용카드명 (신용카드 결제일 경우)
payauthcode String 승인번호 (신용카드 결제일 경우)
card_quota String 할부개월 (신용카드 결제일 경우)
card_num String 카드번호 (신용카드 결제일 경우)
vbank String 은행명 (가상계좌 결제일 경우)
vbankno String 입금계좌번호 (가상계좌 결제일 경우)
naverpoint int 네이버 포인트 결제시 금액 (네이버페이 결제시만 제공)
naverpay string 네이버결제 구분 방법 (네이버페이 결제시만 제공)
(카드일 경우 :'card', 계좌결제일경우 :'bank')
smilepay_smilecash int 스마일캐시 이용금액 (스마일페이 결제시만 제공)
smilepay_discountamt int 스마일페이 프로모션 이용금액 (스마일페이 결제시만 제공)
  • http://고객사 도메인/payapp_feedbackurl.php
  • 결제완료시 페이앱서버에서 고객사 서버로 결과값을 리턴하는 페이지입니다.
  • 결제성공 또는 결제취소시 페이앱서버에서 결과값을 POST로 전송하오니 확인 후 처리하시면 되겠습니다.
  • 결과 파라메터는 결제통보 (feedbackurl)을 참고하시기 바랍니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

등록결제 등록(BILL)

등록결제(BILL) 등록– REST 방식

  • REST 방식은 모바일 기기, 브라우저 등 다양한 단말기와 프로그램을 지원하는 API입니다.
  • 호출 파라메터 중 cmd,userid,linkkey,cardNo,expMonth,expYear,cardpw,buyerAuthNo,buyerPhone,buyerName 값은 필수 입니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html
REST API 연동

호출 파라메터 목록

파라메터 필수 Type Description
cmd 필수 String 등록결제 등록 billRegist
userid 필수 String 판매자 회원 아이디
cardNo 필수 String 카드번호
expMonth 필수 String 카드 유효기간(월)
expYear 필수 String 카드 유효기간(년)
buyerAuthNo 필수 String 구매자확인 개인:생년월일(YYMMDD) 6자리 , 사업자번호
cardPw 필수 String 카드 비밀번호 앞 두자리
buyerPhone 필수 String 구매자 전화번호
buyerName 필수 String 구매자 성함
buyerId String 구매자 아이디
호출 예제)
curl -d "cmd=billRegist" \
-d "userid=[고객사 아이디]" \
-d "cardNo=[구매자 카드번호]" \
-d "expMonth=[구매자 카드유효기간(월)]" \
-d "expYear=[구매자 카드유효기간(년)]" \
-d "buyerAuthNo=[구매자 본인확인 생년월일(YYMMDD)]" \
-d "cardPw=[구매자 카드 비밀번호 앞 두자리]" \
-d "buyerPhone=[구매자 휴대전화 번호]" \
-d "buyerName=[구매자 성함]" \
-d "buyerId=[구매자 아이디]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage "" String 실패시 오류 문자열
encBill "" String 등록결제 연동키
billAuthNo "" String 등록결제 키
cardno "" String 카드번호
cardname "" String 카드사명
응답 예제)
state=1&errorMessage=&errno=00000&encBill=song_2322132222&cardno=4518%2A%2A%2A%2%2A%2A%2A%2A1111&cardname=%5B%EC%8B%A0%ED%95%9C%5D
등록결제 등록 예제

등록결제 등록 연동 예제

  • https://고객사 도메인/payapp_billregist.php
  • 등록결제 등록시 사용되는 페이지입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

등록결제(BILL) 삭제 API

등록결제(BILL) 삭제– REST 방식

  • REST 방식은 모바일 기기, 브라우저 등 다양한 단말기와 프로그램을 지원하는 API입니다.
  • 호출 파라메터 중 cmd,userid,encBill 값은 필수 입니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html
REST API 연동

호출 파라메터 목록

파라메터 필수 Type Description
cmd 필수 String 등록결제 삭제 billDelete
userid 필수 String 판매자 회원 아이디
encBill 필수 String 등록결제 연동키
호출 예제)
curl -d "cmd=billDelete" \
-d "userid=[고객사 아이디]" \
-d "encBill=[등록결제 연동키]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage "" String 실패시 오류 문자열
응답 예제)
 state=1&errorMessage=&errno=00000
등록결제 삭제 예제

등록결제 삭제 연동 예제

  • https://고객사 도메인/payapp_billdelete.php
  • 등록결제 삭제시 사용되는 페이지입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

등록결제(BILL) 결제 API

등록결제(BILL) 결제– REST 방식

  • REST 방식은 모바일 기기, 브라우저 등 다양한 단말기와 프로그램을 지원하는 API입니다.
  • 호출 파라메터 중 cmd,userid,encBill,goodname,price,recvphone,amount_taxable,amount_taxfree,amount_vat 값은 필수 입니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html
REST API 연동

호출 파라메터 목록

파라메터 필수 Type Description
cmd 필수 String 등록결제 결제 billPay
userid 필수 String 판매자 회원 아이디
encBill 필수 String 등록결제 연동키
goodname 필수 String 상품명
price 필수 int 상품가격
recvphone 필수 String 구매자 전화번호
amount_taxable int 공급가액
amount_taxfree int 면세금액
amount_vat int 부가세
feedbackurl String 결제완료 후 결과값을 리턴받을 고객사 URL
응답내용은 결제요청 FeedbackURL 참조
var1 String 사용자 임의 변수 1
var2 String 사용자 임의 변수 2
checkretry String feedbackurl 재시도 (y:재시도,n:재시도 안함)
feedbackurl의 응답이 성공이 아니면 feedbackurl 호출을 재시도 합니다. (총 10회 재시도)
cardinst String 카드할부 개월 수 ('00','01','02'....)
50,000원 이상부터 할부 가능
호출 예제)
curl -d "cmd=billRegist" \
-d "userid=[고객사 아이디]" \
-d "encBill=[등록결제 연동키]" \
-d "goodname=[상품명]" \
-d "price=[상품가격]" \
-d "recvphone=[구매자 전화번호]" \
-d "amount_taxable=[공급가액]" \
-d "amount_taxfree=[면세금액]" \
-d "amount_vat=[부가세]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage "" String 실패시 오류 문자열
CSTURL "" String 영수증 url
price "" String 결제금액
mul_no "" int 결제요청번호
응답 예제)
 state=1&errorMessage=&errno=00000&CSTURL=https%3A%2F%2Fwww.payapp.kr%2FCST%2Fzcv7&price=1000&mul_no=12234567
등록결제 결제 연동

등록결제 결제 연동 예제

  • https://고객사 도메인/payapp_billpay.php
  • 페이앱 대리점, 리셀러가 리셀러 또는 판매자를 가입하는 연동입니다.
  • 예제파일 및 데이터는 고객사의 개발환경에 맞추시기 바랍니다.

정기결제 요청 연동 구성

연동 방식

  • 결제 요청 연동은 "JS API", "REST API" 방식 두가지가 있습니다.
  • 2개의 연동 방식 중 고객사의 연동 상황에 맞게 이용하시면 됩니다.

정기 결제 요청 – JS 방식

  • JS 방식은 자바스크립트를 이용해 고객사 웹페이지에 쉽게 연동을 진행하는 API입니다.
  • "JS API" 는 PAYAPP REST API 를 HTML 및 자바스크립트를 이용해 연동할 수 있도록 제작된 WRAPPER API 입니다.
  • 매뉴얼의 JS(https://lite.payapp.kr/public/api/v2/payapp-lite.js)를 임의로 변경하실 경우, 연동이 원활하게 이뤄지지 않을 수 있으며, 최신 업데이트가 적용되지 않기 때문에 동작을 보장할 수 없습니다.

스크립트 주소

연동을 원하는 페이지 내에 스크립트를 삽입합니다.
<script src="https://lite.payapp.kr/public/api/v2/payapp-lite.js"></script>

파라메터 설정

결제 파라메터는 두 가지 방식으로 설정이 가능합니다.
자바스크립트는 반드시 <script></script> 태그 내에 작성되어야 합니다.

1. HTML 폼 사용

HTML 로 폼을 작성한 후 자바스크립트로 해당 폼을 등록할 수 있습니다.

HTML

<form name="{폼이름}">
    <input type="hidden" name="{파라메터1}" value="{설정값1}">
    <input type="hidden" name="{파라메터2}" value="{설정값2}">
</form>

자바스크립트

PayApp.setForm('{폼이름}');

2. 자바스크립트 사용

제공되는 자바스크립트 메써드를 통해 파라메터를 설정할 수 있습니다.
PayApp.setParam('{파라메터1}','{설정값1}');
PayApp.setParam('{파라메터2}','{설정값2}');

결제창 호출

설정된 파라메터를 사용하여 결제창을 호출합니다.
PayApp.rebill();

파라메터 목록

기본 정보

파라메터 필수 Type Description
userid 필수 string 판매자 회원 아이디

페이앱 아이디 userid 필수

페이앱에 로그인하는 판매자 아이디를 입력합니다.

결제 정보

파라메터 필수 Type Description
goodname 필수 string 상품명
goodprice 필수 int 정기결제 요청 금액
recvemail string 수신 이메일
recvphone string 수신 휴대폰번호
memo string 정기결제 요청 메모
rebillCycleType 필수 int 정기결제 주기 구분 (Month, Week, Day)
rebillCycleMonth string 월 정기결제 결제일 (1~31, 90:말일)
rebillCycleWeek string 주 정기결제 결제요일 (1~7, 1:월요일~7:일요일)
rebillExpire 필수 string 정기결제 만료일(yyyy-mm-dd)
feedbackurl string 결제완료 피드백 URL
var1 string 임의 사용 변수 1
var2 string 임의 사용 변수 2
smsuse string 결제요청 SMS 발송여부
returnurl string 결제완료 이동 URL
openpaytype string 결제수단 선택 (card:신용카드, phone:휴대전화)
failurl string 결제실패 Noti URL (1회차 승인 실패는 Noti되지 않습니다)

상품명 goodname 필수

결제창에 표시할 상품명을 입력합니다.

정기결제 요청 금액 goodprice 필수

결제창에 표시할 결제금액을 입력합니다.
정기결제 주기에 결제될 금액입니다.

수신 이메일 recvemail

정기결제 요청 수신 이메일 입니다.

수신 휴대폰번호 recvphone 필수

결제창에 표시할 휴대폰번호를 입력합니다.

정기결제 요청 메모 memo

결제페이지에 입력된 메모가 표시됩니다.

정기결제 주기 구분 rebillCycleType 필수

Month 월 정기결제 Week 주 정기결제 Day 일 정기결제

월 정기결제 결제일 rebillCycleMonth

1~31 일자 90 말일
월 정기결제의 결제일 입니다.

주 정기결제 결제요일 rebillCycleWeek

1 월요일 ~ 7 일요일
주 정기결제의 결제요일 입니다.

정기결제 만료일 rebillExpire

yyyy-mm-dd
정기결제의 만료일 입니다.

정기결제 피드백 URL feedbackurl

결제 데이터가 생성되거나 상태가 변경될 경우 해당 URL 로 결과값을 전송합니다.
전송시점: 최초 결제요청, 사용자가 결제를 완료했을 경우, 요청취소 또는 승인취소
JS API에서 feedbackurl에 값이 있는 경우 요청상태(pay_state=1)으로 최초 노티되며 응답으로 'SUCCESS'가 있어야 결제진행이 가능합니다.
결과값에 대한 자세한 내용은 PAYAPP REST API 매뉴얼 '결제통보'를 참고하시길 바랍니다.

결제완료 이동 URL returnurl

사용자의 결제페이지에서 사용자가 결제를 완료할 경우
특정 URL 로 페이지가 이동하도록 설정할 수 있습니다.
해당 API를 통해 호출된 현재 결제창에는 영향을 주지 않습니다.

임의 사용 변수 var1 var2

필요한 임의의 값을 입력하여 사용할 수 있습니다.

결제수단 선택 openpaytype

결제수단 선택 (휴대전화:phone, 신용카드:card)
콤마(,) 구분으로 결제수단 선택이 가능합니다.
값이 없는 경우 이용 가능한 결제수단이 모두 선택됩니다.

정기결제 요청 SMS 발송여부 smsuse

y [기본값] 발송함 n 발송안함
정기결제 요청 SMS 발송이 필요없는 경우 'n'으로 설정 하시기 바랍니다.

정기결제 실패 URL failurl

정기결제 실패될 경우 해당 URL 로 결과값을 전송합니다.
전송시점: 2회차 이후 정기결제 주기에 승인 실패시
실패(pay_state=99)으로 노티되며 응답(Http Code=200 Response=SUCCESS) 가 아닌 경우 재통보 됩니다.
실패 내용 (ResultMsg)을 참고 하시기 바랍니다.

파라메터 처리

입력받은 파라메터 값은 모두 자동으로 TRIM(앞뒤 공백 제거) 처리됩니다.
결제금액이나 휴대폰 등의 숫자 파라메터의 경우 숫자 외의 문자는 제거됩니다.

자바스크립트 메써드

.setForm()

HTML 로 폼을 작성한 후 등록합니다.
등록된 폼을 이용해 결제창에 파라메터를 전달하게 됩니다.
.setParam() 등을 통한 별도의 파라메터 설정은 적용되지 않습니다.

.setForm(string)

폼의 이름이나 아이디를 입력하여 폼을 등록합니다.
PayApp.setForm('{폼이름}');

.setForm(object HTMLFormElement)

폼의 객체를 직접 넘겨 폼을 등록합니다.
var form;
form = document.forms['{폼이름}'];
form = document.getElementById('{폼아이디}');
PayApp.setForm(form);

.setDefault()

파라메터 기본값을 설정합니다.
변경되지 않는 고정값 설정시 사용하시면 됩니다.
폼을 등록하는 경우 동작하지 않습니다.

.setDefault(string, string)

파라메터 기본값을 개별적으로 설정합니다.
PayApp.setDefault('{파라메터1}', '{설정값1}');
PayApp.setDefault('{파라메터2}', '{설정값2}');

.setDefault(object Object)

파라메터 기본값을 오브젝트로 일괄 설정합니다.
PayApp.setDefault({
    '{파라메터1}': '{설정값1}',
    '{파라메터2}': '{설정값2}'
});

.setParam()

파라메터 값을 설정합니다.
.rebill() 호출 후 설정된 값은 초기화됩니다.
폼을 등록하는 경우 동작하지 않습니다.

.setParam(string, string)

파라메터 값을 개별적으로 설정합니다.
PayApp.setParam('{파라메터1}', '{설정값1}');
PayApp.setParam('{파라메터2}', '{설정값2}');

.setParam(object Object)

파라메터 값을 오브젝트로 일괄 설정합니다.
PayApp.setParam({
    '{파라메터1}': '{설정값1}',
    '{파라메터2}': '{설정값2}'
});

.setTarget()

결제창을 띄울 타겟을 설정합니다.
타겟이 지정되지 않은 경우 PayAppWindow 이름의 새창을 띄워 결제창이 호출됩니다.
작성된 폼을 등록하는 경우에도 해당 메써드를 통해서만 타겟 설정이 가능합니다.
타겟을 설정하는 경우 추가적으로 redirect 파라메터 설정이 필요할 수 있습니다.

.setTarget(string)

별도의 타겟 이름을 사용하거나 HTML 스펙으로 지정된 _ 키워드를 사용할 수 있습니다.
예를 들어 결제창을 현재창에서 페이지 전환하려는 경우 _self로 설정합니다.
PayApp.setTarget('{타겟}');

.rebill()

정기결제 창을 호출합니다.

.rebill()

설정된 파라메터를 사용하여 결제창을 호출합니다.
PayApp.rebill();

.rebill(object Object)

파라메터 설정과 동시에 결제창을 호출할 수 있습니다.
폼을 등록하는 경우 설정값은 무시됩니다.
PayApp.rebill({
    '{파라메터1}': '{설정값1}',
    '{파라메터2}': '{설정값2}'
});

Method Chaining

메써드들은 체인으로 연결 가능합니다.
.rebill() 메써드가 호출되면 체인은 종료됩니다.
// 폼 등록. 결제창 호출
PayApp.setForm('MyForm').rebill();

// 상품명 설정. 가격 설정. 결제창 호출.
PayApp.setParam('goodname', '좋은상품').setParam('goodprice', '2000').rebill();

jQuery

결제 연동시 jQuery 가 필요한 경우 PayApp.$ 또는 PayApp.jQuery를 통해 내부에 포함된 jQuery 를 사용할 수 있습니다.
// jQuery 버전 확인
alert(PayApp.$().jquery);

// 1. 결제버튼 비활성화
PayApp.$('#pay-button').attr('disabled', 'disabled');
// 2. 정기결제 창 호출
PayApp.rebill();
// 3. 결제버튼 활성화
PayApp.$('#pay-button').removeAttr('disabled');

연동 예제

HTML 폼 사용

<script src="https://lite.payapp.kr/public/api/v2/payapp-lite.js"></script>
<script>
function myPay() {
    PayApp.setForm('MyForm');
    PayApp.rebill();
}
</script>

<form name="MyForm">
    <input type="hidden" name="userid"    value="payapptest">
    <input type="hidden" name="goodname"  value="착한상품">
    <input type="hidden" name="goodprice" value="1000">
    <input type="hidden" name="recvphone" value="01000000000">
    <input type="hidden" name="smsuse" value="n">
    <input type="hidden" name="rebillCycleType"  value="Month">
    <input type="hidden" name="rebillCycleMonth" value="10">
    <input type="hidden" name="rebillExpire"     value="2025-10-20">
</form>

<a href="#" onclick="myPay();">결제하기</a>

자바스크립트 사용

<script src="https://lite.payapp.kr/public/api/v2/payapp-lite.js"></script>
<script>
PayApp.setDefault('userid',     'payapptest');

function myPay() {
    PayApp.setParam('goodname',  '착한상품');
    PayApp.setParam('goodprice', '1000');
    PayApp.setParam('recvphone', '01000000000');
    PayApp.setParam('smsuse', 'n');
    PayApp.setParam('rebillCycleType',  'Month');
    PayApp.setParam('rebillCycleMonth', '10');
    PayApp.setParam('rebillExpire',     '2025-10-20');
    PayApp.rebill();
}
</script>

<a href="#" onclick="myPay();">결제하기</a>

자바스크립트 사용 #2

<script src="https://lite.payapp.kr/public/api/v2/payapp-lite.js"></script>
<script>
PayApp.setDefault('userid',     'payapptest');
PayApp.setDefault('recvphone', '01000000000');
PayApp.setDefault('smsuse', 'n');
PayApp.setDefault('rebillCycleType',  'Month');
PayApp.setDefault('rebillCycleMonth', '10');
PayApp.setDefault('rebillExpire',     '2025-10-20');
</script>

<a href="#" onclick="PayApp.setParam('goodname', '좋은상품').setParam('goodprice', '1000').rebill();">상품1 결제하기</a>
<a href="#" onclick="PayApp.rebill({'goodname': '보통상품', 'goodprice': '2000'});">상품2 결제하기</a>
<a href="#" onclick="PayApp.rebill({'goodname': '나쁜상품', 'goodprice': '3000'});">상품3 결제하기</a>

정기결제

정기 결제 요청 – REST 방식

  • 정기 결제를 위한 정기 결제 요청을 등록하는 API입니다.
  • 정기 결제 요청 등록 후 payurl로 구매자가 최초 1회 결제 승인이 성공하면 다음 결제 주기에 정기 결제가 발생됩니다.
  • 결제 승인이 발생되면 feedbackurl로 NOTI가 발생됩니다.("Feedbackurl 전달" 참고)
  • 휴대전화 정기 결제는 월 정기 결제만 이용이 가능합니다.
  • 호출 파라메터 중 cmd, userid, goodname, goodprice, recvphone, rebillCycletype, rebillExpire 값은 필수 입니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html
REST API 연동

호출 파라메터 목록

파라메터 필수 Type Description
cmd 필수 String 정기결제요청 : rebillRegist
userid 필수 String 판매자 회원 아이디
goodname 필수 String 상품명
goodprice 필수 int 정기 결제 요청 금액
recvemail String 수신 이메일
recvphone 필수 String 수신 휴대전화 번호
memo String 정기 결제 요청 메모
rebillCycleType 필수 String 정기결제 주기 구분 (Month,Week,Day)
rebillCycleMonth String 월 정기결제 결제일(1~31,90:말일)
rebillCycleWeek String 주 정기결제 결제요일 (1~7, 1:월요일 ~ 7:일요일)
rebillExpire 필수 String 정기결제 만료일 (yyyy-mm-dd)
feedbackurl String 결제완료 피드백 URL
var1 String 임의변수 1
var2 String 임의변수 2
smsuse String 정기결제요청 SMS 발송여부 (n:발송안함)
returnurl String 결제완료 후 이동할 링크 URL (결제완료 페이지에서 "확인"버튼 클릭시 이동)
openpaytype String 결제 가능 수단 (신용카드:card, 휴대전화:phone)
failurl string 결제실패 Noti URL (1회차 승인 실패는 Noti되지 않습니다)
호출 예제)
curl -d "cmd=rebillRegist" \
-d "userid=[고객사 아이디]" \
-d "goodname=[상품명]" \
-d "goodprice=[정기 결제 요청 금액]" \
-d "recvphone=[수신 휴대전화 번호]" \
-d "rebillCycleType=[정기결제 주기 구분 (Month,Week,Day)]" \
-d "rebillCycleMonth=[월 정기결제 결제일]" \
-d "rebillExpire=[정기결제 만료일]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage "" String 실패시 오류 문자열
rebill_no "" int 정기결제 등록번호
payurl "" String 정기결제 URL
응답 예제)
state=1&errorMessage=&errno=00000&rebill_no=1&payurl=http%3A%2F%2Fpayapp.kr%2F000000000000
정기결제 요청 예제

정기결제 요청 예제

  • https://고객사 도메인/payapp_rebillrequest.php
  • 정기결제 요청시 사용되는 페이지입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

정기 결제 해지 API

정기 결제 해지 API

  • 정기 결제 해지가 되면 다음 정기 결제 주기에 정기 결제가 발생되지 않습니다.
  • 해지된 정기결제는 “승인”으로 변경되지 않습니다.
  • 호출 파라메터 중 cmd,userid,rebill_no,linkkey 값은 필수 입니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html
REST API 연동

호출 파라메터 목록

파라메터 필수 Type Description
cmd 필수 String 정기결제 해지 : rebillCancel
userid 필수 String 판매자 회원 아이디
rebill_no 필수 String 정기결제요청 등록번호
linkkey 필수 String 연동 KEY
호출 예제)
curl -d "cmd=rebillCancel" \
-d "userid=[고객사 아이디]" \
-d "rebill_no=[정기결제요청 등록번호]" \
-d "linkkey=[연동 KEY]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage "" String 실패시 오류 문자열
응답 예제)
 state=1&errorMessage=&errno=00000
정기결제 해지 예제

정기결제 해지 예제

  • https://고객사 도메인/payapp_rebillcancel.php
  • 정기결제 해지시 사용되는 페이지입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

정기결제 일시정지 API

정기결제 일시정지 API

  • 정기 결제 요청 건의 상태가 “승인”인 경우 일시정지가 가능합니다.
  • 일시정지된 정기 결제 건은 다음 결제 주기에 정기 결제가 발생되지 않습니다.
  • 일시정지된 정기 결제 건은 “승인” 상태로 변경이 가능합니다.
  • 호출 파라메터 중 cmd,userid,rebill_no,linkkey 값은 필수 입니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html
REST API 연동

호출 파라메터 목록

파라메터 필수 Type Description
cmd 필수 String 정기결제 일시정지 : rebillStop
userid 필수 String 판매자 회원 아이디
rebill_no 필수 String 정기결제요청 등록번호
linkkey 필수 String 연동 KEY
호출 예제)
curl -d "cmd=rebillStop" \
-d "userid=[고객사 아이디]" \
-d "rebill_no=[정기결제요청 등록번호]" \
-d "linkkey=[연동 KEY]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage "" String 실패시 오류 문자열
응답 예제)
 state=1&errorMessage=
정기결제 일시정지 예제

정기결제 일시정지 예제

  • https://고객사 도메인/payapp_rebillstop.php
  • 정기결제 일시정지시 사용되는 페이지입니다.
  • 예제파일 및 데이터는 고객사의 개발환경에 맞추시기 바랍니다.

정기결제 승인 API

정기결제 승인 API

  • 정기 결제 요청 건의 상태가 “일시정지”인 경우 승인 상태로 변경이 가능합니다.
  • 승인 상태인 정기 결제 건은 다음 결제 주기에 정기 결제가 발생합니다.
  • 호출 파라메터 중 cmd,userid,rebill_no,linkkey 값은 필수 입니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html
REST API 연동

호출 파라메터 목록

파라메터 필수 Type Description
cmd 필수 String 정기결제 승인 : rebillStart
userid 필수 String 판매자 회원 아이디
rebill_no 필수 String 정기결제요청 등록번호
linkkey 필수 String 연동 KEY
호출 예제)
curl -d "cmd=rebillStart" \
-d "userid=[고객사 아이디]" \
-d "rebill_no=[정기결제요청 등록번호]" \
-d "linkkey=[연동 KEY]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage "" String 실패시 오류 문자열
응답 예제)
 state=1&errorMessage=
정기결제 승인 예제

정기결제 승인 예제

  • https://고객사 도메인/payapp_rebillstart.php
  • 정기결제 승인변경시 사용되는 페이지입니다.
  • 예제파일 및 데이터는 고객사의 개발환경에 맞추시기 바랍니다.

결제 (요청,승인) 취소

  • 호출 파라메터 중 userid, linkkey, mul_no 값은 필수 입니다.
  • “결제 요청” 연동 에서 feedbackurl을 입력된 결제요청 건 경우에는 결제 요청 취소 성공시“Feedbackurl 전달” 으로 자료가 전송됩니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html

호출

파라메터 필수 Type Description
cmd 필수 String 결제(요청,승인)취소 :paycancel
userid 필수 String 판매자 회원 아이디
linkkey 필수 String 연동 KEY
mul_no 필수 int 결제요청번호
cancelmemo 필수 String 결제요청취소 메모
cancelmode String 결제요청취소 모드
(값이 ready 인 경우 결제요청 상태만 취소 가능)
partcancel int 결제요청취소 구분
(0:전취소, 1:부분취소)
cancelprice int 결제요청취소 금액
(부분취소인 경우 필수)
cancel_taxable int 결제요청취소 과세 공급가액
cancel_taxfree int 결제요청취소 면세 공급가액
cancel_vat int 결제요청취소 부가세
호출 예제)
curl -d "cmd=paycancel" \
-d "userid=[고객사 아이디]" \
-d "linkkey=[연동 KEY]" \
-d "mul_no=[결제요청번호]" \
-d "cancelmemo=[결제요청취소 메모]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage "" String 실패시 오류 문자열
응답 예제)
state=1&errorMessage=
결제 (요청,승인) 취소

결제 취소 연동 예제

  • http://고객사 도메인/payapp_paycancel.php
  • 결제(요청,승인) 취소시 사용되는 페이지입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

결제 취소 요청

  • 구매자가 결제승인 후 D+5일이 경과 되었거나, 판매자 정산이 완료된 경우 “2.3. 결제(요청,승인) 취소” 연동으로 취소 되지 않습니다. 이 경우 결제 취소 요청 연동 후 정산금액을 반환하셔야(판매자 정산이 완료된 경우) 취소가 가능합니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html

호출

파라메터 필수 Type Description
cmd 필수 String 결제요청취소 :paycancelreq
userid 필수 String 판매자 회원 아이디
linkkey 필수 String 연동 KEY
mul_no 필수 int 결제요청번호
cancelmemo 필수 String 결제요청취소 메모
dpname String 입금자명
partcancel int 결제취소요청 구분
(0:전취소, 1:부분취소)
cancelprice int 결제취소요청 금액
(부분취소인 경우 필수)
cancel_taxable int 결제취소요청 과세 공급가액
cancel_taxfree int 결제취소요청 면세 공급가액
cancel_vat int 결제취소요청 부가세
호출 예제)
curl -d "cmd=paycancelreq" \
-d "userid=[고객사 아이디]" \
-d "linkkey=[연동 KEY]" \
-d "mul_no=[결제요청번호]" \
-d "cancelmemo=[결제요청취소 메모]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage String 실패시 오류 문자열
cr_dpname String 입금자명 (호출 파라메터)
partcancel String 결제취소 요청 구분 (호출 파라메터)
paybackprice int 취소 반환금
partprice int 결제취소요청 금액
cancel_taxable int 결제취소요청 과세 공급가액
cancel_vat int 결제취소요청 부가세
cancel_taxfree int 결제취소요청 면세 공급가액
paybackbank string 취소 반환금 입금계좌
응답 예제)
state=1&errorMessage=
결제 취소 요청

결제 취소 요청 연동 예제

  • http://고객사 도메인/payapp_paycancel.php
  • 결제 취소 요청시 사용되는 페이지입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

판매자 회원 가입

  • 대리점이 리셀러를, 리셀러가 판매자를 가입하는 연동입니다.
  • resellerid는 대리점 또는 리셀러 아이디를 입력하셔야 합니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html

호출

파라메터 필수 Type Description
cmd 필수 String 판매자 회원 가입 : sellerRegist
userid 필수 String 판매자 회원 아이디
userpwd 필수 String 판매자 회원 비밀번호 (영문,숫자 8자리)
sellername 필수 String 판매자명
phone 필수 String 판매자 휴대전화번호
compregno String (사업자 필수) 사업자등록번호
compname String (사업자 필수) 상호명(법인명)
biztype1 String (사업자 필수) 업태
biztype2 String (사업자 필수) 업종
email 필수 String 이메일
zipcode String 주소-우편번호
addr1 String 주소1
addr2 String 주소2
homepage String 홈페이지
compbank String 정산은행
compbanknum String 정산은행 계좌번호
compbankname String 정산은행 예금주
bizkind 필수 String 서비스 구분
username String (개인 필수) 이름
usertype 필수 int 판매자 구분 (개인:1, 사업자:2)
resellerid 필수 String 대리점 또는 리셀러 아이디
join_type 필수 int 가입형태 (유료:0, 할인:4), 리셀러 회원가입은 유료형
ceo_nm String (사업자 필수) 대표자 성함
seller_type 필수 String 가입구분 (seller,reseller)
common_feedbackurl String 공통 통보 URL
  • seller_type의 값이“seller”인 경우 resellerid는 리셀러 아이디, seller_type의 값이“reseller”인 경우 resellerid는 대리점 아이디 입니다.
  • bizkind : Blog사업자,쇼핑몰사업자,방문판매,음식점(배달),A/S긴급출동,운수업,컨텐츠,도소매,유통,서비스,숙박업,임대업,농수산업,기타
  • common_feedbackurl : 결제요청연동시 입력하는 feedbackurl과 별도로 결제상태 피드백을 받으실 수 있습니다.
  • common_feedbackurl은 결제요청 없이 결제완료로 통보 될 수 있으며, 결제요청연동으로 연동되지 않는 결제건도 피드백이 됩니다. (모든 결제건에 대해 피드백이 이루어 집니다.)
  • common_feedbackurl의 피드백은 하나의 결제요청건에 대해 여러 번 피드백 될 수 있으니, 결제상태/결제요청번호에 따라 적절한 연동을 하셔야 합니다.
호출 예제)
curl -d "cmd=sellerRegist" \
-d "userid=[고객사 아이디]" \
-d "userpwd=[비밀번호]" \
-d "sellername=[판매자명]" \
-d "phone=[판매자휴대전화번호]" \
-d "email=[이메일]" \
-d "bizkind=[서비스 구분]" \
-d "usertype=[판매자 구분]" \
-d "resellerid=[대리점,리셀러 아이디]" \
-d "join_type=[가입형태]" \
-d "seller_type=[가입구분]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage String 실패시 오류 문자열
userid String 가입 성공시 판매자 아이디
linkkey String 가입 성공시 연동KEY
linkval String 가입 성공시 연동VALUE

판매자 회원 아이디 중복 체크

  • 대리점이 리셀러를, 리셀러가 판매자를 가입하기 위해 아이디 중복체크 하는 연동입니다.
  • resellerid는 대리점 또는 리셀러 아이디를 입력하셔야 합니다.
  • REST URL :
    https://api.payapp.kr/oapi/apiLoad.html

호출

파라메터 필수 Type Description
cmd 필수 String 판매자 회원 아이디 중복체크 : useridCheck
userid 필수 String 판매자 회원 아이디
resellerid 필수 String 대리점 또는 리셀러 아이디
호출 예제)
curl -d "cmd=useridCheck" \
-d "userid=[고객사 아이디]" \
-d "resellerid=[대리점(리셀러)아이디]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 중복안됨
0 int 실패, 또는 아이디 중복
errorMessage String 실패시 오류 문자열
회원 연동

판매자 회원가입 연동 예제

  • http://고객사 도메인/payapp_sellerRegist.php
  • 페이앱 대리점, 리셀러가 리셀러 또는 판매자를 가입하는 연동입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

판매자 회원아이디 중복체크 연동 예제

  • http://고객사 도메인/payapp_useridCheck.php
  • 페이앱 대리점, 리셀러가 리셀러 또는 판매자를 가입시키고자 할때 아이디 중복체크 하는 연동입니다.

부계정 등록

  • 직원별로 카드 결제 및 매출 현황관리를 가능하도록 부계정을 등록하는 연동입니다.

호출

파라메터 필수 Type Description
cmd 필수 String 부계정 등록 : subidregist
userid 필수 String 판매자 회원 아이디
subuserid 필수 String 부계정 아이디
subpwd 필수 String 부계정 비밀번호
subname 필수 String 부계정명
subetc1 String 대분류
subetc2 String 중분류
subetc3 String 소분류
subjtype String 직급
state int 권한(0:권한없음, 1:부계정사용, 2:메인관리자, 4:결제취소)

조직분류 관리 subetc1

조직별 매출관리를 위해 대분류를 등록합니다.

조직분류 관리 subetc2

조직별 매출관리를 위해 중분류를 등록합니다.

조직분류 관리 subetc3

조직별 매출관리를 위해 소분류를 등록합니다.

권한설정 state

권한없음=0, 부계정사용=1, 메인관리자=2, 결제취소=4
부계정사용+메인관리자=3, 부계정사용+결제취소=5, 메인관리자+결제취소=6, 부계정사용+메인관리자+결제취소=7
호출 예제)
curl -d "cmd=subidregist" \
-d "userid=[고객사 아이디]" \
-d "subuserid=[부계정 아이디]" \
-d "subpwd=[부계정 비밀번호]" \
-d "subname=[부계정명]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage String 실패시 오류 문자열
부계정 등록

부계정등록 연동 예제

  • http://고객사 도메인/payapp_subidRegist.php
  • 직급별로 부계정을 등록하는 연동입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

현금영수증 발행

  • 현금영수증 발행은 거래일로 부터 6일이내 발행이 가능합니다
  • 발행한 날짜의 3일 후 '현금영수증.kr'에서 확인이 가능합니다.
  • 현금영수증 발행 시 거래금액의 합계금액은 "공급가액+봉사료+부가가치세"입니다.
  • 자진발급 : 발급대상 전 거래에 대하여 현금영수증이 발급이 가능합니다.(고객 미신청의 경우 id_info = '0100001234')

호출

파라메터 필수 Type Description
cmd 필수 String 현금영수증 발행 : cashStRegist
userid 필수 String 판매자 회원 아이디
linkkey 필수 String 연동 KEY
good_name 필수 String 상품명
buyr_name 필수 String 구매자명
buyr_tel1 int 구매자 휴대폰
buyr_mail String 구매자 이메일
id_info 필수 int 휴대폰번호(사업자번호)
trad_time 필수 int 원거래시각(예:20151231183120, 년월일시분초, 거래일로 부터 6일이내 발행가능)
tr_code 필수 int 발행용도(0:소득공제용, 1:지출증빙용)
amt_tot 필수 int 거래금액
amt_sup 필수 int 공급가액
amt_svc 필수 int 봉사료
amt_tax 필수 int 부가가치세
corp_tax_type 필수 String TG01:과세, TG02:면세
mul_no String 결제요청번호
호출 예제)
curl -d "cmd=cashStRegist" \
-d "userid=[고객사 아이디]" \
-d "good_name=[상품명]" \
-d "buyr_name=[구매자명]" \
-d "id_info=[휴대폰(사업자)번호]" \
-d "trad_time=[원거래시각]" \
-d "tr_code=[발행용도]" \
-d "amt_tot=[거래금액]" \
-d "amt_sup=[공급가액]" \
-d "amt_svc=[봉사료]" \
-d "amt_tax=[부가가치세]" \
-d "corp_tax_type=[과세(면세)]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 type Description
state 1 int 성공
0 int 실패
errorMessage String 실패시 오류 문자열
cashstno int 발행번호
receipt_no String 현금영수증 승인번호
cashsturl String 발행url

현금영수증 취소

  • 현금영수증 취소 연동입니다.

호출

파라메터 필수 Type Description
cmd 필수 String 현금영수증 취소 : cashStCancel
userid 필수 String 판매자 회원 아이디
linkkey 필수 String 연동 KEY
cashstno 필수 int 발행번호
  • cashstno : 발행시 저장했던 발행번호

응답

파라메터 Type Description
state 1 int 성공
0 int 실패
errorMessage String 실패시 오류 문자열
현금영수증 연동

현금영수증 발행 연동 예제

  • http://고객사 도메인/payapp_cashst.php
  • 현금영수증을 발행하는 연동입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

현금영수증 취소 연동 예제

  • http://고객사 도메인/payapp_cashstcn.php
  • 현금영수증을 취소하는 연동입니다.
  • 예제파일의 위치는 고객사의 개발환경에 맞추시기 바랍니다.

네이버페이 현금영수증 발행대상 금액조회

  • 네이버페이 현금영수증 발행대상 금액조회 연동입니다.
  • 네이버페이로 결제된 주문건만 조회 가능합니다.

호출

파라메터 필수 Type Description
cmd 필수 String 네이버페이 현금영수증 발행대상 조회 : checkNpayCashReceiptReq
userid 필수 String 판매자 회원 아이디
mul_no 필수 String 결제요청번호
호출 예제)
curl -d "cmd=checkNpayCashReceiptReq" \
-d "userid=[고객사 아이디]" \
-d "mul_no=[결제요청번호]" \
https://api.payapp.kr/oapi/apiLoad.html

응답

파라메터 type Description
state 1 int 성공
0 int 실패
errorMessage String 실패시 오류 문자열
totalCashAmount int 현금영수증 발행 대상 총금액
supplyCashAmount int 현금성 총 공급가
vatCashAmount int 현금성 총 부가세
(현금성 총 공급가가 있고 현금성 총 부가세가 0일경우 면세)

PayApp APP 연동 구성

  • 페이앱 APP은 판매자용입니다. 따라서 고객사 판매자용으로 이용이 가능합니다.
  • 페이앱 판매자의 대면결제, 결제요청하는 용도로 이용이 가능합니다.
  • 쇼핑몰과 같은 서비스에는 "결제요청" 연동을 이용하시기 바랍니다.
  • 페이앱 APP에 로그인되어 있는 상태에서 페이앱 APP을 호출하는 연동입니다.

원격 결제

  • (고객사 APP > 페이앱 APP > 결제요청 연동) 으로 연동되는 방식입니다.
  • 결제하시는 분에게 결제요청 SMS을 발송하여 결제를 받을때 사용합니다.
  • 호출 URI :
    https://payapp.kr/sdk-app
파라메터 필수 Description
reqType 필수 원격결제 : REMOTE
returnUri 필수 리턴 받을 고객사 APP URI
phoneNumber 필수 수신 전화번호
goodPrice 필수 결제요청 금액
goodName 필수 상품명
hasTax 과세/면세 (과세:1, 면세:0)
feedbackurl 결제완료 후 결과값을 리턴받을 고객사 URL ("결제통보" 참고)
checkretry feedbackurl 재시도 (y:재시도,n:재시도 안함)
feedbackurl의 응답이 성공이 아니면 feedbackurl 호출을 재시도 합니다. (총 10회 재시도)
var1 임의 사용 변수 1
var2 임의 사용 변수 2

응답

파라메터 Description
state 1 성공
0 실패
errorMessage 실패시 오류 문자열
mul_no 성공시 결제요청 번호
payurl 결제창URL
errorCode
9000로그인 오류9010필수 파라메터 누락
9020결제타입 오류9040시간초과
9050원격결제 오류
var1 임의 사용변수 1
var2 임의 사용변수 2

대면 결제

  • 카메라(OCR) : 휴대전화 카메라로 신용카드 결제를 합니다.
  • 수기 결제 : 카드번호, 유효기간, 비밀번호, 본인확인(생년월일)을 입력하여 신용카드 결제를 합니다.
  • 네이버페이,카카오페이,스마일페이,애플페이,페이코,위챗페이 : PayApp APP에서 QR을 생성해서 결제하시는 분의 휴대전화에서 결제를 합니다.
  • NFC, 삼성페이 : 안드로이드 휴대전화에서만 지원가능하며, 휴대전화의 NFC모드 "기본모드"로 설정, 카드종류에 따라 지원이 안될 수 있습니다.
  • 호출 URI :
    https://payapp.kr/sdk-app
파라메터 필수 Description
reqType 필수
OCR카메라 결제APPLE_PAY애플페이
NAVER_PAY네이버페이KAKAO_PAY카카오페이
SMILE_PAY스마일페이WECHAT_PAY위챗페이
PAYCO페이코QRQR 결제
MANUAL수기 결제NFCNFC 결제
SAMSUNG삼성페이
returnUri 필수 리턴 받을 고객사 APP URI
phoneNumber 수신 전화번호 (10만원 이상 결제시 필수)
goodPrice 필수 결제요청 금액
goodName 필수 상품명
cardinst 할부개월
5만원 이상 이용가능
카메라 결제, 수기결제, NFC결제, 삼성페이에서 이용가능
hasTax 과세/면세 (과세:1, 면세:0)
isAllPayReqType 모든 대면결제 사용 (사용:1, 미사용:0)
feedbackurl 결제완료 후 결과값을 리턴받을 고객사 URL ("결제통보" 참고)
checkretry feedbackurl 재시도 (y:재시도,n:재시도 안함)
feedbackurl의 응답이 성공이 아니면 feedbackurl 호출을 재시도 합니다. (총 10회 재시도)
var1 임의 사용 변수 1
var2 임의 사용 변수 2

응답

파라메터 Description
state 1 성공
0 실패
errorMessage 실패시 오류 문자열
mul_no 성공시 결제요청 번호
csturl 영수증 URL
errorCode
9000로그인 오류9010필수 파라메터 누락
9020결제타입 오류9040시간초과
cardName 카드사명
cardNum 카드번호
date 결제일
installment 할부개월
goodName 상품명
var1 임의 사용변수 1
var2 임의 사용변수 2
COPYRIGHT © 2012 UDID CORP. All rights reserved.