requestPayment 요청 형식
requestPayment 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다.
requestPayment 요청 데이터 정의
스토어 아이디
- 포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.
고객사 주문 고유 번호
- 고객사가 채번하는 주문 고유 번호입니다.
- 이미 승인 완료 된
paymentId로 결제나 가상계좌 발급을 시도하는 경우 에러가 발생합니다.
주문명
주문명으로 고객사에서 자유롭게 입력합니다.
결제 금액
결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
- 1000 만큼 원화(KRW) 결제를 하는 경우, scale factor가 0이기 때문에 1000 * (10의 0승) = 1000을 전달해야 합니다.
- 1.50 만큼 달러(USD) 결제를 하는 경우, scale factor가 2이기 때문에 1.50 * (10의 2승) = 150을 전달해야 합니다.
이렇게 전달 된 값은 실제로 PG사에 결제를 요청할때 currency에 따라 올바른 값으로 변환되기 때문에 반드시 currency값을 필수로 입력해야 합니다.
결제 통화
- 원화 결제 시
KRW로 입력해주세요.
South Korean won
United States dollar
Euro
Japanese yen
Chinese yuan
Vietnamese dong
Thai baht
Singapore dollar
Australian dollar
Hong Kong dollar
United Arab Emirates dirham
Afghan afghani
Albanian lek
Armenian dram
Netherlands Antillean guilder
Angolan kwanza
Argentine peso
Aruban florin
Azerbaijani manat
Bosnia and Herzegovina convertible mark
Barbadian dollar
Bangladeshi taka
Bulgarian lev
Bermudian dollar
Brunei dollar
Boliviano
Bolivian Mvdol
Brazilian real
Bahamian dollar
Botswana pula
Belarusian ruble
Belize dollar
Canadian dollar
Congolese franc
WIR euro
Swiss franc
WIR franc
Chilean unit of account (UF)
Chilean peso
Colombian peso
Unidad de Valor Real
Costa Rican colon
Cuban convertible peso
Cuban peso
Cape Verdean escudo
Czech koruna
Djiboutian franc
Danish krone
Dominican peso
Algerian dinar
Egyptian pound
Eritrean nakfa
Ethiopian birr
Fiji dollar
Falkland Islands pound
Pound sterling
Georgian lari
Ghanaian cedi
Gibraltar pound
Gambian dalasi
Guinean franc
Guatemalan quetzal
Guyanese dollar
Honduran lempira
Croatian kuna
Haitian gourde
Hungarian forint
Indonesian rupiah
Israeli new shekel
Indian rupee
Iraqi dinar
Iranian rial
Icelandic króna
Jamaican dollar
Jordanian dinar
Kenyan shilling
Kyrgyzstani som
Cambodian riel
Comoro franc
North Korean won
Kuwaiti dinar
Cayman Islands dollar
Kazakhstani tenge
Lao kip
Lebanese pound
Sri Lankan rupee
Liberian dollar
Lesotho loti
Libyan dinar
Moroccan dirham
Moldovan leu
Malagasy ariary
Macedonian denar
Myanmar kyat
Mongolian tögrög
Macanese pataca
Mauritanian ouguiya
Mauritian rupee
Maldivian rufiyaa
Malawian kwacha
Mexican peso
Mexican Unidad de Inversion
Mozambican metical
Namibian dollar
Nigerian naira
Nicaraguan córdoba
Norwegian krone
Nepalese rupee
New Zealand dollar
Omani rial
Panamanian balboa
Peruvian sol
Papua New Guinean kina
Philippine peso
Pakistani rupee
Polish złoty
Paraguayan guaraní
Qatari riyal
Romanian leu
Serbian dinar
Russian ruble
Rwandan franc
Saudi riyal
Solomon Islands dollar
Seychelles rupee
Sudanese pound
Swedish krona
Saint Helena pound
Sierra Leonean leone (new leone)
Sierra Leonean leone (old leone)
Somali shilling
Surinamese dollar
South Sudanese pound
São Tomé and Príncipe dobra
Salvadoran colón
Syrian pound
Swazi lilangeni
Tajikistani somoni
Turkmenistan manat
Tunisian dinar
Tongan paʻanga
Turkish lira
Trinidad and Tobago dollar
New Taiwan dollar
Tanzanian shilling
Ukrainian hryvnia
Ugandan shilling
United States dollar (next day)
Uruguay Peso en Unidades Indexadas
Uruguayan peso
Unidad previsional
Uzbekistan som
Venezuelan bolívar digital
Venezuelan bolívar soberano
Vanuatu vatu
Samoan tala
CFA franc BEAC
Silver (one troy ounce)
Gold (one troy ounce)
European Composite Unit
European Monetary Unit
European Unit of Account 9
European Unit of Account 17
East Caribbean dollar
Special drawing rights
CFA franc BCEAO
Palladium (one troy ounce)
CFP franc
Platinum (one troy ounce)
SUCRE
Code reserved for testing
ADB Unit of Account
No currency
Yemeni rial
South African rand
Zambian kwacha
Zimbabwean dollar
채널 키
콘솔에서 채널 연동 시 생성된 채널 키입니다.
스마트 라우팅 그룹 ID
-
관리자 콘솔의 [연동 관리] → [스마트 라우팅] 메뉴에서 확인할 수 있습니다.
-
스마트 라우팅 그룹 ID를 지정하여 결제창을 호출하면, 스마트 라우팅 그룹 내 설정된 채널 비율에 따라 확률 기반으로 하나의 결제대행사가 호출됩니다.
면세 금액
- 결제 금액 중 면세금액에 해당하는 금액을 입력합니다.
- 미입력 시 0으로 취급됩니다.
- 결제 금액과 동일하게 통화별 scale factor가 적용된 금액으로 전달해주세요.
부가세
- 부가세 금액을 입력합니다.
- 미입력 시 과세 금액의 1/11 로 자동 계산됩니다.
- 결제 금액과 동일하게 통화별 scale factor가 적용된 금액으로 전달해주세요.
구매자 고유 ID
구매자 전체 이름
fullName과 firstName / lastName이 모두 입력된 경우 fullName으로 기록됩니다.
구매자 이름
firstName을 입력하는 경우 lastName도 필수로 입력해야 합니다. fullName이 없고,
firstName과 lastName이 존재하는 경우 {firstName} {lastName}으로 저장됩니다.
구매자 성
lastName을 입력하는 경우 firstName도 필수로 입력해야 합니다.
구매자 연락처
구매자 이메일 주소
유효한 이메일 주소를 입력해주세요.
구매자 주소
국가
일반주소
상세주소
도시
주, 도, 시
구매자 우편번호
구매자 성별
남성
여성
기타
구매자 출생년도
ex. "1990" 같은 형식으로 입력해주세요.
구매자 출생월
ex. "12", "07" 같은 형식으로 입력해주세요.
구매자 출생일
ex. "25", "08" 같은 형식으로 입력해주세요.
구매자 이름 후리가나
일본어 읽는 법 표기
구매자 성 후리가나
일본어 읽는 법 표기
환경 별 제공되는 결제/본인인증 창 유형
- PG사에 따라 가능한 창 유형이 다릅니다.
- 전달되지 않았을 때 결정되는 기본 창이 다릅니다.
- 미입력 시, 해당 PG사의 기본 창 방식을 따릅니다.
PC에서의 결제창 유형 IFRAME, REDIRECTION, POPUP 중 하나를 입력해주세요.
모바일에서의 결제창 유형 IFRAME, REDIRECTION, POPUP 중 하나를 입력해주세요.
리디렉션 방식에서 프로세스 완료 후 이동될 고객사 URL
- 결제/본인인증 창이 새로운 창으로 리다이렉트 되어 프로세스가 진행되는 방식인 경우 필수 설정 항목 입니다.
- 대부분의 모바일 환경에서 창 호출시 필수 항목입니다.
- 리다이렉트 환경에서 해당 필드 누락시 에러가 발생합니다.
웹훅(Webhook) 수신 주소
유효한 형식의 문자열을 입력해주세요.
- 포트원 관리자 콘솔에 설정한 웹훅 주소 대신 사용할 웹훅 주소를 결제시마다 설정할 수 있습니다.
- 해당 값 설정시 관리자 콘솔에 설정한 주소로는 웹훅발송이 되지 않는점 유의하시기 바랍니다.
최종 결제 승인 요청 여부 확인 URL
유효한 URL 형식의 문자열을 입력해주세요.
confirm_process 사용 시 고객사 endpoint url 설정
- 기술지원 메일로 별도 요청이 필요합니다. (tech.support@portone.io)
모바일 결제 후 고객사 앱으로 복귀를 위한 URL scheme
- WebView 환경 결제시 필수설정 항목 입니다.
- ISP/앱카드 앱에서 결제정보인증 후 기존 앱으로 복귀할 때 사용합니다.
에스크로 결제 여부
미입력 시 기본값: false
- 에스크로 설정은 PG사와 협의 이후 진행되어야 합니다.
구매 상품 상세 정보
상품 ID
상품명
상품 코드
- 토스페이먼츠의 경우 필수로 입력해주세요.
상품 단위 가격
결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
- 1000 만큼 원화(KRW) 결제를 하는 경우, scale factor가 0이기 때문에 1000 * (10의 0승) = 1000을 전달해야 합니다.
- 1.50 만큼 달러(USD) 결제를 하는 경우, scale factor가 2이기 때문에 1.50 * (10의 2승) = 150을 전달해야 합니다.
이렇게 전달 된 값은 실제로 PG사에 결제를 요청할때 currency에 따라 올바른 값으로 변환되기 때문에 반드시 currency값을 필수로 입력해야 합니다.
상품 수량
상품 태그
상품 판매 URL
문화비 지출 여부
도서, 공연, 박물관 등 문화비 지출 여부
결제창 언어 (지원되지 않은 일부 PG사 존재)
결제 정보와 함께 관리하고 싶은 고객사 커스텀 JSON 데이터
PG사 결제창 호출 시 PG사로 그대로 bypass할 값들의 모음
토스페이먼츠 bypass 파라미터
토스페이먼츠 <-> 고객사 계약에 따라 프로모션 적용이 가능한 코드
해외 카드로만 결제가 가능하도록 할 지 여부
KSNET bypass 파라미터
간편 결제 표시 구분
KSNET 간편결제 다이렉트 여부
Paypal bypass 파라미터
create order API 호출에 필요한 파라미터
구매 상품 정보
수령지 정보
수령지 주소. 미 입력 시 입력된 주소로 override되지 않음
필수 입력. 미 입력 시 create order 실패
국가 코드
Afghanistan
Åland Islands
Albania
Algeria
American Samoa
Andorra
Angola
Anguilla
Antarctica
Antigua and Barbuda
Argentina
Armenia
Aruba
Australia
Austria
Azerbaijan
Bahrain
Bahamas
Bangladesh
Barbados
Belarus
Belgium
Belize
Benin
Bermuda
Bhutan
Bolivia, Plurinational State of
Bonaire, Sint Eustatius and Saba
Bosnia and Herzegovina
Botswana
Bouvet Island
Brazil
British Indian Ocean Territory
Brunei Darussalam
Bulgaria
Burkina Faso
Burundi
Cambodia
Cameroon
Canada
Cape Verde
Cayman Islands
Central African Republic
Chad
Chile
China
Christmas Island
Cocos (Keeling) Islands
Colombia
Comoros
Congo
Congo, the Democratic Republic of the
Cook Islands
Costa Rica
Côte d'Ivoire
Croatia
Cuba
Curaçao
Cyprus
Czech Republic
Denmark
Djibouti
Dominica
Dominican Republic
Ecuador
Egypt
El Salvador
Equatorial Guinea
Eritrea
Estonia
Ethiopia
Falkland Islands (Malvinas)
Faroe Islands
Fiji
Finland
France
French Guiana
French Polynesia
French Southern Territories
Gabon
Gambia
Georgia
Germany
Ghana
Gibraltar
Greece
Greenland
Grenada
Guadeloupe
Guam
Guatemala
Guernsey
Guinea
Guinea-Bissau
Guyana
Haiti
Heard Island and McDonald Islands
Holy See (Vatican City State)
Honduras
Hong Kong
Hungary
Iceland
India
Indonesia
Iran, Islamic Republic of
Iraq
Ireland
Isle of Man
Israel
Italy
Jamaica
Japan
Jersey
Jordan
Kazakhstan
Kenya
Kiribati
Korea, Democratic People's Republic of
Korea, Republic of
Kuwait
Kyrgyzstan
Lao People's Democratic Republic
Latvia
Lebanon
Lesotho
Liberia
Libya
Liechtenstein
Lithuania
Luxembourg
Macao
Macedonia, the Former Yugoslav Republic of
Madagascar
Malawi
Malaysia
Maldives
Mali
Malta
Marshall Islands
Martinique
Mauritania
Mauritius
Mayotte
Mexico
Micronesia, Federated States of
Moldova, Republic of
Monaco
Mongolia
Montenegro
Montserrat
Morocco
Mozambique
Myanmar
Namibia
Nauru
Nepal
Netherlands
New Caledonia
New Zealand
Nicaragua
Niger
Nigeria
Niue
Norfolk Island
Northern Mariana Islands
Norway
Oman
Pakistan
Palau
Palestine, State of
Panama
Papua New Guinea
Paraguay
Peru
Philippines
Pitcairn
Poland
Portugal
Puerto Rico
Qatar
Réunion
Romania
Russian Federation
Rwanda
Saint Barthélemy
Saint Helena, Ascension and Tristan da Cunha
Saint Kitts and Nevis
Saint Lucia
Saint Martin (French part)
Saint Pierre and Miquelon
Saint Vincent and the Grenadines
Samoa
San Marino
Sao Tome and Principe
Saudi Arabia
Senegal
Serbia
Seychelles
Sierra Leone
Singapore
Sint Maarten (Dutch part)
Slovakia
Slovenia
Solomon Islands
Somalia
South Africa
South Georgia and the South Sandwich Islands
South Sudan
Spain
Sri Lanka
Sudan
Suriname
Svalbard and Jan Mayen
Swaziland
Sweden
Switzerland
Syrian Arab Republic
Taiwan, Province of China
Tajikistan
Tanzania, United Republic of
Thailand
Timor-Leste
Togo
Tokelau
Tonga
Trinidad and Tobago
Tunisia
Turkey
Turkmenistan
Turks and Caicos Islands
Tuvalu
Uganda
Ukraine
United Arab Emirates
United Kingdom
United States
United States Minor Outlying Islands
Uruguay
Uzbekistan
Vanuatu
Venezuela, Bolivarian Republic of
Viet Nam
Virgin Islands, British
Virgin Islands, U.S.
Wallis and Futuna
Western Sahara
Yemen
Zambia
Zimbabwe
구매자 정보
구매자 세금 정보 (브라질 구매자의 경우 필수 입력)
구매자 주소지 정보
우편번호
국가 코드
Afghanistan
Åland Islands
Albania
Algeria
American Samoa
Andorra
Angola
Anguilla
Antarctica
Antigua and Barbuda
Argentina
Armenia
Aruba
Australia
Austria
Azerbaijan
Bahrain
Bahamas
Bangladesh
Barbados
Belarus
Belgium
Belize
Benin
Bermuda
Bhutan
Bolivia, Plurinational State of
Bonaire, Sint Eustatius and Saba
Bosnia and Herzegovina
Botswana
Bouvet Island
Brazil
British Indian Ocean Territory
Brunei Darussalam
Bulgaria
Burkina Faso
Burundi
Cambodia
Cameroon
Canada
Cape Verde
Cayman Islands
Central African Republic
Chad
Chile
China
Christmas Island
Cocos (Keeling) Islands
Colombia
Comoros
Congo
Congo, the Democratic Republic of the
Cook Islands
Costa Rica
Côte d'Ivoire
Croatia
Cuba
Curaçao
Cyprus
Czech Republic
Denmark
Djibouti
Dominica
Dominican Republic
Ecuador
Egypt
El Salvador
Equatorial Guinea
Eritrea
Estonia
Ethiopia
Falkland Islands (Malvinas)
Faroe Islands
Fiji
Finland
France
French Guiana
French Polynesia
French Southern Territories
Gabon
Gambia
Georgia
Germany
Ghana
Gibraltar
Greece
Greenland
Grenada
Guadeloupe
Guam
Guatemala
Guernsey
Guinea
Guinea-Bissau
Guyana
Haiti
Heard Island and McDonald Islands
Holy See (Vatican City State)
Honduras
Hong Kong
Hungary
Iceland
India
Indonesia
Iran, Islamic Republic of
Iraq
Ireland
Isle of Man
Israel
Italy
Jamaica
Japan
Jersey
Jordan
Kazakhstan
Kenya
Kiribati
Korea, Democratic People's Republic of
Korea, Republic of
Kuwait
Kyrgyzstan
Lao People's Democratic Republic
Latvia
Lebanon
Lesotho
Liberia
Libya
Liechtenstein
Lithuania
Luxembourg
Macao
Macedonia, the Former Yugoslav Republic of
Madagascar
Malawi
Malaysia
Maldives
Mali
Malta
Marshall Islands
Martinique
Mauritania
Mauritius
Mayotte
Mexico
Micronesia, Federated States of
Moldova, Republic of
Monaco
Mongolia
Montenegro
Montserrat
Morocco
Mozambique
Myanmar
Namibia
Nauru
Nepal
Netherlands
New Caledonia
New Zealand
Nicaragua
Niger
Nigeria
Niue
Norfolk Island
Northern Mariana Islands
Norway
Oman
Pakistan
Palau
Palestine, State of
Panama
Papua New Guinea
Paraguay
Peru
Philippines
Pitcairn
Poland
Portugal
Puerto Rico
Qatar
Réunion
Romania
Russian Federation
Rwanda
Saint Barthélemy
Saint Helena, Ascension and Tristan da Cunha
Saint Kitts and Nevis
Saint Lucia
Saint Martin (French part)
Saint Pierre and Miquelon
Saint Vincent and the Grenadines
Samoa
San Marino
Sao Tome and Principe
Saudi Arabia
Senegal
Serbia
Seychelles
Sierra Leone
Singapore
Sint Maarten (Dutch part)
Slovakia
Slovenia
Solomon Islands
Somalia
South Africa
South Georgia and the South Sandwich Islands
South Sudan
Spain
Sri Lanka
Sudan
Suriname
Svalbard and Jan Mayen
Swaziland
Sweden
Switzerland
Syrian Arab Republic
Taiwan, Province of China
Tajikistan
Tanzania, United Republic of
Thailand
Timor-Leste
Togo
Tokelau
Tonga
Trinidad and Tobago
Tunisia
Turkey
Turkmenistan
Turks and Caicos Islands
Tuvalu
Uganda
Ukraine
United Arab Emirates
United Kingdom
United States
United States Minor Outlying Islands
Uruguay
Uzbekistan
Vanuatu
Venezuela, Bolivarian Republic of
Viet Nam
Virgin Islands, British
Virgin Islands, U.S.
Wallis and Futuna
Western Sahara
Yemen
Zambia
Zimbabwe
STC 파라미터
카카오페이 bypass 파라미터
카카오페이 결제창에 띄워줄 사용자 정의 문구
스마트로 V2 bypass 파라미터
결제 상품 품목 개수
UI 스타일 (기본값: "RED")
"RED", "GREEN", "BLUE", "PURPLE" 중 하나의 값으로 입력해주세요.
해외 카드만 결제를 허용할지 여부(기본값: "KR")
"KR", "EN" 중 하나의 값으로 입력해주세요.
네이버페이 bypass 파라미터
이용 완료일(YYYYMMDD)
결제 상품 유형
결제 상품 분류
결제 상품 식별값
상품명
결제 상품 유입경로
시작일(YYYYMMDD)
종료일(YYYYMMDD)
하위 판매자 식별키
결제 상품 개수
하부 가맹점 정보. PG 업종 가맹점인 경우에만 필수 값
하부 가맹점 명
하부 가맹점 ID
하부 가맹점 사업자 번호(숫자 10자리)
하부 가맹점 결제 키
하부 가맹점 대표 전화번호
하부 가맹점 고객 서비스 URL
배송비
(신)나이스페이먼츠 bypass 파라미터
결제창 로고 이미지 URL
결제창 스크롤 미사용 여부 (PC Only, Y: 미사용 / N(default): 사용)
결제창 스킨 색상 설정
"red", "green", "purple", "gray", "dark" 중 하나의 값으로 입력해주세요.
문화 상품권 결제시 결제 고객 사용자 인증 CI 정보. 아이디/비밀번호 외 추가로 CI 인증이 필요한 경우 사용. 사용 전 영업 담당자와 사전 협의 필수
상점 사용자 아이디. 문화 상품권 결제시 경우 필수 입력
신용카드 쿠폰 자동 적용 여부 (Y: 사전 등록된 선 할인 쿠폰을 자동 적용 / N: 쿠폰 미적용(기본값))
할부 거래 요청 시 할인 적용 후 승인 금액이 할부 가능 금액 (50,000) 미만인 경우 인증 실패 처리
다이렉트 호출 결제 수단 (BANK: 계좌이체/CELLPHONE: 휴대폰 소액결제)
카드사 별 호출 방식
형식) 카드코드:노출유형|카드코드:노출유형
예시) 08:3|02:3 → 롯데카드와 국민카드 선택시 앱 카드 직접 호출 방식으로 렌더링
- 노출 유형: 1(안심클릭), 2(간편결제), 3(앱 카드 직접 호출)
- 카드 코드: 02(국민), 04(삼성), 06(신한), 07(현대), 08(롯데), 12(NH), 15(우리)만 가능
페이코 계정 자동 로그인 기능 사용하기 위해 페이코에서 고객사에 발급한 ClientId
페이코 계정 자동 로그인 기능 사용을 위한 접속 토큰
삼성페이 고객사 유형 (01: 삼성페이 內 쇼핑 / 99: 기타 (기본값))
토스 브랜드페이 bypass 파라미터
loadBrandpay 호출시 전달하는 세번째 파라미터
UI의 메인 색상. (기본값: #3182f6)
버튼 스타일
- default(기본값): 모서리가 둥글고 주변에 여백을 가진 버튼
- full: 하단 영역이 전부 채워지는 형태의 버튼
UI에 표시되는 원터치 결제를 대신해 사용할 텍스트. (기본값: "원터치 결제")
내비게이션 바 사용 여부. (기본값: true)
내비게이션 바 위쪽에 설정할 여백 값. 값의 단위는 px
브랜드페이 위젯 render() 함수 호출시 전달하는 두번째 파라미터
위젯에 보여줄 결제 수단. 예) 카드 전달시 등록한 결제 수단 중 카드만 노출 됨
위젯에서 기본 결제 수단으로 선택할 결제 수단의 ID
혜택 배지 영역을 보여줄지 여부. 혜택 배지 영역에서는 즉시 할인 대상 카드 정보 등을 간략히 보여 줌. 기본값은 true
결제 혜택 영역을 보여줄지 여부. 기본값은 true
결제 혜택의 상세 설명을 보여줄지 여부. 각 카드사의 결제 혜택을 자세히 설명 함. 기본값은 false
카드사 할인코드
등록되어 있는 결제수단 중 하나를 지정해서 바로 결제하고 싶을 때 사용
웰컴페이먼츠 bypass 파라미터
메인 로고 URL (크기: 89x19)
서브 로고 URL (크기: 64x13)
다양한 결제 옵션을 설정하기 위한 파라미터 배열입니다.
가능한 값들은 다음과 같습니다:
- SKIN(#색상코드): 결제 창의 배경 색상 설정 (기본값: #c1272c)
- 예시:
SKIN(#fc6b2d)
- 예시:
- below1000: 1,000원 미만 결제 허용 여부
- onlyeasypaycode(간편결제코드들): 카드 결제창에 렌더링될 간편 결제 리스트 지정
- 예시:
onlyeasypaycode(kakaopay:lpay:payco) - 간편결제코드:
- 카카오페이:
kakaopay - 엘페이:
lpay - 페이코:
payco - 토스페이:
tosspay
- 카카오페이:
- 예시:
- SLIMQUOTA(코드-개월:개월^코드-개월:개월): 부분 무이자 할부 옵션
- 형식:
SLIMQUOTA(카드코드-할부개월:부분무이자개월^...)
- 형식:
- paypopup: 안심 클릭을 팝업 형태로 렌더링 할지 여부
- hppdefaultcorp(통신사코드): 휴대폰 소액결제 시 기본 선택 통신사 지정
- 예시:
hppdefaultcorp(KTF) - 통신사코드:
SKT: SK 텔레콤KTF: KTLGT: LG 유플러스MVNO: 알뜰폰 전체CJH: 알뜰폰 CJ 헬로 모바일KCT: 알뜰폰 티플러스SKL: 알뜰폰 SK 세븐 모바일
- 예시:
- hppnofix(Y|N): 휴대폰 소액결제창에 자동 입력되는
buyer_tel값을 수정할 수 있는지 여부Y: 수정 불가능N: 수정 가능 (기본값)
- va_ckprice: 가상계좌 발급 시, 주민번호 채번 할 때 금액 체크 기능
- 신용카드 우선 선택 옵션
- 예시:
selcode=14 - 해당 카드 코드에 해당하는 카드가 선택된 채로 표시
- 간편결제는 불가능 (타 카드 선택 가능)
- 선택적 표시 옵션
- 예시 1:
onlycard=visa3d - 예시 2:
selcode=14:onlycard=visa3d - 선택적 표시 가능 결제 방식:
- 안심결제:
visa3d - ISP:
isp - 간편결제:
easypay
- 안심결제:
카드 결제창에 렌더링될 간편 결제 리스트를 지정합니다.
예시: 카카오페이, 엘페이, 페이코만 렌더링 → KAKAOPAY:LPAY:PAYCO
- 카카오페이:
KAKAOPAY - 엘페이:
LPAY - 페이코:
PAYCO - 토스페이:
TOSSPAY
결제창 동작을 제어하기 위한 파라미터들을 설정하는 배열입니다.
가능한 값들은 다음과 같습니다:
- below1000=Y: 1,000원 미만 결제 허용 여부
- hpp_default_corp=통신사코드: 휴대폰 소액결제 시 기본 선택 통신사 지정
- 예시:
hpp_default_corp=KTF - 통신사코드:
SKT: SK 텔레콤KTF: KTLGT: LG 유플러스MVNO: 알뜰폰 전체CJH: 알뜰폰 CJ 헬로 모바일KCT: 알뜰폰 티플러스SKL: 알뜰폰 SK 세븐 모바일
- 예시:
- hpp_nofix=Y|N: 휴대폰 소액결제창에서 자동 입력된
buyer_tel수정 가능 여부Y: 수정 불가능N: 수정 가능 (기본값)
토스페이 bypass 파라미터
결제 만료 기한 (yyyy-MM-dd HH:mm:ss)
현금영수증 발급타입
- CULTURE: 문화비
- GENERAL: 일반 (기본값)
- PUBLIC_TP: 교통비
KG이니시스 bypass 파라미터
KG이니시스는 PC 결제 모듈과 모바일 결제 모듈이 분리되어 있기 때문에 bypass 파라미터 또한 PC용과 모바일용이 분리되어 있습니다.
PC용 파라미터
결제창에 삽입할 메인 로고 url
결제창 중앙 상단에 표시됩니다. 이미지 권장 사이즈는 89*18 입니다.
PC용 파라미터
결제창에 삽입할 서브 로고 url
결제창 우측 상단에 표시됩니다. 이미지 권장 사이즈는 64*13 입니다.
PC용 파라미터
보호자 이메일 주소
14세 미만 고객의 경우 필수 입력입니다. "@", "." 외의 특수문자는 입력 불가합니다.
PC용 파라미터
SSGPAY 결제요청 시 PUSH 전송 휴대폰번호
- 없이 숫자만 허용합니다.
PC용 파라미터
추가 옵션
아래 string 중 원하는 옵션들을 골라 array 형태로 입력합니다.
-
SKIN(#색상코드)
결제창 배경색상 설정 [기본값: #C1272C]
예시:
SKIN(#fc6b2d) -
below1000
(카드결제 & 간편결제 시) 1000원 미만 결제 허용 옵션
-
ocb
(카드결제 시) 카드 메인화면에 OCB 적립을 위한 카드번호 창 표시옵션 (별도 계약시 이용 가능)
-
paypopup
(카드결제 시) 안심클릭계열 신용카드 POPUP 형태 표시옵션
-
hidebar
(카드결제 시) 프로그레스바 미노출 옵션
-
noeasypay
(카드결제 시) 간편결제 미노출 옵션
-
slimquota(코드-개월:개월^코드-개월:개월)
부분 무이자 설정 (별도 계약시 이용 가능)
string부분에는코드-개월:개월^코드-개월:개월와 같은 형식으로 입력합니다. (ex.slimquota(11-2:3^34-2:3)) 카드사 코드는 KG이니시스 통합 코드 페이지에서 "결제요청 시 카드코드" 섹션을 참고하시기 바랍니다. -
mallpoint(카드코드:카드코드)
몰포인트 (별도 계약시 이용 가능)
string부분에는카드코드:카드코드와 같은 형식으로 입력합니다. (ex.mallpoint(11:34)) 카드사 코드는 KG이니시스 통합 코드 페이지에서 "결제요청 시 카드코드" 섹션을 참고하시기 바랍니다.
모바일용 파라미터
신용카드 우선선택 옵션
설정한 카드코드에 해당하는 카드가 선택된 채로 Display 됩니다.
selcode=카드코드 형식으로 입력합니다. (ex. selcode=14)
모바일용 파라미터
가맹점 이름
모바일용 파라미터
추가 옵션
아래 string 중 원하는 옵션들을 골라 array 형태로 입력합니다.
-
below1000=Y
(카드결제 & 간편결제 시) 1000원 미만 결제 허용 옵션
-
noeasypay=Y
(카드결제 시) 간편결제 미노출 옵션
-
global_visa3d=Y
해외카드 노출 옵션
-
apprun_check=Y
(android의 경우) custom url scheme 대신 intent schema(intent://) 호출
KPN bypass 파라미터
- 해외카드 (VISA + MASTER + JCB) :
GLOBAL - 11Pay (SKPay) :
11PAY - 구인증 :
LEGACY_AUTH - 키인 :
KEY_IN
해외카드
11Pay
구인증
키인
NHN KCP bypass 파라미터
포인트 결제의 경우 신용카드 + 포인트 결제인데, N으로 설정 시 포인트로만 결제가 이루어짐
가상계좌, 계좌이체 시 현금영수증 노출 여부
결제창에 노출될 고객사 상호명
에스크로 배송 예상 소요일
하이픈 bypass 파라미터
엑심베이 V2 bypass 파라미터
결제 정보
결제수단 단독 노출
결제수단 노출 목록
상점 정보
상점명
파트너 코드
세금 정보
현금영수증 발급 여부
최대 3개의 추가 비용 목록
항목명
수량
단가 (음수 가능)
배송지 정보
배송지 도시
배송지 국가 (ISO 3166 두 자리 국가 코드)
수신인의 성을 제외한 이름
수신인의 성
수신인 전화번호
배송지 우편번호
배송지가 미국 혹은 캐나다인 경우, 배송지 주 정보
배송지 상세 주소
청구지 정보
청구지 도시
청구지 국가 (ISO 3166 두 자리 국가 코드)
청구 카드 명의자의 성을 제외한 이름
청구 카드 명의자의 성
청구 카드 명의자의 전화번호
청구지 우편번호
청구지가 미국 혹은 캐나다인 경우, 청구지 주 정보
청구지 상세 주소
설정 정보
인앱 웹뷰 여부
해외 결제 가맹점에서 국내 결제를 사용할 경우 KR
입금 만료 일자 (yyyyMMddHH)
이니시스 일본 bypass 파라미터
결제창 UI 설정
결제창 색상
가능한 값:
red1red2red3red4orangeyellowblackpurplegreenblue1blue2blue3blue4blue5blue6
가맹점 로고 이미지 URL
69 * 20 픽셀 크기의 이미지 URL
페이레터 해외결제 bypass 파라미터
결제수단 지정용 파라미터
- 해외카드 인증 :
PLCreditCard - 해외카드 비인증(3DS) :
PLCreditCardMpi - 유니온페이 :
PLUnionPay_HC - 위챗페이 PC결제:
WeChatPayQRCodePayment - 위챗페이 모바일결제 :
WeChatPayH5Payment - 알리페이 :
ICBAlipay
고객사 서비스명, WeChatPay, Alipay 이용 시 필수 입력
국가
상품 유형
서비스 제공 기간
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'
기간 범위
시작 시점만 있는 기간 범위
시작 시점
종료 지점만 있는 기간 범위
종료 지점
시작 시점과 종료 지점이 모두 있는 기간 범위
시작 시점
종료 지점
제공 주기
제공 주기 (${number}d | ${number}m | ${number}y 형태로 입력할 수 있습니다.)
상점 정보
- KSNET 카카오페이의 경우 필수 입력
- (신)나이스페이의 경우 매출 전표에 표기 할 용도로 선택 입력
- 이니시스 일본결제의 경우 JPPG(gmoPayment) 결제의 상점정보로 사용되거나 편의점 결제 시 영수증 표시 정보로 사용됨.
상점 대표자 이름
상점 연락처
상점 주소
상점 우편번호
상점 이메일
상점 사업자 명
상점 사업자 등록 번호
상점명
상점명 약어
상점명 영문
상점명 후리카나 (일본어 읽는법 표기)
상점 영업시간 (HH:mm)
영업 시작 시간
영업 종료 시간
상점 연락처 정보 이름
ex: 문의창구, 연락처, 지원창구
배송지 주소 (토스 브랜드페이의 FDS를 위해 사용됨)
국가
일반주소
상세주소
도시
주, 도, 시
프로모션 아이디
결제창이 팝업 방식일 경우 결제창에 적용할 속성
true로 설정하면 결제창이 브라우저 화면의 정중앙에 표시됩니다.
결제창이 iframe 방식일 경우 결제창에 적용할 속성
false로 설정하면 결제창 배경이 투명해집니다.
payMethod가 CARD인 경우에만 허용됩니다.
카드 정보
카드 결제 시, 카드 결제에 대한 세부 정보
payMethod가 VIRTUAL_ACCOUNT인 경우에만 허용됩니다.
가상계좌 정보
가상계좌 발급시 가상계좌 상세 옵션
payMethod가 TRANSFER인 경우에만 허용됩니다.
계좌이체 정보
계좌이체 결제시 계좌이체 상세 옵션
payMethod가 MOBILE인 경우에만 허용됩니다.
휴대폰 소액결제 정보
휴대폰 소액결제시 휴대폰 소액결제 상세 옵션
payMethod가 GIFT_CERTIFICATE인 경우에만 허용됩니다.
상품권 정보
상품권 결제시 상품권 결제 상세 옵션
payMethod가 EASY_PAY인 경우에만 허용됩니다.
payMethod가 PAYPAL인 경우에만 허용됩니다.
payMethod가 ALIPAY인 경우에만 허용됩니다.
payMethod가 CONVENIENCE_STORE인 경우에만 허용됩니다.