PG별 결제수단과 기능입니다.
| 항목 | 토스페이먼츠 | 포트원 V2 | 카카오페이 | 네이버페이 |
|---|---|---|---|---|
| 신용·체크카드 | 지원 | 채널 설정 | 미지원 | 미지원 |
| 간편결제 | 네이버페이 · 카카오페이 · 토스페이 · 페이코 | 채널 설정 | 카카오페이 | 네이버페이 |
| 계좌이체 · 휴대폰 | 지원 | 채널 설정 | 미지원 | 미지원 |
| 부분 취소 | 지원 | 지원 | 지원 | 지원 |
| 현금영수증 | 지원 | 지원 | 미지원 | 미지원 |
| sayren 테스트 키 | 지원 | 지원 | 지원 | 지원 |
포트원은 채널에 연결한 PG가 받는 결제수단을 그대로 씁니다. 라이브 결제에서 가상계좌는 아직 지원하지 않습니다.
스토어프론트는 결제창만 엽니다.
결제창에서 결제를 마치면 sayren 서버가 승인합니다. 승인 키가 브라우저에 남지 않습니다.
- 01주문서 · 결제 옵션(PG · 결제수단 · 간편결제사) 목록을 받습니다.
- 02결제 시작 · SDK가 PG 결제창을 엽니다.
- 03승인 · PG가 sayren으로 돌아오고 서버가 금액을 대조한 뒤 승인합니다.
- 04복귀 · 스토어프론트 복귀 화면에서 결과를 읽습니다.
import { createPayments } from "@sayren/storefront-sdk/payments";
const payments = createPayments({ client: sdk, returnUrl });
// 주문서 — 결제 옵션 목록이 같이 온다
const checkout = await sdk.checkout.create({ cartItemIds });
// 결제 시작 — PG 결제창으로 이동
await payments.start(checkout.checkoutId, {
option: checkout.paymentOptions[0],
shippingAddress,
});
// 복귀 화면
const result = await payments.result();PG 계약 전에도 테스트 결제를 해 볼 수 있습니다.
테스트 모드 키를 켜면 sayren이 준비한 테스트 키로 결제창이 열립니다. 실결제는 PG 계약 뒤 라이브 키로 전환합니다.
테스트 모드 키 켜기
계약 없이 바로 테스트 결제
내 테스트 키 연결
PG에서 받은 테스트 키로 연결 테스트
테스트 결제 · 환불
결제 1건과 그 결제의 환불 1건
라이브 전환
라이브 키 연결 테스트 뒤 전환
결제 이후의 처리도 sayren이 합니다.
부분 환불 정산
쿠폰 안분과 반품 배송비를 주문 시점 기준으로 계산합니다.
중복 결제 취소
구매자가 결제를 두 번 하면 늦은 결제를 자동으로 취소합니다.
응답 없는 결제 확인
응답이 끊긴 결제는 PG에 다시 조회해 확정합니다.
현금영수증
계좌이체 결제에 발급하고, 환불하면 금액을 맞춥니다.
매출 리포트
PG · 결제수단별 결제, 환불, 순매출
결제 실패 알림
가맹점 설정 문제로 같은 실패가 반복되면 메일로 알립니다.
판매대금은 PG에서 셀러에게 바로 정산됩니다.
sayren은 판매대금을 거치지 않습니다. 결제 수수료는 계약한 PG 요율 그대로입니다.
- 구매자결제
- PG정산
- 셀러입금
자주 묻는 질문
PG 여러 곳을 함께 쓸 수 있나요?
쓸 수 있습니다. 주문서의 결제 옵션 목록에 켠 PG의 결제수단이 함께 나오고, 구매자가 고른 옵션의 PG로 결제합니다.
PG 계약 없이 시작할 수 있나요?
테스트 결제까지는 테스트 모드 키로 할 수 있습니다. 실결제는 PG와 계약하고 라이브 키를 등록해야 합니다.
카드 정보가 sayren 서버에 저장되나요?
저장되지 않습니다. 카드 정보는 PG 결제창에서 입력하고, sayren은 승인 결과만 받습니다.
SDK 없이 연동할 수 있나요?
할 수 있습니다. 결제 시작·상태 조회 API와 PG 스크립트로 직접 연동합니다. 네이티브 앱은 PG 앱 SDK 결과를 승인 API로 보냅니다.
PG 키는 어떻게 보관되나요?
상점마다 암호화해 서버에만 저장합니다. 화면에는 앞 4자리만 보이고, 브라우저에는 공개 키만 나갑니다.