updateLoadPaymentUIRequest 요청 형식
updateLoadPaymentUIRequest 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다.
updateLoadPaymentUIRequest 요청 데이터 정의
스토어 아이디
- 포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.
주문 번호
주문명
결제 금액(실제 결제 금액 X 10^ 해당 currency의 scale factor, 예) $1.50 -> 150)
채널 이름
면세 금액
- 결제 금액 중 면세금액에 해당하는 금액을 입력합니다.
- 미입력 시 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" 같은 형식으로 입력해주세요.
구매자 이름 후리가나
일본어 읽는 법 표기
구매자 성 후리가나
일본어 읽는 법 표기
리디렉션 방식에서 프로세스 완료 후 이동될 고객사 URL
- 결제/본인인증 창이 새로운 창으로 리다이렉트 되어 프로세스가 진행되는 방식인 경우 필수 설정 항목 입니다.
- 대부분의 모바일 환경에서 창 호출시 필수 항목입니다.
- 리다이렉트 환경에서 해당 필드 누락시 에러가 발생합니다.
웹훅 URL
Confirm URL
앱 URL Scheme
에스크로 결제 여부
구매 상품 상세 정보
상품 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
문화비 지출 여부
결제 통화 코드
- ISO 4217 통화 코드
- ISO 4217
결제창 언어 (지원되지 않은 일부 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'
기간 범위
시작 시점만 있는 기간 범위
시작 시점
종료 지점만 있는 기간 범위
종료 지점
시작 시점과 종료 지점이 모두 있는 기간 범위
시작 시점
종료 지점
제공 주기
제공 주기 (${number}d | ${number}m | ${number}y 형태로 입력할 수 있습니다.)
상품 유형
상점 정보
- KSNET 카카오페이의 경우 필수 입력
- (신)나이스페이의 경우 매출 전표에 표기 할 용도로 선택 입력
- 이니시스 일본결제의 경우 JPPG(gmoPayment) 결제의 상점정보로 사용되거나 편의점 결제 시 영수증 표시 정보로 사용됨.
상점 대표자 이름
상점 연락처
상점 주소
상점 우편번호
상점 이메일
상점 사업자 명
상점 사업자 등록 번호
상점명
상점명 약어
상점명 영문
상점명 후리카나 (일본어 읽는법 표기)
상점 영업시간 (HH:mm)
영업 시작 시간
영업 종료 시간
상점 연락처 정보 이름
ex: 문의창구, 연락처, 지원창구
SPB 버튼 렌더링에 필요한 파라미터
버튼 색상
버튼 높이
버튼 라벨
버튼 렌더링 방향
버튼 모양
label이 installment일 때 할부 결제 되는 월
버튼 하위에 문구 노출 여부
허용할 결제 수단 (예: "card, credit, bancontact")
차단할 결제 수단 (예: "venmo, mercadopago")
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 파라미터
국가
배송지 주소
국가
일반주소
상세주소
도시
주, 도, 시
프로모션 그룹 ID
프로모션 ID 목록