환경 설정 | Bootpay 결제 매뉴얼

이 문서는 Bootpay 결제 연동을 시작하기 위한 기본 환경을 준비하는 방법을 설명해요. 아래 순서대로 진행하면 회원가입, 프로젝트 생성, PG 설정까지 끝낼 수 있어요. SDK 설치와 결제 호출은 PG 결제창 연동에서 이어서 다뤄요.

회원 가입

Bootpay 관리자에서 회원가입 후 사업자 정보를 등록해요.

프로젝트 생성

관리자 대시보드에서 프로젝트를 생성해요. 프로젝트를 생성하면 연동키가 발급돼요.

연동키 생성

개발자 설정 메뉴에서 연동키를 생성해요. 연동키는 프로젝트별로 생성할 수 있으며, 권한이나 만료기간을 설정할 수 있어요.

연동키 생성

PG사 설정

관리자 → 결제 설정에서 사용할 PG사를 활성화해요. 아직 PG사와 계약 전이라면 마음에 드는 PG사 한 곳을 골라 활성화하고, 샌드박스 모드도 함께 켜요. 실제 결제 없이 테스트 카드로 연동 흐름을 먼저 검증할 수 있어요. PG 선택 기준과 가맹 절차는 PG 가맹 계약 가이드에서 봐요.

PG 활성화

개발 단계에서는 Sandbox 모드를 사용해요. 실제 결제 없이 테스트 카드로 흐름을 검증할 수 있어요.

연동 확인

SDK 설치는 PG 결제창 연동 → 1. SDK 설치에서 플랫폼별로 안내해요. 서버 SDK 설치를 마쳤다면, 아래 결제 조회 API로 키와 인증 설정이 제대로 들어갔는지 한 번 확인할 수 있어요. 실제 운영에서는 결제 완료 후 전달받은 receipt_id를 넣어 검증에 사용해요.

import { Bootpay } from '@bootpay/backend-js'

Bootpay.setConfiguration({
    client_key: '[ Client Key ]',
    secret_key: '[ Secret Key ]'
})

const receipt = await Bootpay.receiptPayment('[ receipt_id ]')
console.log(receipt)javascript

from bootpay_backend import BootpayBackend

bootpay = BootpayBackend(client_key='[ Client Key ]', secret_key='[ Secret Key ]')
receipt = bootpay.receipt_payment('[ receipt_id ]')
print(receipt)python

use Bootpay\ServerPhp\BootpayApi;

BootpayApi::setClientKeyConfiguration('[ Client Key ]', '[ Secret Key ]');
$receipt = BootpayApi::receiptPayment('[ receipt_id ]');
print_r($receipt);php

import kr.co.bootpay.pg.Bootpay;

Bootpay bootpay = Bootpay.withClientKey("[ Client Key ]", "[ Secret Key ]");
var receipt = bootpay.getReceipt("[ receipt_id ]");
System.out.println(receipt);java

bootpay = Bootpay::Api.new(client_key: '[ Client Key ]', secret_key: '[ Secret Key ]')
receipt = bootpay.verify('[ receipt_id ]').data
puts receiptruby

import "github.com/bootpay/backend-go/v2"

api := bootpay.NewAPIWithClientKey("[ Client Key ]", "[ Secret Key ]", nil, "")
receipt, err := api.GetReceipt("[ receipt_id ]")
if err != nil {
    panic(err)
}
fmt.Println(receipt)go

using Bootpay;

var bootpay = BootpayApi.WithClientKey("[ Client Key ]", "[ Secret Key ]");
var receipt = await bootpay.GetReceipt("[ receipt_id ]");
var content = await receipt.Content.ReadAsStringAsync();
Console.WriteLine(content);csharp

주문·상품·고객·구독·링크페이 같은 커머스 기능은 별도 SDK 로 분리되어 있어요. 설치·인증 절차는 환경 설정을 봐요.