How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

PortOne Billing Keys API

The Billing Keys API from PortOne — 4 operation(s) for billing keys.

PortOne Billing Keys API is one of 20 APIs that PortOne publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Billing Keys. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 6 operations across 4 paths, and defines 85 schemas. It is described by OpenAPI 3.2.0, at version 1.16.0.

Requests are made against a single base URL, https://api.portone.io.

6 operations 4 paths 85 schemas 1 DELETE2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.16.0
Base URL
https://api.portone.io
Authentication
HTTP Bearer, HTTP Portone
Resource Areas
1

Authentication & Security 2

PortOne Billing Keys API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerJwt). It uses HTTP portone authentication (portOne).

  • bearerJwt — Authorization: Bearer 엑세스 토큰
  • portOne — Authorization: PortOne 발급된 API 시크릿

Paths & Operations 6

Across 4 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Billing Keys 6
GET
/billing-keys
빌링키 다건 조회
getBillingKeyInfos 1 param → 200400401403
POST
/billing-keys
빌링키 발급
issueBillingKey body → 200400401403404502
POST
/billing-keys/confirm
빌링키 발급 수동 승인
confirmBillingKey body → 200400401403404409502
POST
/billing-keys/confirm-issue-and-pay
빌링키 발급 및 초회 결제 수동 승인
confirmBillingKeyIssueAndPay body → 200400401403404409502
GET
/billing-keys/{billingKey}
빌링키 단건 조회
getBillingKeyInfo 2 params → 200400401403404
DELETE
/billing-keys/{billingKey}
빌링키 삭제
deleteBillingKey 5 params → 200400401403404409502

Schemas 85

The contract defines 85 schemas that model the data the API accepts and returns. The most detailed are DeletedBillingKeyInfo (15 properties), IssuedBillingKeyInfo (14 properties), BillingKeyFilterInput (13 properties), CustomerInput (12 properties). Each schema is shown below with its type and property counts.

PageInput
object
다건 조회 API 에 사용되는 페이지 입력 정보
2 properties
ConfirmedBillingKeySummary
object
빌링키 발급 수동 승인 완료 응답
1 property 1 required
Bank
string
은행
CustomerSeparatedName
object
고객 분리형 이름
2 properties 2 required
PgBillingKeyIssueResponse
채널 별 빌링키 발급 응답
ConfirmBillingKeyIssueAndPayBody
object
빌링키 발급 및 초회 결제 승인 입력 정보
8 properties 1 required
ConfirmBillingKeyBody
object
빌링키 발급 승인 입력 정보
4 properties 1 required
PortOneVersion
string
포트원 버전
BillingKeyAlreadyDeletedError
object
빌링키가 이미 삭제된 경우
2 properties 1 required
BillingKeyPaymentMethodMobile
object
모바일 정보
2 properties 1 required
BillingKeySortInput
object
빌링키 다건 조회 시 정렬 조건
2 properties
BillingKeyInfo
빌링키 정보
BillingKeyPaymentMethodCard
object
카드 정보
2 properties 1 required
CustomerNameInput
object
고객 이름 입력 정보 두 개의 이름 형식 중 한 가지만 선택하여 입력해주세요.
2 properties
BillingKeyTimeRangeField
string
빌링키 다건 조회 시, 시각 범위를 적용할 필드
BillingKeyNotFoundError
object
빌링키가 존재하지 않는 경우
2 properties 1 required
BillingKeyPaymentMethodType
string
빌링키 결제 수단
BillingKeyStatus
string
빌링키 상태
BillingKeyPaymentMethodPaypal
object
페이팔 정보
1 property 1 required
Currency
string
통화
UnauthorizedError
object
인증 정보가 올바르지 않은 경우
2 properties 1 required
BillingKeyNotIssuedError
object
2 properties 1 required
GetBillingKeyInfoError
BillingKeyInfoSummary
object
3 properties 2 required
InvalidRequestError
object
요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
2 properties 1 required
IssueBillingKeyResponse
object
빌링키 발급 성공 응답
2 properties 1 required
BillingKeyFilterInput
object
빌링키 다건 조회를 위한 입력 정보
13 properties
ConfirmBillingKeyIssueAndPayError
BillingKeyTextSearch
object
통합검색 입력 정보
2 properties 2 required
BillingKeySortBy
string
빌링키 정렬 기준
PageInfo
object
반환된 페이지 결과 정보
3 properties 3 required
Gender
string
성별
PgProviderError
object
PG사에서 오류를 전달한 경우
4 properties 3 required
BillingKeyPaymentMethodTransfer
object
계좌이체 정보
3 properties 1 required
ChannelSpecificFailureInvalidRequest
object
요청된 입력 정보가 유효하지 않은 경우 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
3 properties 2 required
Address
분리 형식 주소 oneLine(한 줄 형식 주소) 필드는 항상 존재합니다.
ChannelSpecificFailure
BillingKeyFailure
object
발급 실패 상세 정보
4 properties 1 required
InstantBillingKeyPaymentMethodInput
object
빌링키 발급 시 결제 수단 입력 양식 card를 반드시 입력해 주세요.
1 property
BillingKeyPaymentMethodEasyPay
object
간편 결제 정보
3 properties 1 required
GetBillingKeyInfosResponse
object
빌링키 다건 조회 성공 응답 정보
2 properties 2 required
InstantBillingKeyPaymentMethodInputCard
object
카드 수단 정보 입력 양식
1 property 1 required
CardCredential
object
카드 인증 관련 정보
5 properties 3 required
InformationMismatchError
object
정보가 일치하지 않는 경우
2 properties 1 required
SeparatedAddress
object
분리 형식 주소 한 줄 형식 주소와 분리 형식 주소 모두 존재합니다. 한 줄 형식 주소는 분리 형식 주소를 이어 붙인 형태로 생성됩니다.
7 properties 4 required
DeleteBillingKeyResponse
object
빌링키 삭제 성공 응답
1 property 1 required
Customer
object
고객 정보
10 properties
BillingKeyPaymentMethodEasyPayMethod
간편 결제 수단
CustomerInput
object
고객 정보 입력 정보
12 properties
PaymentScheduleAlreadyExistsError
object
결제 예약건이 이미 존재하는 경우
2 properties 1 required
CardType
string
카드 유형
BillingKeyPaymentMethodEasyPayCharge
object
충전식 포인트 결제 정보
1 property 1 required
GetBillingKeyInfosError
Card
object
카드 상세 정보
8 properties
OneLineAddress
object
한 줄 형식 주소 한 줄 형식 주소만 존재합니다.
2 properties 2 required
IssuedBillingKeyInfo
object
빌링키 발급 완료 상태 건
14 properties 7 required
Country
string
국가
SelectedChannelType
string
채널 타입
CardOwnerType
string
카드 소유주 유형
DeletedBillingKeyInfo
object
빌링키 삭제 완료 상태 건
15 properties 8 required
IssueBillingKeyError
ChannelSpecificFailurePgProvider
object
PG사에서 오류를 전달한 경우
5 properties 4 required
ChannelGroupSummary
object
채널 그룹 정보
3 properties 3 required
ConfirmBillingKeyError
DeleteBillingKeyError
ChannelSpecificError
object
여러 채널을 지정한 요청에서, 채널 각각에서 오류가 발생한 경우
4 properties 3 required
EasyPayProvider
string
간편 결제사
PgProvider
string
PG사 결제 모듈
IssuedPgBillingKeyIssueResponse
object
빌링키 발급 성공 채널 응답
4 properties 2 required
PgCompany
string
PG사
SeparatedAddressInput
object
분리 형식 주소 입력 정보
5 properties 2 required
ConfirmedBillingKeyIssueAndPaySummary
object
빌링키 발급 및 초회 결제 수동 승인 완료 응답
2 properties 2 required
SelectedChannel
object
(결제, 본인인증 등에) 선택된 채널 정보
6 properties 3 required
ForbiddenError
object
요청이 거절된 경우
2 properties 1 required
ChannelNotFoundError
object
요청된 채널이 존재하지 않는 경우
2 properties 1 required
BillingKeyDeleteRequester
string
빌링키 삭제 요청 주체
SortOrder
string
정렬 방식
FailedPgBillingKeyIssueResponse
object
빌링키 발급 실패 채널 응답
3 properties 3 required
BillingKeyTextSearchField
string
통합검색 항목
GetBillingKeyInfosBody
object
빌링키 다건 조회를 위한 입력 정보
3 properties
BillingKeyPaymentMethod
빌링키 발급 수단 정보
CardBrand
string
카드 브랜드
IssueBillingKeyBody
object
빌링키 발급 요청 양식
9 properties 1 required
PaymentClientType
string
결제가 발생한 클라이언트 환경
BillingKeyAlreadyIssuedError
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

portone-billing-keys-api-openapi.yml Raw ↑

Other APIs PortOne publishes across the network.

PortOne REST API (V1, legacy Iamport)
PortOne B2b API
PortOne Banks API
PortOne Cash Receipts API
PortOne Checkout Profiles API
PortOne Identity Verifications API
PortOne Kakaopay API
PortOne Login API
PortOne Payment Events By Cursor API
PortOne Payment Gateways API
PortOne Payment Reconciliations API
PortOne Payment Schedules API
Where this information came from

This is an independent, third-party profile of PortOne Billing Keys API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.