KCP Payments Rails
Rails 7/8에서 KCP 표준결제 연동을 간편하게 도와주는 Rails Engine + Stimulus 래퍼 젬입니다.
설치
gem "kcppayments_rails", github: "luciuschoi/kcppayments_rails"bundle install
bin/rails g kcppayments_rails:install초기화 설정
config/initializers/kcppayments_rails.rb 파일을 열어 KCP 상점 정보를 설정하세요.
뷰 사용 예시 (ERB)
<%= kcp_script_tag %>
<%= form_with url: checkout_payments_path, method: :post, **kcp_form_attrs(
order_id: @order.number,
amount: @order.total_price,
buyer_name: current_user.name,
buyer_email: current_user.email,
product_name: @order.summary,
return_url: payment_complete_url
) do |f| %>
<button data-controller="kcp" data-action="click->kcp#requestPayment">결제하기</button>
<% end %>서버 처리
승인/취소 등의 서버-서버 통신은 KcppaymentsRails::Client를 사용하세요.
client = KcppaymentsRails::Client.new
result = client.approve({ # KCP 요구 파라미터 })주의사항
- KCP 표준결제는 레거시 스크립트를 로드합니다.
kcp_script_tag를<head>혹은<body>상단에서 불러오세요. - 상점코드(
site_cd)와 키(site_key)는 환경변수 또는 이니셜라이저에서 설정하세요.