requestIssueBillingKeyAndPay 요청 형식

스토어 아이디

• 포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.

주문 번호

주문명

결제 금액(실제 결제 금액 X 10^ 해당 currency의 scale factor

예) $1.50 -> 150)

결제 통화 코드

• ISO 4217 통화 코드
• ISO 4217

채널 키

콘솔에서 채널 연동 시 생성된 채널 키입니다.

빌링키 발급 및 결제 수단

면세 금액

• 결제 금액 중 면세금액에 해당하는 금액을 입력합니다.
• 미입력 시 0으로 취급됩니다.
• 결제 금액과 동일하게 통화별 scale factor가 적용된 금액으로 전달해주세요.

부가세

• 부가세 금액을 입력합니다.
• 미입력 시 과세 금액의 1/11 로 자동 계산됩니다.
• 결제 금액과 동일하게 통화별 scale factor가 적용된 금액으로 전달해주세요.

환경 별 제공되는 결제/본인인증 창 유형

• PG사에 따라 가능한 창 유형이 다릅니다.
• 전달되지 않았을 때 결정되는 기본 창이 다릅니다.
• 미입력 시, 해당 PG사의 기본 창 방식을 따릅니다.

리디렉션 방식에서 프로세스 완료 후 이동될 고객사 URL

• 결제/본인인증 창이 새로운 창으로 리다이렉트 되어 프로세스가 진행되는 방식인 경우 필수 설정 항목 입니다.
• 대부분의 모바일 환경에서 창 호출시 필수 항목입니다.
• 리다이렉트 환경에서 해당 필드 누락시 에러가 발생합니다.

웹훅 URL

결제창 언어 (지원되지 않은 일부 PG사 존재)

문화비 지출 여부

결제 정보와 함께 관리하고 싶은 고객사 커스텀 JSON 데이터

서비스 제공 기간

range와 interval 중 하나를 입력해주세요.

• range: 제공 기간 범위
• interval: 제공 기간 주기

예1) 2023년 1월 1일 00시 00분 00초(KST) ~

range: {
 from: '2023-01-01T00:00:00+09:00'
}

예2) ~ 2023년 1월 1일 00시 00분 00초(KST)

range: {
 to: '2023-01-01T00:00:00+09:00'
}

예3) 2023년 1월 1일 00시 00분 00초(KST) ~ 2023년 12월 31일 23시 59분 59초(KST)

range: {
 from: '2023-12-31T23:59:59+09:00'
 to: '2023-01-01T00:00:00+09:00'
}

예4) 30일 주기 interval: '30d'

예5) 6개월 주기 interval: '6m'

예6) 1년 주기 interval: '1y'

앱 URL Scheme

상품 유형(휴대폰 빌링키 발급시 필수 입력)

상점 정보

• KSNET 카카오페이의 경우 필수 입력
• (신)나이스페이의 경우 매출 전표에 표기 할 용도로 선택 입력
• 이니시스 일본결제의 경우 JPPG(gmoPayment) 결제의 상점정보로 사용되거나 편의점 결제 시 영수증 표시 정보로 사용됨.

국가

• ISO 3166-1 alpha-2 코드

결제창이 팝업 방식일 경우 결제창에 적용할 속성

결제창이 iframe 방식일 경우 결제창에 적용할 속성

billingKeyAndPayMethod가 MOBILE인 경우에만 허용됩니다.