게이트웨이 키를 PayCore에 저장하지 않음
가맹점 시스템이 특정 게이트웨이와 메서드를 호출한 뒤 주문 요청과 함께 게이트웨이 자격 증명을 전송합니다.
- 엔드포인트: POST /api/paycore/pay/{gateway}/{method}
- 자격 증명 필드: gateway_credentials
- 단일 게이트웨이 또는 엔지니어 주도 연동에 적합
두 가지 연동 방식
게이트웨이 직접 제어 또는 PayCore 호스팅 All-in-One 체크아웃을 선택하세요.
Direct Gateway API는 요청마다 게이트웨이 자격 증명을 보내는 팀용입니다. Project Checkout API는 결제 자격 증명을 PayCore에 저장하고 프로젝트 API 키만으로 주문을 생성하는 가맹점용입니다.
직접 연동과 All-in-One 비교
두 방식은 함께 사용할 수 있습니다. Direct Gateway API는 가맹점 시스템에 최대 제어권을 유지하고 All-in-One 체크아웃은 PayCore를 호스팅 결제 수단 선택기로 사용합니다.
게이트웨이 키를 저장하고 PayCore 프로젝트 키 사용
가맹점은 PayCore 결제 프로젝트를 만들고 그 아래 여러 게이트웨이 자격 증명을 저장합니다. 가맹점 시스템은 주문 생성 시 PayCore 프로젝트 API 키만 전송합니다.
- 엔드포인트 초안: POST /api/paycore/checkout
- 자격 증명 필드: project_api_key
- 호스팅 All-in-One 결제 페이지에 적합
All-in-One 체크아웃 흐름
가맹점이 PayCore 가맹점 센터에서 결제 프로젝트 생성
가맹점이 SmilePay, ECPay, PLUS, Stripe 등 게이트웨이 자격 증명 연결
가맹점 시스템이 project_api_key로 주문 생성
PayCore가 checkout_url 반환
결제자가 PayCore 체크아웃에서 결제 수단 선택
PayCore가 연결된 게이트웨이 자격 증명으로 실제 게이트웨이 결제 생성
게이트웨이가 PayCore Webhook 호출
PayCore가 결제 상태를 업데이트하고 가맹점 notify_url에 알림
PayCore 개발자 센터는 공개 상태입니다. Direct Gateway API, All-in-One 결제 프로젝트, Webhook, 오류 코드 예시를 계속 보강합니다.