V1구버전 개발자센터
V2신버전 개발자센터

업데이트 노트

문서와 연동 스펙의 변경 이력입니다.

2026

  1. 11월

    해외 카드 > 간편페이(Alipay+) 결제가 추가되고, 해외 카드 결제창 스크립트가 업데이트되었습니다.

    • 연동 준비 해외 간편결제 페이지에서 Alipay+ 연동 준비사항과 웹훅 예시를 확인할 수 있습니다.
    • 간편페이 결제 연동 페이지에서 Alipay+ 결제창 연동 방법을 확인할 수 있습니다.
    • 간편페이 결제 파라미터 페이지에서 결제창 호출 및 결과 수신 파라미터를 확인할 수 있습니다.
    • 해외 카드 결제창 스크립트가 gpay-2.0.0으로 변경되었습니다. 결제창 요청 파라미터는 camelCase(serviceId, serviceOid 등)를 사용합니다. (키인 / 정기(빌링) / 간편페이)
    • 키인, 간편페이 결제창 요청에 상품 정보 orders와 테마 색상(backgroundColor, foregroundColor, accentColor) 파라미터가 추가되었습니다. (키인 / 간편페이)
    • 자주 묻는 질문에 해외 카드 결제창 지원 언어(중국어)와 최소 결제금액(1 CNY)이 반영되었습니다.
  2. 국내 카드 매출 전표가 페이플 전표 화면으로 바뀌었고, 웹훅에 종류 구분값이 추가되었습니다.

    • 국내 카드 결제, 취소 응답과 웹훅, 구매자 메일의 PCD_PAY_CARDRECEIPT 가 원천사 전표 대신 페이플 전표 화면 주소(https://cpay.payple.kr/receipt/card.php?token=...)로 전달됩니다.
    • 국내 카드/계좌결제 웹훅 바디 맨 앞에 웹훅 종류를 구분하는 PCD_WEBHOOK_TYPE 이 추가되었습니다. (결제 완료 PAYMENT, 취소 완료 REFUND, 결제수단 등록 REGISTER, 결제수단 해지 TERMINATE)
  3. 링크결제 생성 시 구매자 정보 선택 입력 항목을 지정할 수 있습니다.

    • 링크 생성 요청에 PCD_LINK_PAYER_OPTIONAL 파라미터가 추가되었습니다. 구매자 이름(name), 휴대폰번호(hp), 이메일(email) 중 지정한 항목만 선택 입력으로 바뀌며, 미지정 시 기존과 같이 모두 필수 입력입니다.
  4. 정산지급대행 이체 실행 요청이 접수 응답으로 통일되고, 이체 결과 확인 안내가 추가되었습니다.

    • 이체 실행 요청 응답은 ALL 실행과 특정 빌링키(단건) 실행 모두 접수 결과를 반환합니다. 응답의 A0000 은 이체 완료를 의미하지 않습니다.
    • 실제 이체 결과(성공/실패)는 웹훅 또는 실행결과 조회 API(건별, 일별, 그룹별)로 확인해야 합니다. 이체 실행 요청 직후에는 처리 전이라 조회되지 않을 수 있습니다.
    • 그룹키(group_key) 발급 규칙과 권장 사용 방법(대기 건을 모두 등록한 뒤 ALL 로 한 번에 실행)이 추가되었습니다.
  5. 10월

    개발자센터가 새롭게 리뉴얼되었습니다.

    • 결제 수단을 고르면 연동 준비부터 결제, 운영까지 한 화면에서 단계별로 확인할 수 있습니다.
    • 데모 콘솔, 응답 코드 바로보기 등 연동을 돕는 기능이 추가되었습니다.
  6. 해외 카드 파라미터 최대 글자수가 변경되었습니다.

  7. 9월

    결제 연동을 돕는 AI 어시스턴트 [지니봇]이 추가되었습니다.

    • 개발자센터 어느 페이지에서든 우측 하단 지니봇 버튼으로 질문할 수 있습니다.
  8. 8월

    국내 카드 간편페이 정기(빌링) 결제 페이지가 추가되었습니다.

  9. 6월

    거래 이력 기반 대사를 위한 [국내 거래] 페이지가 추가되었습니다.

  10. 5월

    정산 대사를 위한 [국내 정산] 페이지가 추가되었습니다.

    • 국내 정산 페이지에서 정산 대상 거래 내역을 조회해 매출 데이터와 대조할 수 있습니다.
    • 응답코드에 [PSTL] 국내 정산내역 조회 응답 목록이 추가되었습니다.
  11. 3월

    대량 거래내역 확인 시 활용할 수 있는 다건 결제내역 조회 기능이 추가되었습니다.

2025

  1. 10월

    금융기관코드가 최신화되었습니다.

    • 금융기관코드 목록이 업데이트되었습니다.
      • 은행: 031 코드 기관명 변경 및 이전 명칭 표기 추가(대구은행 → 아이엠뱅크 (구 대구은행))
      • 상호금융기관: 030 수산업협동조합중앙회 추가
      • 금융투자회사: 209 유안타증권, 227 다올투자증권, 270 하나증권 추가, 기관명 변경 및 이전 명칭 표기 추가
        • 238: 미래에셋대우 → 미래에셋증권(구 미래에셋대우)
        • 262: 하이투자증권 → 아이엠증권(구 하이투자증권)
        • 265: 이베스트투자증권 → LS증권 (구 이베스트투자증권)
        • 279: DB금융투자 → DB증권 (구 DB금융투자)
      • 신규 섹션 추가: 보험사(교보생명 436, DB손해보험 443), 캐피탈사(현대캐피탈 304)
  2. 6월

    해외 카드 결제 시 Decision Manager 점수 기능이 추가되었습니다.

    • 해외 카드 결제 응답에 score_result 파라미터가 추가되었습니다.
      • 빌링 결제: score_result 파라미터 추가
      • 키인 결제: score_result 파라미터 추가
      • 이상거래탐지시스템(Decision Manager)에서 측정한 위험 점수 제공 (0-100점, 높을수록 위험)
  3. 5월

    국내 앱카드 결제에 간편페이(네이버페이,카카오페이) 관련 파라미터가 추가되었습니다.

    • 요청: PCD_PAY_METHOD - 특정 앱카드 또는 간편페이(네이버페이, 카카오페이) 수단만을 결제창에 단독으로 노출 (appCard, naverPay, kakaoPay)
    • 응답: PCD_PAY_METHOD - 구매자가 선택한 결제수단 구분 (앱카드, 네이버페이, 카카오페이)
    • 응답: PCD_EASY_PAY_METHOD - 결제수단의 상세 유형 구분 (card: 카드, point: 머니/포인트)
  4. 4월

    해외 카드 API 파라미터가 개선되었습니다.

    • 취소 응답 신규 파라미터 3개 추가: org_pay_id (원거래 결제 ID), orgTotalAmount (원거래 결제금액), remainAmount (잔여금액)
    • 결과조회 응답 파라미터 totalAmount 설명 개선: 결제/취소에 따른 구분 안내 추가 (type이 PAYMENT/CANCEL에 따라 의미 구분)
  5. 3월

    국내 카드 결제 연동 시 주의사항이 강화되었습니다.

  6. 2월

    개발자센터 메뉴 구조 및 링크결제 가이드가 개선되었습니다.

  7. 1월

    보안 요구사항이 강화되었습니다.

2024

  1. 10월

    디스콰이엇 위클리 프로덕트에 선정되었습니다.

    • 디스콰이엇에서 매주 가장 많은 표를 받은 상위 3위 선정
  2. 7월

    페이플 허브 서비스명이 변경되었습니다.

    • 기존 : 페이플 허브(플랫폼 정산 자동화)
    • 변경 : 정산지급대행
  3. 6월

    웹뷰 연동 시 삼성카드 신규 앱스킴 & 패키지가 추가되었습니다.

    • iOS 앱스킴 : monimopay, monimopayauth
    • AOS 패키지 : <package android:name="net.ib.android.smcard"/>
  4. 5월

    기관 코드 조회 기능이 추가되었습니다.

    • 국내 카드사 리스트 조회 기능
    • 금융 기관 코드 조회 기능
    • 해외 카드 국가 코드 조회 기능
    • 해외 미국(US), 캐나다(CA) 행정구역 코드 조회 기능
  5. 3월

    페이플 개발자센터가 리뉴얼 오픈되었습니다.

    • 통합된 개발자 가이드 및 API 문서 제공
결제 연동과 관련된 무엇이든 물어보세요