생성한 앱에서 결제 받기

Piko로 만든 앱이 방문자에게 직접 결제를 받도록 할 수 있습니다. (Piko 구독 결제와는 별개입니다.)

지원하는 결제 수단

수단	설명
Toss Payments	토스페이먼츠 직접 연동. 기본 권장
PortOne	여러 PG를 묶는 게이트웨이

테스트용 mock 결제도 있어 붙이기 전에 흐름을 확인할 수 있습니다.

붙이는 방법

1. 프롬프트로 결제 화면을 요청합니다. (예: “상품 결제 페이지를 만들어줘”)
2. 사용할 결제 수단을 고르고, 필요한 키를 외부 연동으로 설정합니다. 공급자를 따로 지정하지 않으면 Toss Payments를 우선합니다.
3. 표준 결제 흐름(결제 설정 조회 → 결제 세션 생성 → 결제 확인)이 앱에 들어갑니다.

Toss Payments를 쓰는 경우

생성 앱에는 앱 소유자의 키를 넣습니다. Piko 플랫폼 결제 키를 재사용하지 않습니다.

키	어디에 쓰이나요
TOSS_CLIENT_KEY	브라우저에서 결제창을 열 때 사용
TOSS_SECRET_KEY	서버에서 결제 승인(confirm), 취소, 조회와 웹훅 재조회 검증에 사용

결제 금액은 브라우저가 보낸 값을 그대로 믿지 않습니다. 앱 서버가 주문 금액을 다시 계산하고, Toss 승인 금액과 맞는지 확인한 뒤 결제 완료로 바꿉니다.

PortOne을 쓰는 경우

PORTONE_STORE_ID, PORTONE_CHANNEL_KEY, PORTONE_API_SECRET이 필요합니다. PORTONE_WEBHOOK_SECRET은 권장값입니다. 이 값이 없으면 웹훅 서명 검증은 건너뛰지만, 앱 서버는 PortOne API로 결제를 재조회한 결과만 주문 상태에 반영합니다.

참고

Piko는 결제를 중개하거나 수수료를 떼지 않습니다. 정산은 사용자가 연결한 결제사와 직접 이뤄집니다.