결제 설정하기

내 포트원 계정을 연결하면 앱에서 결제를 받습니다. 판매 대금은 결제사의 정산 일정에 따라 내 계좌로 들어오며, 돈코드는 이 판매에 수수료를 받지 않습니다.

약 15분, 계약 심사 기간 별도
설정 가이드
admin.portone.io포트원 문서

준비할 것

  • 사업자등록증. 포트원에서 전자결제를 신청할 때 필요합니다.
  • 주소로 접속되는 운영 중인 앱. 결제사가 승인 전에 앱을 확인합니다.
  • 돈코드 프로젝트의 소유자 또는 관리자 권한.

설정 단계

  1. 1

    포트원 가입

    admin.portone.io에서 이메일로 무료 가입한 뒤, 포트원이 보낸 인증 메일을 확인하세요. 인증을 마쳐야 로그인할 수 있습니다.

  2. 2

    전자결제 신청

    포트원 콘솔의 홈에서 전자결제 신청을 누르세요. 사업자등록증을 올리고 앱 주소를 입력한 뒤 결제사와 결제수단을 고르세요. 토스페이먼츠는 계약 하나로 카드, 계좌이체, 간편결제를 받을 수 있으며, 아래 가이드에서 결제사별로 안내합니다.

  3. 3

    상점 아이디 복사

    결제 연동 → 연동 관리로 이동하세요. store-로 시작하는 상점 아이디가 있습니다. 복사해 두세요.

  4. 4

    API 시크릿 발급

    결제 연동 → 연동 관리 → 식별코드·API Keys에서 V2 API를 고르세요. 새로운 API Secret 발급을 누르고 이름과 만료 기한을 정한 뒤 생성을 누르세요. 포트원은 시크릿을 한 번만 보여 주니 바로 복사하세요. 포트원 계정의 Owner나 Admin만 발급할 수 있습니다.

  5. 5

    실연동 채널 추가

    계약이 승인되면 결제 연동 → 연동 관리 → 채널 관리로 이동하세요. 연동 모드를 실연동으로 바꾸고 결제사와 결제 모듈을 고른 뒤 다음을 누르세요. 채널 이름을 정하고 계약으로 받은 상점아이디(MID)와 키를 입력한 다음 과세구분을 고르고 저장하세요. 채널 목록에 channel-key-로 시작하는 채널 키가 표시되면 복사하세요.

  6. 6

    돈코드에 붙여넣기

    프로젝트에서 결제 → 연결로 이동하세요. 세 값을 상점 아이디, API 시크릿, 결제 채널에 붙여넣고 연결을 누르세요. 돈코드가 포트원에 확인하고, 확인이 끝나면 앱에서 결제를 받습니다. API 시크릿은 저장하는 즉시 암호화되어 다시 표시되지 않으며, 마지막 네 글자만 보입니다.

웹훅 설정

선택 사항입니다. 설정하지 않아도 결제는 되지만, 포트원 관리자 화면에서 직접 한 환불은 돈코드에 표시되지 않습니다.

  1. 포트원 콘솔에서 결제 연동 → 연동 관리 → 결제알림(Webhook) 관리로 이동하세요.
  2. 웹훅 버전은 결제모듈 V2, 설정 모드는 실연동으로 고르세요.
  3. 결제 → 연결에서 결제 알림을 열고 웹훅 주소를 복사해 Endpoint URL에 붙여넣으세요.
  4. Content Type을 application/json으로 고르고 저장하세요.
  5. 웹훅 시크릿 발급을 누르고, 시크릿을 복사해 결제 → 연결의 웹훅 시크릿에 붙여넣으세요.

웹훅 주소는 이런 형태입니다:

https://payments.dontcode.cafe/api/webhooks/portone/<프로젝트 ID>

먼저 테스트하기

계약이 승인되기 전에도 연결할 수 있습니다. 채널 관리에서 연동 모드를 테스트로 바꾸고 채널을 추가하세요. 일부 결제사는 고를 수 있는 공용 테스트 아이디를 제공합니다. 그 채널 키를 결제 채널에 붙여넣고 앱에서 결제해 보세요. 테스트 결제는 결제 화면에 테스트 표시와 함께 나오며 매출에 포함되지 않습니다. 실연동 채널이 준비되면 그 채널 키로 바꿔 붙여넣으세요.

문제 해결

포트원이 API 시크릿을 받지 않음

포트원에서 새로 발급해 전체 값을 붙여넣으세요. 시크릿은 정한 만료 기한이 지나도 작동하지 않으니, 그때도 새로 발급해 연결 화면의 바꾸기로 붙여넣으세요.

API 시크릿으로 상점을 열 수 없음

상점 아이디와 API 시크릿이 서로 다른 포트원 계정에서 나왔습니다. 같은 계정에서 둘 다 다시 복사하세요.

채널 키를 받지 않음

채널 키는 channel-key-로 시작합니다. 채널 이름이나 상점아이디(MID)가 아니라 채널 관리의 채널 목록에서 채널 키를 복사하세요.

API 시크릿을 잃어버림

포트원은 시크릿을 한 번만 보여 주고 돈코드도 다시 보여 주지 않습니다. 새로 발급해 붙여넣으세요.