상품권으로 결제하려는 한국 사용자가 있습니다. 이제 고객사의 결제 화면에서 받으세요.
결제 화면이 상품권을 지원하지 않으면 그 사용자는 다른 결제수단을 찾아야 하고, 상당수는 결제를 멈춥니다. 직접 붙이려면 결제 화면만으로 끝나지 않습니다. 수취 확인, 결과 통지, 예외 처리, 정산 관리까지 서비스에 연결해야 하죠. 그 영역을 MaruPay가 맡습니다.
ORD-58202결제수단
- 카드
- 간편결제
- 상품권 결제 MaruPay 연결
놓치던 결제를 받습니다
카드, 간편결제 옆에 상품권 결제를 둡니다. 사용자는 고객사 결제 화면에서 고르고, 한국 사용자에게 맞춘 결제 화면에서 마칩니다.
몇 분기가 아니라 며칠 만에 연동
API 호출 하나로 결제를 만들고, 웹훅 하나로 주문을 반영합니다. 대부분의 팀이 2주 안에 연동 시험을 통과합니다.
‘결제했는데 왜 안 되나요’ 문의가 줄어듭니다
실제 수취가 확인돼야 완료됩니다. 애매한 건은 추측하지 않고 확인 대상으로 분리하고, 고객센터도 사용자와 같은 상태를 봅니다.
재무팀이 마감할 수 있는 기록
완료된 결제마다 정산 기록이 따로 남습니다. 고객사 주문번호로 찾고, 월말에 그대로 내보냅니다.
어떤 휴대폰에서도 동작하는 결제 화면
고객사 결제 화면에서 넘어오면 주문과 금액이 이미 채워진 MaruPay 결제 화면이 열립니다. 한국어로 안내하고, 작은 화면에서도 주문 정보를 계속 보여 주며, 결제를 마치면 고객사 서비스로 돌려보냅니다.
- 처음부터 끝까지 보이는 주문과 금액
- 나갔다 돌아온 사용자에게 이어 갈 방법 안내
- 고객사 도움말에 넣을 수 있는 결제 안내
고객사 1
결제 금액
16,500원
주문번호 ORD-58205
상품권 결제
안내에 따라 제출했어요
결제가 확인됐어요
수취 확인 · 13:39:26
marupay
결제가 완료되는 과정
생성
고객사 서버가 결제를 만들고 결제 화면 주소를 받습니다.
결제
사용자가 결제 화면의 안내에 따라 결제를 제출합니다.
확인
MaruPay가 수취를 확인하고 정확히 한 요청에 귀속합니다.
통지
서명된 payment.completed 이벤트가 웹훅으로 갑니다.
기록
결제마다 정산 기록이 따로 남습니다.
고객 문의에 추측 대신 기록으로 답하세요.
실제 수취가 확인되고 정확히 한 결제 요청과 맞을 때만 결제가 완료됩니다. 그 밖의 건은 근거와 함께 확인 대상으로 분리되니, 짐작으로 주문을 반영하는 일이 없고 고객센터는 무슨 일이 있었는지 바로 봅니다.
- 수취 확인 후 완료
- 사용자가 ‘보냈어요’를 눌러도 완료가 아닙니다. 실제로 받은 것이 확인돼야 완료입니다.
- 한 요청에만 귀속
- 맞는 요청이 없거나 여럿이면 운영자가 확인할 때까지 보류합니다.
- 서명과 재시도가 있는 웹훅
- HMAC-SHA256 서명, 간격을 늘려 가는 재시도, 콘솔에서 재전송.
- 멱등 요청
- 같은 Idempotency-Key로 다시 요청하면 결제를 새로 만들지 않고 처음 응답을 돌려줍니다.
확인 대상
2건 대기
rcpt_7Fd2Kq110,000원맞는 요청 2건9월 29일 13:49대기rcpt_7Fc9Tn27,000원맞는 요청 없음9월 29일 11:06대기rcpt_7Fb4Wm5,500원만료 후 수취9월 28일 21:40 처리됨rcpt_7Fa1Hs44,000원맞는 요청 2건9월 28일 19:22 처리됨후보 요청: rcpt_7Fd2Kq · 110,000원
pay_9BtL3eQv6mORD-58208••331813:47귀속pay_9BtK0aHw2yORD-58207••605113:46귀속결제 운영을 위해 만든 기능
멱등한 결제 생성
같은 Idempotency-Key로 안전하게 다시 요청합니다.
만료 처리
결제되지 않은 요청은 만료되고 payment.expired 이벤트가 갑니다.
언제든 상태 조회
결제 ID나 고객사 주문번호로 조회합니다.
테스트 환경
모든 계정은 별도 키와 이벤트가 있는 테스트 환경에서 시작합니다.
도입 전에 가장 많이 묻는 것들.
도입 문의 →MaruPay는 누구를 위한 서비스인가요?
이미 결제를 운영하면서 한국 사용자에게 상품권 결제 선택지를 열어 주려는 해외 온라인 서비스를 위한 사업자용 서비스입니다. 최종 사용자는 결제 화면만 보게 됩니다.
상품권을 파는 곳이나 거래소인가요?
아닙니다. 상품권을 판매하지 않고, 사용자끼리 상품권을 사고파는 곳도 아닙니다. MaruPay는 상품권 결제를 고객사의 기존 구매 흐름에 연결하고 결제와 정산 영역을 맡습니다.
결제는 언제 완료로 바뀌나요?
실제 수취가 확인되고, 그 결제가 정확히 한 결제 요청과 맞을 때만 완료됩니다. 애매한 건은 자동으로 완료하지 않고 확인 대상으로 분리합니다.
웹훅 엔드포인트가 멈춰 있으면요?
간격을 늘려 가며 다시 보내고, 콘솔에서 어떤 이벤트든 재전송할 수 있습니다. 이벤트마다 고유한 ID가 있으니 고객사 쪽에서는 이벤트별로 한 번만 반영하세요.
지원 상품권, 수수료, 정산 조건은 어떻게 되나요?
검토 단계에서 고객사별로 정합니다. 요금 페이지에서 방식을 확인하거나, 도입 문의를 주시면 서비스에 맞는 조건을 안내해 드립니다.
API 문서는 어떻게 볼 수 있나요?
전체 문서는 승인된 고객사 계정에 제공됩니다. 콘솔 계정으로 로그인하거나, API 개요를 먼저 보고 도입 문의로 시작하세요.
고객사 결제 흐름에 맞춰 보여 드릴게요.
결제 화면과 API를 고객사의 실제 주문 흐름에 맞춰 안내해 드립니다.