결제 관련 API

결제에 관련된 API 를 확인할 수 있습니다.
⌨ 결제내역 단건조회
get
https://api.portone.io/v2
/payments/{payment_id}
결제가 발생한 이후 즉시 조회가 가능한 API입니다.
⌨ 결제내역 다건조회
get
https://api.portone.io/v2
/payments
결제내역들을 조회할 수 있는 API입니다. 실제 결제 발생 이후 조회되기까지 지연이 있으니 검증을 위해서는 결제내역 단건조회를 이용해주세요. 현재 page * limit이 50000 이상이 되는 쿼리를 허용하지 않는 제약을 갖고있습니다. 많은 양의 데이터를 받아올 경우 날짜범위를 좁혀서 사용해주세요. 추후 50000개 이상 대량의 데이터를 한번에 편리하게 쿼리할 수 있도록 하는 수정이 예정되어있습니다. 
⌨ 결제 취소
post
https://api.portone.io/v2
/payments/{payment_id}/cancel
결제 취소
RefundAccount
bank * string
은행
​
account_holder * string
예금주
​
account_number * string
계좌번호
​
phone_number string
예금주 연락처 - 스마트로 가상계좌 결제인 경우에 필요합니다.
​
⌨ 웹훅 재발송
post
https://api.portone.io/v2
/payments/{payment_id}/resend-webhook
`tx_id`와 `webhook_id` 모두 값을 넣지 않으면 대표 트랜잭션의 가장 최근 웹훅 발송 이력을 기준으로 재전송됩니다. 
⌨ 가상계좌 테스트 웹훅 호출
post
https://api.portone.io/v2
/test-payments/{payment_id}/notice-virtual-account-deposit
가상계좌 테스트 결제 건에 대한 입금 통보 웹훅을 호출합니다.
⌨ 결제 예약
post
https://api.portone.io/v2
/schedules
결제 예약
Country
Currency
CustomerFormWithoutId
CustomerName
국가
"AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BH", "BS", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW"
화폐
"KRW", "USD", "EUR", "JPY", "CNY", "VND", "THB", "SGD", "AUD", "HKD", "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BOV", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHE", "CHF", "CHW", "CLF", "CLP", "COP", "COU", "CRC", "CUC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "KES", "KGS", "KHR", "KMF", "KPW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MXV", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SHP", "SLE", "SLL", "SOS", "SRD", "SSP", "STN", "SVC", "SYP", "SZL", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USN", "UYI", "UYU", "UYW", "UZS", "VED", "VES", "VUV", "WST", "XAF", "XAG", "XAU", "XBA", "XBB", "XBC", "XBD", "XCD", "XDR", "XOF", "XPD", "XPF", "XPT", "XSU", "XTS", "XUA", "XXX", "YER", "ZAR", "ZMW", "ZWL"
phone_number string
휴대폰 번호
​
customer_name CustomerName
고객 이름 정보. full_name만 채워져 있거나, first_name & last_name이 채워져 있어야 함
CustomerName
full_name string
​
first_name string
​
last_name string
​
​
email string
고객 이메일
​
zipcode string
우편번호
​
address string
주소
​
gender Gender
성별
"MALE", "FEMALE", "OTHER"
​
birth_year string
출생연도
​
full_name string
​
first_name string
​
last_name string
​
Gender
Product
ProductType
성별
"MALE", "FEMALE", "OTHER"
id * string
​
name * string
​
tag string
​
code string
​
unit_price * integer
​
quantity * integer
​
상품 유형
"REAL", "DIGITAL"
⌨ 빌링키 결제
post
https://api.portone.io/v2
/payments/{payment_id}/billing-key/pay
빌링키 결제
country_Country
currency_Currency
CustomerFormWithoutId
CustomerName
국가
"AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BH", "BS", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW"
화폐
"KRW", "USD", "EUR", "JPY", "CNY", "VND", "THB", "SGD", "AUD", "HKD", "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BOV", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHE", "CHF", "CHW", "CLF", "CLP", "COP", "COU", "CRC", "CUC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "KES", "KGS", "KHR", "KMF", "KPW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MXV", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SHP", "SLE", "SLL", "SOS", "SRD", "SSP", "STN", "SVC", "SYP", "SZL", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USN", "UYI", "UYU", "UYW", "UZS", "VED", "VES", "VUV", "WST", "XAF", "XAG", "XAU", "XBA", "XBB", "XBC", "XBD", "XCD", "XDR", "XOF", "XPD", "XPF", "XPT", "XSU", "XTS", "XUA", "XXX", "YER", "ZAR", "ZMW", "ZWL"
phone_number string
휴대폰 번호
​
customer_name CustomerName
고객 이름 정보. full_name만 채워져 있거나, first_name & last_name이 채워져 있어야 함
CustomerName
full_name string
​
first_name string
​
last_name string
​
​
email string
고객 이메일
​
zipcode string
우편번호
​
address string
주소
​
gender gender_Gender
성별
"MALE", "FEMALE", "OTHER"
​
birth_year string
출생연도
​
full_name string
​
first_name string
​
last_name string
​
gender_Gender
product_Product
ProductType
성별
"MALE", "FEMALE", "OTHER"
id * string
​
name * string
​
tag string
​
code string
​
unit_price * integer
​
quantity * integer
​
상품 유형
"REAL", "DIGITAL"
⌨ 키인(수기) 결제
post
https://api.portone.io/v2
/payments/{payment_id}/instant/pay
키인(수기) 결제
Bank
CardCredential
cash_receipt_type_CashReceiptType
country_Country
은행
"BANK_OF_KOREA", "KOREA_DEVELOPMENT_BANK", "INDUSTRIAL_BANK_OF_KOREA", "KOOKMIN_BANK", "SUHYUP_BANK", "EXPORT_IMPORT_BANK_OF_KOREA", "NH_NONGHYUP_BANK", "LOCAL_NONGHYUP", "WOORI_BANK", "SC_BANK_KOREA", "CITI_BANK_KOREA", "DAEGU_BANK", "BUSAN_BANK", "GWANGJU_BANK", "JEJU_BANK", "JEONBUK_BANK", "KYONGNAM_BANK", "KFCC", "SHINHYUP", "SAVINGS_BANK_KOREA", "MORGAN_STANLEY_BANK", "HSBC_BANK", "DEUTSCHE_BANK", "JP_MORGAN_CHASE_BANK", "MIZUHO_BANK", "MUFG_BANK", "BANK_OF_AMERICA_BANK", "BNP_PARIBAS_BANK", "ICBC", "BANK_OF_CHINA", "NATIONAL_FORESTRY_COOPERATIVE_FEDERATION", "UNITED_OVERSEAS_BANK", "BANK_OF_COMMUNICATIONS", "CHINA_CONSTRUCTION_BANK", "EPOST", "KODIT", "KIBO", "HANA_BANK", "SHINHAN_BANK", "K_BANK", "KAKAO_BANK", "TOSS_BANK", "KCIS", "DAISHIN_SAVINGS_BANK", "SBI_SAVINGS_BANK", "HK_SAVINGS_BANK", "WELCOME_SAVINGS_BANK", "SHINHAN_SAVINGS_BANK", "KYOBO_SECURITIES", "DAISHIN_SECURITIES", "MERITZ_SECURITIES", "MIRAE_ASSET_SECURITIES", "BOOKOOK_SECURITIES", "SAMSUNG_SECURITIES", "SHINYOUNG_SECURITIES", "SHINHAN_FINANCIAL_INVESTMENT", "YUANTA_SECURITIES", "EUGENE_INVESTMENT_SECURITIES", "KAKAO_PAY_SECURITIES", "TOSS_SECURITIES", "KOREA_FOSS_SECURITIES", "HANA_FINANCIAL_INVESTMENT", "HI_INVESTMENT_SECURITIES", "KOREA_INVESTMENT_SECURITIES", "HANWHA_INVESTMENT_SECURITIES", "HYUNDAI_MOTOR_SECURITIES", "DB_FINANCIAL_INVESTMENT", "KB_SECURITIES", "KTB_INVESTMENT_SECURITIES", "NH_INVESTMENT_SECURITIES", "SK_SECURITIES"
card_number * string
​
expiry_month * string
​
expiry_year * string
​
birth_or_business_registration_number * string
​
password_two_digits * string
​
현금영수증 용도. personal = 소득공제용, corporate = 지출증빙용, anonymous = 국세청번호 자동발급 케이스
"PERSONAL", "CORPORATE", "ANONYMOUS"
국가
"AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BH", "BS", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW"
currency_Currency
CustomerForm
CustomerName
gender_Gender
화폐
"KRW", "USD", "EUR", "JPY", "CNY", "VND", "THB", "SGD", "AUD", "HKD", "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BOV", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHE", "CHF", "CHW", "CLF", "CLP", "COP", "COU", "CRC", "CUC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "KES", "KGS", "KHR", "KMF", "KPW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MXV", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SHP", "SLE", "SLL", "SOS", "SRD", "SSP", "STN", "SVC", "SYP", "SZL", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USN", "UYI", "UYU", "UYW", "UZS", "VED", "VES", "VUV", "WST", "XAF", "XAG", "XAU", "XBA", "XBB", "XBC", "XBD", "XCD", "XDR", "XOF", "XPD", "XPF", "XPT", "XSU", "XTS", "XUA", "XXX", "YER", "ZAR", "ZMW", "ZWL"
customer_id string
가맹점의 고객 고유 ID - 값을 넣지 않으면 PortOne에서 자체 채번합니다.
​
phone_number string
휴대폰 번호
​
customer_name CustomerName
고객 이름 정보. full_name만 채워져 있거나, first_name & last_name이 채워져 있어야 함
CustomerName
full_name string
​
first_name string
​
last_name string
​
​
email string
고객 이메일
​
zipcode string
우편번호
​
address string
주소
​
gender gender_Gender
성별
"MALE", "FEMALE", "OTHER"
​
birth_year string
출생연도
​
full_name string
​
first_name string
​
last_name string
​
성별
"MALE", "FEMALE", "OTHER"
InstantCardForm
InstantPaymentMethodForm
InstantVirtualAccountForm
product_Product
card_credential * CardCredential
카드를 이용한 결제 및 빌링키 발급에 필요한 인증 관련 정보
CardCredential
card_number * string
​
expiry_month * string
​
expiry_year * string
​
birth_or_business_registration_number * string
​
password_two_digits * string
​
​
cvc string
​
vbv VBV
3DS 인증 결과를 담는 객체 (Verified by Visa)
VBV
cavv * string
​
xid * string
​
eci * string
​
​
card_installment_plan integer
카드 할부 개월 수
​
use_free_installment_plan boolean
무이자 할부 적용 여부
​
use_free_interest_from_mall boolean
​
card InstantCardForm
카드를 이용한 결제 & 빌링키 발급 시에 필요한 카드 관련 정보
InstantCardForm
card_credential * CardCredential
카드를 이용한 결제 및 빌링키 발급에 필요한 인증 관련 정보
​
cvc string
​
vbv VBV
3DS 인증 결과를 담는 객체 (Verified by Visa)
​
card_installment_plan integer
카드 할부 개월 수
​
use_free_installment_plan boolean
무이자 할부 적용 여부
​
use_free_interest_from_mall boolean
​
​
virtual_account InstantVirtualAccountForm
가상계좌 발급을 위해 필요한 가상계좌 발급 관련 정보
InstantVirtualAccountForm
bank * Bank
은행
"BANK_OF_KOREA", "KOREA_DEVELOPMENT_BANK", "INDUSTRIAL_BANK_OF_KOREA", "KOOKMIN_BANK", "SUHYUP_BANK", "EXPORT_IMPORT_BANK_OF_KOREA", "NH_NONGHYUP_BANK", "LOCAL_NONGHYUP", "WOORI_BANK", "SC_BANK_KOREA", "CITI_BANK_KOREA", "DAEGU_BANK", "BUSAN_BANK", "GWANGJU_BANK", "JEJU_BANK", "JEONBUK_BANK", "KYONGNAM_BANK", "KFCC", "SHINHYUP", "SAVINGS_BANK_KOREA", "MORGAN_STANLEY_BANK", "HSBC_BANK", "DEUTSCHE_BANK", "JP_MORGAN_CHASE_BANK", "MIZUHO_BANK", "MUFG_BANK", "BANK_OF_AMERICA_BANK", "BNP_PARIBAS_BANK", "ICBC", "BANK_OF_CHINA", "NATIONAL_FORESTRY_COOPERATIVE_FEDERATION", "UNITED_OVERSEAS_BANK", "BANK_OF_COMMUNICATIONS", "CHINA_CONSTRUCTION_BANK", "EPOST", "KODIT", "KIBO", "HANA_BANK", "SHINHAN_BANK", "K_BANK", "KAKAO_BANK", "TOSS_BANK", "KCIS", "DAISHIN_SAVINGS_BANK", "SBI_SAVINGS_BANK", "HK_SAVINGS_BANK", "WELCOME_SAVINGS_BANK", "SHINHAN_SAVINGS_BANK", "KYOBO_SECURITIES", "DAISHIN_SECURITIES", "MERITZ_SECURITIES", "MIRAE_ASSET_SECURITIES", "BOOKOOK_SECURITIES", "SAMSUNG_SECURITIES", "SHINYOUNG_SECURITIES", "SHINHAN_FINANCIAL_INVESTMENT", "YUANTA_SECURITIES", "EUGENE_INVESTMENT_SECURITIES", "KAKAO_PAY_SECURITIES", "TOSS_SECURITIES", "KOREA_FOSS_SECURITIES", "HANA_FINANCIAL_INVESTMENT", "HI_INVESTMENT_SECURITIES", "KOREA_INVESTMENT_SECURITIES", "HANWHA_INVESTMENT_SECURITIES", "HYUNDAI_MOTOR_SECURITIES", "DB_FINANCIAL_INVESTMENT", "KB_SECURITIES", "KTB_INVESTMENT_SECURITIES", "NH_INVESTMENT_SECURITIES", "SK_SECURITIES"
​
account_expiry * object
valid_hours와 due_date 둘 중 하나의 값만 채워야 함
​
account_type * virtual_account_type_VirtualAccountType
가상계좌 유형(일반 or 고정)
"NORMAL", "FIXED"
​
pg_account_id string
고정식 가상계좌 방식에서, 가맹점이 가상계좌 번호를 관리하지 않고 PG사가 pg_account_id에 매핑되는 가상계좌 번호를 내려줄 때 사용하는 필드입니다. 동일한 pg_account_id로 가상계좌 발급 요청시에는 항상 같은 가상계좌 번호가 내려옵니다. account_type이 FIXED일 때만 유효하며, account_number 필드와 함께 사용할 수 없습니다.
​
account_number string
고정식 가상계좌 방식에서, PG사로부터 일정 갯수의 가상계좌 번호를 미리 전달받았을 때 사용하는 필드입니다. 가맹점으로부터 전달받은 가상계좌 번호를 직접 입력하면 됩니다. account_type이 FIXED일 때만 유효하며, pg_account_id 필드와 함께 사용할 수 없습니다.
​
cash_receipt_form object
현금영수증 발급을 위해 필요한 정보
​
​
bank * Bank
은행
"BANK_OF_KOREA", "KOREA_DEVELOPMENT_BANK", "INDUSTRIAL_BANK_OF_KOREA", "KOOKMIN_BANK", "SUHYUP_BANK", "EXPORT_IMPORT_BANK_OF_KOREA", "NH_NONGHYUP_BANK", "LOCAL_NONGHYUP", "WOORI_BANK", "SC_BANK_KOREA", "CITI_BANK_KOREA", "DAEGU_BANK", "BUSAN_BANK", "GWANGJU_BANK", "JEJU_BANK", "JEONBUK_BANK", "KYONGNAM_BANK", "KFCC", "SHINHYUP", "SAVINGS_BANK_KOREA", "MORGAN_STANLEY_BANK", "HSBC_BANK", "DEUTSCHE_BANK", "JP_MORGAN_CHASE_BANK", "MIZUHO_BANK", "MUFG_BANK", "BANK_OF_AMERICA_BANK", "BNP_PARIBAS_BANK", "ICBC", "BANK_OF_CHINA", "NATIONAL_FORESTRY_COOPERATIVE_FEDERATION", "UNITED_OVERSEAS_BANK", "BANK_OF_COMMUNICATIONS", "CHINA_CONSTRUCTION_BANK", "EPOST", "KODIT", "KIBO", "HANA_BANK", "SHINHAN_BANK", "K_BANK", "KAKAO_BANK", "TOSS_BANK", "KCIS", "DAISHIN_SAVINGS_BANK", "SBI_SAVINGS_BANK", "HK_SAVINGS_BANK", "WELCOME_SAVINGS_BANK", "SHINHAN_SAVINGS_BANK", "KYOBO_SECURITIES", "DAISHIN_SECURITIES", "MERITZ_SECURITIES", "MIRAE_ASSET_SECURITIES", "BOOKOOK_SECURITIES", "SAMSUNG_SECURITIES", "SHINYOUNG_SECURITIES", "SHINHAN_FINANCIAL_INVESTMENT", "YUANTA_SECURITIES", "EUGENE_INVESTMENT_SECURITIES", "KAKAO_PAY_SECURITIES", "TOSS_SECURITIES", "KOREA_FOSS_SECURITIES", "HANA_FINANCIAL_INVESTMENT", "HI_INVESTMENT_SECURITIES", "KOREA_INVESTMENT_SECURITIES", "HANWHA_INVESTMENT_SECURITIES", "HYUNDAI_MOTOR_SECURITIES", "DB_FINANCIAL_INVESTMENT", "KB_SECURITIES", "KTB_INVESTMENT_SECURITIES", "NH_INVESTMENT_SECURITIES", "SK_SECURITIES"
​
account_expiry * object
valid_hours와 due_date 둘 중 하나의 값만 채워야 함
account_expiry
valid_hours integer
​
due_date string
​
​
account_type * virtual_account_type_VirtualAccountType
가상계좌 유형(일반 or 고정)
"NORMAL", "FIXED"
​
pg_account_id string
고정식 가상계좌 방식에서, 가맹점이 가상계좌 번호를 관리하지 않고 PG사가 pg_account_id에 매핑되는 가상계좌 번호를 내려줄 때 사용하는 필드입니다. 동일한 pg_account_id로 가상계좌 발급 요청시에는 항상 같은 가상계좌 번호가 내려옵니다. account_type이 FIXED일 때만 유효하며, account_number 필드와 함께 사용할 수 없습니다.
​
account_number string
고정식 가상계좌 방식에서, PG사로부터 일정 갯수의 가상계좌 번호를 미리 전달받았을 때 사용하는 필드입니다. 가맹점으로부터 전달받은 가상계좌 번호를 직접 입력하면 됩니다. account_type이 FIXED일 때만 유효하며, pg_account_id 필드와 함께 사용할 수 없습니다.
​
cash_receipt_form object
현금영수증 발급을 위해 필요한 정보
cash_receipt_form
receipt_type * cash_receipt_type_CashReceiptType
현금영수증 용도. personal = 소득공제용, corporate = 지출증빙용, anonymous = 국세청번호 자동발급 케이스
"PERSONAL", "CORPORATE", "ANONYMOUS"
​
registration_number * string
현금영수증 신청 번호
​
business_number * string
현금영수증을 발급할 사업자등록번호
​
​
id * string
​
name * string
​
tag string
​
code string
​
unit_price * integer
​
quantity * integer
​
ProductType
VBV
virtual_account_type_VirtualAccountType
상품 유형
"REAL", "DIGITAL"
cavv * string
​
xid * string
​
eci * string
​
가상계좌 유형(일반 or 고정)
"NORMAL", "FIXED"
⌨ 에스크로 배송정보 등록/변경
post
https://api.portone.io/v2
/payments/{payment_id}/escrow/logis
에스크로 배송정보 등록/변경
EscrowReceiver
EscrowSender
LogisticsForm
name string
​
phone_number string
​
address string
​
post_code string
​
name string
​
phone_number string
​
address string
​
post_code string
​
relationship string
​
company * string
"HYUNDAI", "HANARO", "SAGAWA", "KGB", "YELLOWCAP", "DONGBU", "EPOST", "CJGLS", "HANJIN", "DAESIN", "ETC", "ILYANG", "KYONGDONG", "CHUNIL"
​
invoice_number * string
​
sent_at * string
​
received_at string
​
address string
​
API (V2 beta) - Previous
인증 관련 API
Next - API (V2 beta)
현금영수증 관련 API
Last modified 2d ago