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

이 문서는 2026년 10월 2일부터 업데이트되지 않습니다. 최신 문서 보기

기타

업데이트 노트


페이플 API의 개선 사항을 포함한 최신 업데이트 내용을 확인하실 수 있습니다.

2026. 11

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

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

국내 카드 매출 전표가 페이플 전표 화면으로 바뀌었고, 웹훅에 종류 구분값이 추가되었습니다.

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

링크결제 생성 시 구매자 정보 선택 입력 항목을 지정할 수 있습니다.

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

정산지급대행 이체 실행 요청이 접수 응답으로 통일되고, 이체 결과 확인 안내가 추가되었습니다.

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

2026. 10

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

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

해외 카드 파라미터 최대 글자수가 변경되었습니다.

2026. 09

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

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

2026. 08

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

2026. 06

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

  • 국내 거래 페이지에서 조회 기간 내에 발생한 승인·취소 거래 이력을 확인할 수 있습니다.
  • 다건 결과조회에 PCD_DATE_TYPE (PAY_DATE / EVENT_DATE) 파라미터가 추가되었습니다 (국내 카드 / 국내 계좌)

2026. 05

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

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

2026. 03

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

2025. 10

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

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

2025. 06

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

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

2025. 05

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

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

2025. 04

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

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

2025. 03

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

  • 앱카드 결제 연동에서 승인 요청 시 주의사항 2가지 추가: Referer 필드 도메인 확인 (`AUTH0004` 오류 방지), 인증 후 10분 내 승인 요청 필수 (`PCCFD001` 오류 방지)
  • 국내 카드 응답 코드에 `PCCFD001` 오류 코드 추가: 거래 세션 만료 시 발생하는 오류 및 해결 방법 안내

2025. 02

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

2025. 01

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

결제 연동과 관련된 무엇이든 물어보세요