결제 관련 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"
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이 채워져 있어야 함
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이 채워져 있어야 함
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카드를 이용한 결제 및 빌링키 발급에 필요한 인증 관련 정보
cvc
string
vbv
VBV3DS 인증 결과를 담는 객체 (Verified by Visa)
card_installment_plan
integer카드 할부 개월 수
use_free_installment_plan
boolean무이자 할부 적용 여부
use_free_interest_from_mall
boolean
card
InstantCardForm카드를 이용한 결제 & 빌링키 발급 시에 필요한 카드 관련 정보
virtual_account
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
* objectvalid_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
* objectvalid_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현금영수증 발급을 위해 필요한 정보
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
Last modified 2d ago