PAYCO Developer

※ 오류 메시지( 크롬/ 콘솔확인 )

Uncaught SecurityError: Blocked a frame with origin "https://www.payco.com"
from accessing a frame with origin "https://payco.com".
Protocols, domains, and ports must match.

No 'Access-Control-Allow-Origin' header is present on the requested resource.
Origin 'http://payco.com' is therefore not allowed access

간편결제 또는 바로구매 버튼이 가이드와 동일하게 잘 보여야 합니다.

  OR    

가맹점 내부 정책으로 붉은색이 아닐 수도 있으나, PAYCO 영문자로 확인 되도록 부탁 드립니다.
별도 PAYCO 디자인 제공 요청시에, 별도 버튼 이미지 파일 및 포토샵 원본파일 제공 해 드리고 있습니다.

“PAYCO 간편결제” 클릭시 가이드 메시지가 잘 보여야 하고, 바로구매 형식에서는 안내하지 않습니다.

PAYCO 간편결제 안내

PAYCO는 온/오프라인 쇼핑은 물론 송금, 멤버십 적립까지 가능한 통합 서비스입니다.
- 지원카드: 모든 국내 신용/체크카드

결제하기 또는 구매하기 버튼 클릭시 PAYCO결제창(popup)이 보여야 합니다.

팝업 차단이 내부정책으로 해제가 어려우시면,
팝업차단 허용을 요청하시는 내용을, 알림창(Alert) 으로 안내 부탁 드립니다.

1. 결제금액을 확인하여, 조건이 맞지않으면 알림창으로 안내 하여 결제진행 안됨 등
2. 모바일 IOS 의 단말기를 구분하여, iPad 에서 PAYCO 결제창이 뜨지 않음. 또는 PAYCO 브릿지페이지가 닫힘.

- PAY2 : 사용자가 취소하였다는 알림창 확인 후에
            PAYCO 결제창이 닫히고, 주문화면으로 이동 되어야 함.

- PAY1 : 알림 팝업창은 없이
            PAYCO 결제창이 닫히고, 주문화면으로 이동 되어야 함.

- PAY2 : 사용자가 취소하였다는 알림창 확인 후에
            특정 페이지( 주문화면, 메인화면 ) 로 이동되어야 합니다.

            ( IOS : 취소버튼 선택후에, 수동으로 Safari 로 돌아가면
                     PAYCO 브릿지 페이지 확인하고,
                     사용자가 취소하였다는 알림 팝업창 확인 후에
                     특정 페이지( 주문화면, 메인화면 ) 로 이동되어야 합니다. )

- PAY1 : 알림 팝업창은 없이
            PAYCO 결제창이 닫히고, 주문화면으로 이동 되어야 함.

            ( IOS : 취소버튼 선택후에, 수동으로 Safari 로 돌아가면
                     PAYCO 브릿지 페이지 확인하고,
                     알림 팝업창 없이
                     특정 페이지( 주문화면, 메인화면 ) 로 이동되어야 합니다. )

- PAY2 : 사용자가 취소하였다는 알림창 확인 후에
            특정 페이지( 주문화면, 메인화면 ) 로 이동되어야 합니다.

            ( IOS : 취소버튼 선택후에, 자동으로 가맹점 앱으로 돌아가면
                     PAYCO 브릿지 페이지 확인하고,
                     사용자가 취소하였다는 알림 팝업창 확인 후에
                     특정 페이지( 주문화면, 메인화면 ) 로 이동되어야 합니다. )

- PAY1 : 알림 팝업창은 없이
            PAYCO 결제창이 닫히고, 주문화면으로 이동 되어야 함.

            ( IOS : 취소버튼 선택후에, 자동으로 가맹점 앱으로 돌아가면
                     PAYCO 브릿지 페이지 확인하고,
                     알림 팝업창 없이
                     특정 페이지( 주문화면, 메인화면 ) 로 이동되어야 합니다. )

- PAY2 : 잔고부족 등의 오류가 발생시에, 알림창으로 오류 내용을 안내하고
            PAYCO 결제창이 닫히거나 다른 결제수단을 선택할 수 있어야 합니다.

            ( 모바일웹/앱 은, 알림창 안내 후에 특정 페이지( 주문화면, 메인화면 ) 로
              이동되어야 합니다. 리턴 페이지에서 빈화면으로 멈추어져 있으면 안됩니다. )

- PAY1 : 잔고부족 등의 오류가 발생시에, 알림창으로 오류 내용을 안내하고
            PAYCO 결제창은 닫히지 않고, 다른 결제수단을 선택 가능합니다.

            ( PC웹, 모바일웹/앱 동일 )

- 모바일 웹 / 앱(AOS) : PAYCO 브릿지 페이지에서 [결제하기] 버튼 선택하고
            PAYCO 앱 에 연동되어 결제되고, PAYCO 결제완료 확인버튼을 선택 후 에
            PAYCO 브릿지 페이지 보여지고 나서,
            자동으로 가맹점의 주문완료 페이지로 이동 확인.

- 모바일 웹 (IOS) : PAYCO 브릿지 페이지에서 [결제하기] 버튼 선택하고
            PAYCO 앱에 연동되어 결제되고, PAYCO 결제완료 화면에서
            IOS 스마트단말기 하단 홈버튼 을 누르고, 바탕화면에서 Safari 브라우저를 선택
            또는 상단왼쪽 [ Safari 돌아가기] 를 선택하면
            Safari 브라우저에서, PAYCO 브릿지 페이지 보여지고 나서,
            자동으로 가맹점의 주문완료 페이지로 이동 확인.

- 앱 (IOS) : PAYCO 브릿지 페이지에서 [결제하기] 버튼 선택하고
            PAYCO 앱 에 연동되어 결제되고, PAYCO 결제완료 확인버튼을 선택 후 에
            가맹점 앱이 호출되어, 가맹점 앱에서 PAYCO 브릿지 페이지 보여지고 나서,
            자동으로 가맹점의 주문완료 페이지로 이동 확인.

         ※ appUrl 파라미터 및 값이 미추가되어 있으면,
            PAYCO 앱의 결제완료 안내 페이지 에서 멈추어져 있고
            수동으로 IOS 스마트단말기 하단 홈버튼 을 누르고, 바탕화면에서 가맹점 앱 선택
            또는 상단왼쪽 [ 앱 돌아가기] 를 선택하면,
            가맹점 앱 에서 PAYCO 브릿지 페이지 보여지고 나서,
            자동으로 가맹점의 주문완료 페이지로 이동 확인.

하단 [확인] 버튼이 아닌
상단우측 X 로 나갔을때, 가맹점 홈페이지 주문상세 페이지에서 결제 성공 여부 확인 합니다.

- 웹 브라우저 히스토리(방문기록) 페이지에서 리턴 페이지 URL 클릭(선택) 하여 확인 합니다.

[결제하기] 버튼 선택 하여, 재 결제시도 시에 오류 메시지 안내 후
특정 페이지로 이동여부 확인.

( 가맹점 리턴페이지에서 처리되고, PAYCO에서 메시지 및 에러코드 전달 함. )

주문내역에서 상이한 내용 확인.
( 결제취소 는 PAYCO 파트너센터에서도 가능합니다. https://partner.payco.com )

※ 가맹점 내부정책에 따라서,
            1) 주문취소 가능하고, 즉시 PAYCO 결제취소 확인
            2) 주문취소는 받으나, 담당자가 확인 후 일괄취소처리 되어 즉시 확인 안됨.
                - 별도로, 검수 결과 안내시에 PAYCO 결제취소 테스트 요청 해야함.
            3) 1:1 문의로 주문취소 요청 가능

- 여행사, 교육(온라인), 도서 업종에서는 비과세로 PAYCO영수증을 발행 하고 있습니다.

고객이 주문한 상품명으로 요청되어 영수증에 반영 되는지 확인 합니다.

( 상품이 2개 이상 시에는 ' 외 1 건' 형식으로 확인이 되어야 하고,
  내부 정책으로 수정이 불가하시면, 가맹점 정책에 따라서 수정 부탁 드립니다. )

- 공백 또는 null 값이면, 해당 파라미터(key:value)는 삭제 부탁 드립니다.

- 주문예약시에 파라미터 값이 인코딩 되어진 채로 넘어오지 않아야 합니다.
           예) " 14K%20DSETINY%uBAA9%uAC78%uC774%20 " ( 잘못 사용 )
                ==> " 14K DSETINY목걸이"     ( 올바른 사용)

- JSON형식의 문자열
           예) "returnUrlParam": "android"     ( 잘못 사용 )
                ==> "returnUrlParam": "{\"key\":\"value\"}" ( 올바른 사용)

- 가상계좌 만료일시       = virtualAccountExpiryYmd
- 무통장입금완료통보 URL = nonBankbookDepositInformUrl

- 주문예약시 부득이하게 일괄적으로 설정 하신것이 아니라면,
  주문예약시 payExpiryYmdt 파라미터( key : value )를 추가하지 마시고 삭제하여 주시기 바랍니다.

- 해당 파라미터 : serviceUrlParam 또는 returnUrlParam
  주문예약 요청시에, 개인정보를 추가하여 PAYCO로 전달하시면 안되고 DB 처리로 부탁 드립니다.

- 해당 파라미터 : orderTitle
  고객님이 주문하신 상품명으로 확인 되도록 해 주시고, 상품 2개 이상 구매 시에는 ' 외 1건' 으로 확인 되도록 부탁 드립니다.

- 모바일 웹 ( 안드로이드 ) :
   inAppYn = N / orderChannel = MOBILE / appUrl = 해당 파리미터미추가 확인

- 모바일 웹 ( IOS ) :
   inAppYn = N / orderChannel = MOBILE / appUrl = 해당 파리미터 미추가 확인

※ appUrl 파라미터 및 값이 추가되어 있으면 아래와 같은 오류내용을 확인 하실수도 있습니다.

             PAYCO 브리짓페이지가 가맹점 앱을 호출하고,

             1) 호출시에 가맹점 앱이 미설치 상태이면,
                PAYCO 앱에서 알수 없는 오류가 발생 되었다고 안내 합니다.

             2) 주문예약시 설정하는 appUrl (앱에서 결제를 처리한 뒤 복귀할 앱 url scheme)의 설정이
                잘못 되어 있으면, 아래와 같은 메시지를 확인 합니다.

                " 예상하지 못한 오류가 발생 했습니다.
                 일시적인 현상이거나 네트워크 문제 일 수 있으니,
                 잠시후 문제가 지속되는 경우, 고객센터를 통해 문의 주세요. "

- 앱 ( 안드로이드 ) :
   inAppYn = Y / orderChannel = MOBILE / appUrl = 해당 파리미터 미추가 확인

- 앱 ( IOS ) :
   inAppYn = Y / orderChannel = MOBILE / appUrl = 해당 파리미터 추가 확인

           ※ appUrl = 앱을 호출하는 url ,
              Safari 웹브라우저 주소입력창에서 호출 테스트  예) payco://

           ※ appUrl 입력시 변수이름("appUrl") 의 대소문자 구분 확인 ( 가이드기준 )

           ※ appUrl 파라미터 및 값이 미추가되어 있으면,

              PAYCO 앱에서, 결제완료 안내 페이지 에서 멈추어져 있어서
              수동으로 하단 홈버튼 을 누르고, 바탕화면에서 가맹점 앱 을 선택
              또는 상단왼쪽 [ 앱 돌아가기] 를 선택하면,
              가맹점 앱 에서 PAYCO 브릿지 페이지 보여지고 나서
              자동으로 가맹점의 주문완료 페이지로 이동 확인.

           ※ appUrl 파라미터 및 값이 추가되어 있으면, PAYCO 브리짓페이지가 가맹점 앱을 호출하고

              1) 호출시에 가맹점 앱이 미설치 상태이면
                  PAYCO 앱에서 알수 없는 오류가 발생 되었다고 안내 합니다.

              2) 주문예약시 설정하는 appUrl (앱에서 결제를 처리한 뒤 복귀할 앱 url scheme)
                  값이 상이하면 아래와 같은 메시지를 확인 합니다.

                " 예상하지 못한 오류가 발생 했습니다.
                  일시적인 현상이거나 네트워크 문제 일 수 있으니, 잠시후
                  문제가 지속되는 경우, 고객센터를 통해 문의 주세요. "

- cancelMobileUrl 파라미터 : PAYCO앱 결제창의 [취소] 버튼 선택 시에, 이동해야 하는 페이지 URL
              " javascript:history.back() " 형식이 아닌, 전체 URL 주소 이어야 합니다.

가맹점 홈페이지 관리자 메뉴의 PAYCO 결제취소 API 연동으로 결제취소
또는 PAYCO 파트너센터에서 결제취소 진행 합니다.

가맹점의 주문취소 페이지에서 전체 주문취소가 가능해야 합니다.

가맹점의 주문취소 페이지에서 부분취소가 가능해야 합니다.

복합결제건의 PAYCO쿠폰, PAYCO포인트도 결제취소가 잘 되었는지 확인 합니다.

1) 비과세 일 경우, 비과세로 결제취소 요청 파라미터( totalCancelTaxfreeAmt ) 및 금액 확인
2) 총 취소 금액 확인

- 취소할 상품 List 파라미터( orderProducts ) : 부분취소인 경우 사용하고, 추가 요청하지 않는 경우에는 전체취소 됩니다.

- PAY2 : Return 페이지에서 결제승인 요청 전에,
            주문예약시에 DB에 저장된 주문총금액과 PAYCO에서 인증 받은 금액 비교확인 해야 합니다.

- PAY1 : 결제승인 후에 CallBack 페이지에서,
            주문예약시에 DB에 저장된 주문총금액과 PAYCO에서 결제승인 받은 금액을
            비교 확인하여, 금액이 다를 경우에 결제취소 처리해야 합니다.

PAYCO 결제건의 주문상세보기 페이지내 [결제취소] 메뉴에서 부분취소가 가능해야 합니다.

복합결제건의 PAYCO쿠폰, PAYCO포인트도 결제취소가 잘 되었는지 확인 합니다.

약정비율의 포인트가 가맹점에 정상적으로 적립되어야 합니다.