결제 관련 API
결제에 관련된 API 를 확인할 수 있습니다.
⌨ 결제내역 단건조회
결제내역 단건조회
GET https://api.portone.io/v2/payments/{payment_id}
결제가 발생한 이후 즉시 조회가 가능한 API입니다.
Path Parameters
payment_id*
string
결제 ID
Query Parameters
store_id
string
하위 상점 ID - 값을 넣지 않으면 Merchant 유저의 기본값으로 설정된 상점의 id가 입력됩니다.
payment * Payment
결제내역
type GiftCertificateType
"BOOKNLIFE", "SMART_MUNSANG", "CULTURELAND", "HAPPYMONEY"
approval_number * string
상품권 승인번호
id * string
포트원 채번 거래번호
is_primary * boolean
대표 트랜잭션 여부
version * Version
포트원 내부 결제시스템 버전
"V1", "V2"
method method_PaymentMethod
결제수단 목록
"CARD", "TRANSFER", "VIRTUAL_ACCOUNT", "MOBILE", "GIFT_CERTIFICATE", "EASY_PAY"
channel channel_Channel
결제 채널 정보
schedule_id string
예약결제 ID - 예약결제에만 해당됩니다.
billing_key string
결제를 발생시킨 빌링키 - 빌링키결제에만 해당됩니다.
notifications Array[notification_Notification]
웹훅 발송 내역
status_updated_at string
상태변경시각
updated_at * string
수정 시각
order_name * string
주문명
status * TransactionStatus
결제 건의 상태를 나타내는 enum string
"READY", "PENDING", "VIRTUAL_ACCOUNT_ISSUED", "PAID", "FAILED", "PARTIAL_CANCELLED", "CANCELLED"
amount * TransactionAmount
결제 금액 및 통화 관련 세부 정보
customer * Customer
구매자 정보
origin * Origin
결제를 요청한 근원에 대한 정보
is_cultural_expense boolean
문화비 지출 여부
is_escrow * boolean
에스크로 여부
escrow_detail EscrowDetail
에스크로 결제 정보
products Array[Product]
상품 정보 - 에스크로 결제 시 에스크로 상품 정보로 활용됩니다.
product_count integer
상품 갯수
custom_data string
가맹점의 결제 데이터 추가 정보
requested_at * string
결제요청시각
promotion_id string
포트원 프로모션 아이디
failure PaymentFailure
결제 실패 정보
failed_at string
결제실패시각 - status가 FAILED인 경우 제공됩니다.
country Country
국가 코드
"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"
paid_at string
결제완료시각 - status가 COMPLETED로 되었을 경우 제공됩니다.
payment_method_detail PaymentMethodDetail
결제 수단 정보
pg_tx_id string
PG사 거래ID - status가 COMPLETED로 되었을 경우 제공됩니다.
pg_response string
PG사 거래 응답 본문 - status가 COMPLETED로 되었을 경우 제공됩니다.
cash_receipt CashReceiptDetail
현금영수증 정보
cancellations Array[Cancellation]
취소내역 - status가 CANCELLED인 경우 제공됩니다.
cancelled_at string
결제취소시각 - status가 CANCELLED인 경우 제공됩니다.
⌨ 결제내역 다건조회
결제내역 다건조회
GET https://api.portone.io/v2/payments
결제내역들을 조회할 수 있는 API입니다. 실제 결제 발생 이후 조회되기까지 지연이 있으니 검증을 위해서는
를 이용해주세요. 현재 page * limit이 50000 이상이 되는 쿼리를 허용하지 않는 제약을 갖고있습니다. 많은 양의 데이터를 받아올 경우 날짜범위를 좁혀서 사용해주세요. 추후 50000개 이상 대량의 데이터를 한번에 편리하게 쿼리할 수 있도록 하는 수정이 예정되어있습니다.
Query Parameters
store_id
string
하위 상점 ID - Merchant 사용자만 사용가능하며, 지정되지 않은 경우 가맹점 전체 결제건을 조회합니다.
start
string
결제 상태 승인시각 범위의 시작 - 값을 넣지 않으면
end
의 90일 전으로 설정됩니다. (결제건의 최종 상태에 따라 다른 검색기준이 적용됩니다. 'ready' -> 결제시작 시각 기준, 'paid' -> 결제완료 시각 기준, 'cancelled' -> 결제취소 시각 기준, 'failed' -> 결제실패 시각 기준)
end
string
결제 상태 승인시각 범위의 끝 - 값을 넣지 않으면 현재 시각으로 설정됩니다. (결제건의 최종 상태에 따라 다른 검색기준이 적용됩니다. 'ready' -> 결제시작 시각 기준, 'paid' -> 결제완료 시각 기준, 'cancelled' -> 결제취소 시각 기준, 'failed' -> 결제실패 시각 기준)
status
array
결제상태 리스트 - 값을 넣지 않으면 결제상태 필터링이 적용되지 않습니다.
methods
array
결제수단 리스트 - 값을 넣지 않으면 결제수단 필터링이 적용되지 않습니다.
pg_providers
array
결제대행사 리스트 - 값을 넣지 않으면 결제대행사 필터링이 적용되지 않습니다.
is_test_payment
boolean
테스트결제 필터링
is_scheduled_payment
boolean
정기결제 필터링
text_search_column
string
통합검색 항목
text_search_value
string
통합검색 입력값
page
integer
페이지 - 0부터 시작합니다.
limit
integer
페이지 크기 (최대 1000까지 허용)
sort_by*
string
정렬 기준
REQUESTED_AT
: 결제요청시각
STATUS_UPDATED_AT
: 상태변경시각
sort_order*
string
정렬 방향
DESCENDING
: 내림차순
ASCENDING
: 오름차순
current_page * integer
total_page * integer
total_count * integer
payments * Array[Payment]
결제내역
type GiftCertificateType
"BOOKNLIFE", "SMART_MUNSANG", "CULTURELAND", "HAPPYMONEY"
approval_number * string
상품권 승인번호
id * string
포트원 채번 거래번호
is_primary * boolean
대표 트랜잭션 여부
version * Version
포트원 내부 결제시스템 버전
"V1", "V2"
method method_PaymentMethod
결제수단 목록
"CARD", "TRANSFER", "VIRTUAL_ACCOUNT", "MOBILE", "GIFT_CERTIFICATE", "EASY_PAY"
channel channel_Channel
결제 채널 정보
schedule_id string
예약결제 ID - 예약결제에만 해당됩니다.
billing_key string
결제를 발생시킨 빌링키 - 빌링키결제에만 해당됩니다.
notifications Array[notification_Notification]
웹훅 발송 내역
status_updated_at string
상태변경시각
updated_at * string
수정 시각
order_name * string
주문명
status * TransactionStatus
결제 건의 상태를 나타내는 enum string
"READY", "PENDING", "VIRTUAL_ACCOUNT_ISSUED", "PAID", "FAILED", "PARTIAL_CANCELLED", "CANCELLED"
amount * TransactionAmount
결제 금액 및 통화 관련 세부 정보
customer * Customer
구매자 정보
origin * Origin
결제를 요청한 근원에 대한 정보
is_cultural_expense boolean
문화비 지출 여부
is_escrow * boolean
에스크로 여부
escrow_detail EscrowDetail
에스크로 결제 정보
products Array[Product]
상품 정보 - 에스크로 결제 시 에스크로 상품 정보로 활용됩니다.
product_count integer
상품 갯수
custom_data string
가맹점의 결제 데이터 추가 정보
requested_at * string
결제요청시각
promotion_id string
포트원 프로모션 아이디
failure PaymentFailure
결제 실패 정보
failed_at string
결제실패시각 - status가 FAILED인 경우 제공됩니다.
country Country
국가 코드
"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"
paid_at string
결제완료시각 - status가 COMPLETED로 되었을 경우 제공됩니다.
payment_method_detail PaymentMethodDetail
결제 수단 정보
pg_tx_id string
PG사 거래ID - status가 COMPLETED로 되었을 경우 제공됩니다.
pg_response string
PG사 거래 응답 본문 - status가 COMPLETED로 되었을 경우 제공됩니다.
cash_receipt CashReceiptDetail
현금영수증 정보
cancellations Array[Cancellation]
취소내역 - status가 CANCELLED인 경우 제공됩니다.
cancelled_at string
결제취소시각 - status가 CANCELLED인 경우 제공됩니다.
⌨ 결제내역 대용량 다건조회
결제내역 대용량 다건조회
GET https://api.portone.io/v2/payments/scroll
Payment의 생성일시를 기준으로 모든 결제내역들을 조회할 수 있는 결제내역 대용량 다건조회 API입니다.
Query Parameters
store_id
string
하위 상점 ID - Merchant 사용자만 사용가능하며, 지정되지 않은 경우 가맹점 전체 결제건을 조회합니다.
start
string
Payment 생성시각 범위의 시작 - 값을 넣지 않으면
end
의 90일 전으로 설정됩니다.
end
string
Payment 생성시각 범위의 끝 - 값을 넣지 않으면 현재 시각으로 설정됩니다.
cursor
string
결제내역 리스트 중 어디서부터 읽어야 할지 가리키는 값입니다. 최초 요청일 경우 값을 입력하지 마시되, 두번째 요청 부터는 이전 요청 응답값의 cursor를 입력해주시면 됩니다.
limit
integer
페이지 크기 (최대 1000까지 허용)
payments * Array[Payment]
결제내역
cursor string
결제내역 리스트 중 어디까지 읽었는지를 나타냅니다.
type GiftCertificateType
"BOOKNLIFE", "SMART_MUNSANG", "CULTURELAND", "HAPPYMONEY"
approval_number * string
상품권 승인번호
id * string
포트원 채번 거래번호
is_primary * boolean
대표 트랜잭션 여부
version * Version
포트원 내부 결제시스템 버전
"V1", "V2"
method method_PaymentMethod
결제수단 목록
"CARD", "TRANSFER", "VIRTUAL_ACCOUNT", "MOBILE", "GIFT_CERTIFICATE", "EASY_PAY"
channel channel_Channel
결제 채널 정보
schedule_id string
예약결제 ID - 예약결제에만 해당됩니다.
billing_key string
결제를 발생시킨 빌링키 - 빌링키결제에만 해당됩니다.
notifications Array[notification_Notification]
웹훅 발송 내역
status_updated_at string
상태변경시각
updated_at * string
수정 시각
order_name * string
주문명
status * TransactionStatus
결제 건의 상태를 나타내는 enum string
"READY", "PENDING", "VIRTUAL_ACCOUNT_ISSUED", "PAID", "FAILED", "PARTIAL_CANCELLED", "CANCELLED"
amount * TransactionAmount
결제 금액 및 통화 관련 세부 정보
customer * Customer
구매자 정보
origin * Origin
결제를 요청한 근원에 대한 정보
is_cultural_expense boolean
문화비 지출 여부
is_escrow * boolean
에스크로 여부
escrow_detail EscrowDetail
에스크로 결제 정보
products Array[Product]
상품 정보 - 에스크로 결제 시 에스크로 상품 정보로 활용됩니다.
product_count integer
상품 갯수
custom_data string
가맹점의 결제 데이터 추가 정보
requested_at * string
결제요청시각
promotion_id string
포트원 프로모션 아이디
failure PaymentFailure
결제 실패 정보
failed_at string
결제실패시각 - status가 FAILED인 경우 제공됩니다.
country Country
국가 코드
"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"
paid_at string
결제완료시각 - status가 COMPLETED로 되었을 경우 제공됩니다.
payment_method_detail PaymentMethodDetail
결제 수단 정보
pg_tx_id string
PG사 거래ID - status가 COMPLETED로 되었을 경우 제공됩니다.
pg_response string
PG사 거래 응답 본문 - status가 COMPLETED로 되었을 경우 제공됩니다.
cash_receipt CashReceiptDetail
현금영수증 정보
cancellations Array[Cancellation]
취소내역 - status가 CANCELLED인 경우 제공됩니다.
cancelled_at string
결제취소시각 - status가 CANCELLED인 경우 제공됩니다.
⌨ 결제 취소
결제 취소
POST https://api.portone.io/v2/payments/{payment_id}/cancel
Path Parameters
payment_id*
string
결제 ID
Query Parameters
store_id
string
하위 상점 ID - 값을 넣지 않으면 Merchant 유저의 기본값으로 설정된 상점의 id가 입력됩니다.
Request Body
reason
string
취소 사유
cancel_amount
integer
취소 금액 - 값을 넣지 않으면 전액 취소됩니다.
tax_free_amount
integer
취소 금액 중 면세 금액 - 값을 넣지 않으면 전액 과세됩니다.
vat_amount
integer
취소 금액 중 부가세 금액 (PG사 기본값: null). 결제 시 부가세를 지정했던 경우 필수 입력 바랍니다. 지원되는 PG사: 나이스페이먼츠(NICE), 이니시스(HTML5_INICIS)
check_refundable_amount
integer
결제 건의 취소 가능 잔액 - 값을 넣지 않으면 별도의 검증 처리를 수행하지 않습니다.
refund
RefundAccount
환불 계좌 정보 - 가상계좌 결제인 경우에만 기입할 수 있습니다.
cancelled_tx_id * string
취소 대상 거래 아이디
cancellation_id * string
취소 아이디
payment * Payment
결제내역
type GiftCertificateType
"BOOKNLIFE", "SMART_MUNSANG", "CULTURELAND", "HAPPYMONEY"
approval_number * string
상품권 승인번호
id * string
포트원 채번 거래번호
is_primary * boolean
대표 트랜잭션 여부
version * Version
포트원 내부 결제시스템 버전
"V1", "V2"
method method_PaymentMethod
결제수단 목록
"CARD", "TRANSFER", "VIRTUAL_ACCOUNT", "MOBILE", "GIFT_CERTIFICATE", "EASY_PAY"
channel channel_Channel
결제 채널 정보
schedule_id string
예약결제 ID - 예약결제에만 해당됩니다.
billing_key string
결제를 발생시킨 빌링키 - 빌링키결제에만 해당됩니다.
notifications Array[notification_Notification]
웹훅 발송 내역
status_updated_at string
상태변경시각
updated_at * string
수정 시각
order_name * string
주문명
status * TransactionStatus
결제 건의 상태를 나타내는 enum string
"READY", "PENDING", "VIRTUAL_ACCOUNT_ISSUED", "PAID", "FAILED", "PARTIAL_CANCELLED", "CANCELLED"
amount * TransactionAmount
결제 금액 및 통화 관련 세부 정보
customer * Customer
구매자 정보
origin * Origin
결제를 요청한 근원에 대한 정보
is_cultural_expense boolean
문화비 지출 여부
is_escrow * boolean
에스크로 여부
escrow_detail EscrowDetail
에스크로 결제 정보
products Array[Product]
상품 정보 - 에스크로 결제 시 에스크로 상품 정보로 활용됩니다.
product_count integer
상품 갯수
custom_data string
가맹점의 결제 데이터 추가 정보
requested_at * string
결제요청시각
promotion_id string
포트원 프로모션 아이디
failure PaymentFailure
결제 실패 정보
failed_at string
결제실패시각 - status가 FAILED인 경우 제공됩니다.
country Country
국가 코드
"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"
paid_at string
결제완료시각 - status가 COMPLETED로 되었을 경우 제공됩니다.
payment_method_detail PaymentMethodDetail
결제 수단 정보
pg_tx_id string
PG사 거래ID - status가 COMPLETED로 되었을 경우 제공됩니다.
pg_response string
PG사 거래 응답 본문 - status가 COMPLETED로 되었을 경우 제공됩니다.
cash_receipt CashReceiptDetail
현금영수증 정보
cancellations Array[Cancellation]
취소내역 - status가 CANCELLED인 경우 제공됩니다.
cancelled_at string
결제취소시각 - status가 CANCELLED인 경우 제공됩니다.
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
모두 값을 넣지 않으면 대표 트랜잭션의 가장 최근 웹훅 발송 이력을 기준으로 재전송됩니다.
Path Parameters
payment_id*
string
결제 ID
Query Parameters
store_id
string
하위 상점 ID - 값을 넣지 않으면 Merchant 유저의 기본값으로 설정된 상점의 id가 입력됩니다.
Request Body
tx_id
string
재발송 대상 트랜잭션 아이디 - 값을 넣지 않으면 기본값은 대표 트랜잭션 아이디로 설정됩니다.
webhook_id
string
재발송 대상 웹훅 아이디 - 값을 넣지 않으면 기본값은 가장 최근의 웹훅 아이디로 설정됩니다.
tx_id * string
재발송 대상 트랜잭션 아이디
webhook_id string
재발송 대상 웹훅 아이디 (값을 넣지 않으면 가장 최근의 웹훅 아이디 기준으로 재전송) 비동기 웹훅이거나 웹훅 처리에 너무 오랜 시간이 걸리는 경우 값이 비어있을 수 있습니다.
payment * Payment
결제내역
type GiftCertificateType
"BOOKNLIFE", "SMART_MUNSANG", "CULTURELAND", "HAPPYMONEY"
approval_number * string
상품권 승인번호
id * string
포트원 채번 거래번호
is_primary * boolean
대표 트랜잭션 여부
version * Version
포트원 내부 결제시스템 버전
"V1", "V2"
method method_PaymentMethod
결제수단 목록
"CARD", "TRANSFER", "VIRTUAL_ACCOUNT", "MOBILE", "GIFT_CERTIFICATE", "EASY_PAY"
channel channel_Channel
결제 채널 정보
schedule_id string
예약결제 ID - 예약결제에만 해당됩니다.
billing_key string
결제를 발생시킨 빌링키 - 빌링키결제에만 해당됩니다.
notifications Array[notification_Notification]
웹훅 발송 내역
status_updated_at string
상태변경시각
updated_at * string
수정 시각
order_name * string
주문명
status * TransactionStatus
결제 건의 상태를 나타내는 enum string
"READY", "PENDING", "VIRTUAL_ACCOUNT_ISSUED", "PAID", "FAILED", "PARTIAL_CANCELLED", "CANCELLED"
amount * TransactionAmount
결제 금액 및 통화 관련 세부 정보
customer * Customer
구매자 정보
origin * Origin
결제를 요청한 근원에 대한 정보
is_cultural_expense boolean
문화비 지출 여부
is_escrow * boolean
에스크로 여부
escrow_detail EscrowDetail
에스크로 결제 정보
products Array[Product]
상품 정보 - 에스크로 결제 시 에스크로 상품 정보로 활용됩니다.
product_count integer
상품 갯수
custom_data string
가맹점의 결제 데이터 추가 정보
requested_at * string
결제요청시각
promotion_id string
포트원 프로모션 아이디
failure PaymentFailure
결제 실패 정보
failed_at string
결제실패시각 - status가 FAILED인 경우 제공됩니다.
country Country
국가 코드
"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"
paid_at string
결제완료시각 - status가 COMPLETED로 되었을 경우 제공됩니다.
payment_method_detail PaymentMethodDetail
결제 수단 정보
pg_tx_id string
PG사 거래ID - status가 COMPLETED로 되었을 경우 제공됩니다.
pg_response string
PG사 거래 응답 본문 - status가 COMPLETED로 되었을 경우 제공됩니다.
cash_receipt CashReceiptDetail
현금영수증 정보
cancellations Array[Cancellation]
취소내역 - status가 CANCELLED인 경우 제공됩니다.
cancelled_at string
결제취소시각 - status가 CANCELLED인 경우 제공됩니다.
⌨ 가상계좌 테스트 웹훅 호출
가상계좌 테스트 웹훅 호출
POST https://api.portone.io/v2/test-payments/{payment_id}/notice-virtual-account-deposit
가상계좌 테스트 결제 건에 대한 입금 통보 웹훅을 호출합니다.
Path Parameters
payment_id*
string
결제 ID
Query Parameters
store_id
string
하위 상점 ID - 값을 넣지 않으면 Merchant 유저의 기본값으로 설정된 상점의 id가 입력됩니다.
tx_id * string
웹훅 기준 트랜잭션 ID
webhook_id string
재발송 대상 웹훅 아이디 (값을 넣지 않으면 가장 최근의 웹훅 아이디 기준으로 재전송) 비동기 웹훅이거나 웹훅 처리에 너무 오랜 시간이 걸리는 경우 값이 비어있을 수 있습니다.
payment * Payment
결제내역
type GiftCertificateType
"BOOKNLIFE", "SMART_MUNSANG", "CULTURELAND", "HAPPYMONEY"
approval_number * string
상품권 승인번호
id * string
포트원 채번 거래번호
is_primary * boolean
대표 트랜잭션 여부
version * Version
포트원 내부 결제시스템 버전
"V1", "V2"
method method_PaymentMethod
결제수단 목록
"CARD", "TRANSFER", "VIRTUAL_ACCOUNT", "MOBILE", "GIFT_CERTIFICATE", "EASY_PAY"
channel channel_Channel
결제 채널 정보
schedule_id string
예약결제 ID - 예약결제에만 해당됩니다.
billing_key string
결제를 발생시킨 빌링키 - 빌링키결제에만 해당됩니다.
notifications Array[notification_Notification]
웹훅 발송 내역
status_updated_at string
상태변경시각
updated_at * string
수정 시각
order_name * string
주문명
status * TransactionStatus
결제 건의 상태를 나타내는 enum string
"READY", "PENDING", "VIRTUAL_ACCOUNT_ISSUED", "PAID", "FAILED", "PARTIAL_CANCELLED", "CANCELLED"
amount * TransactionAmount
결제 금액 및 통화 관련 세부 정보
customer * Customer
구매자 정보
origin * Origin
결제를 요청한 근원에 대한 정보
is_cultural_expense boolean
문화비 지출 여부
is_escrow * boolean
에스크로 여부
escrow_detail EscrowDetail
에스크로 결제 정보
products Array[Product]
상품 정보 - 에스크로 결제 시 에스크로 상품 정보로 활용됩니다.
product_count integer
상품 갯수
custom_data string
가맹점의 결제 데이터 추가 정보
requested_at * string
결제요청시각
promotion_id string
포트원 프로모션 아이디
failure PaymentFailure
결제 실패 정보
failed_at string
결제실패시각 - status가 FAILED인 경우 제공됩니다.
country Country
국가 코드
"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"
paid_at string
결제완료시각 - status가 COMPLETED로 되었을 경우 제공됩니다.
payment_method_detail PaymentMethodDetail
결제 수단 정보
pg_tx_id string
PG사 거래ID - status가 COMPLETED로 되었을 경우 제공됩니다.
pg_response string
PG사 거래 응답 본문 - status가 COMPLETED로 되었을 경우 제공됩니다.
cash_receipt CashReceiptDetail
현금영수증 정보
cancellations Array[Cancellation]
취소내역 - status가 CANCELLED인 경우 제공됩니다.
cancelled_at string
결제취소시각 - status가 CANCELLED인 경우 제공됩니다.
⌨ 결제 예약
결제 예약
POST https://api.portone.io/v2/schedules
Request Body
billing_key*
string
빌링키 결제에 사용할 빌링키
store_id
string
빌링키 결제를 진행하는 상점의 id
order_name*
string
주문명
is_cultural_expense
boolean
문화비 지출 여부 (기본값:
"false")
is_escrow
boolean
에스크로 여부 (기본값:
"false")
products
Array[Product]
상품 정보 (에스크로 결제 상품 정보)
customer
CustomerFormWithoutId
고객 정보
custom_data
string
가맹점에서 추가로 저장할 데이터
total_amount*
number
결제 금액
tax_free_amount
number
면세 금액 (기본값:
"0")
country
Country
국가
currency*
Currency
화폐
notice_urls
Array[string]
결제 승인/실패 시 요청을 받을 웹훅 주소입니다. 상점에 설정되어 있는 값보다 우선적으로 적용됩니다.
card_installment_plan
integer
할부 개월 수
use_free_interest_from_mall
boolean
무이자 할부 이자를 상점이 부담할지 여부
product_type
ProductType
상품 유형
product_count
integer
상품 개수
use_card_point
boolean
카드 포인트 사용 여부
bypass
string
각 PG사 별로 필요한 파라미터를 받습니다.
payment_id*
string
scheduled_at*
string
id * string
scheduled_at * string
address_line_1 * string
주소1
address_line_2 * string
주소2
city string
도시
province string
주, 도, 시
country Country
국가
"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"
full_name string
first_name string
last_name string
⌨ 빌링키 결제
빌링키 결제
POST https://api.portone.io/v2/payments/{payment_id}/billing-key/pay
Path Parameters
payment_id*
string
결제 ID
Request Body
billing_key*
string
빌링키 결제에 사용할 빌링키
store_id
string
빌링키 결제를 진행하는 상점의 id
order_name*
string
주문명
is_cultural_expense
boolean
문화비 지출 여부 (기본값:
"false")
is_escrow
boolean
에스크로 여부 (기본값:
"false")
products
Array[product_Product]
상품 정보 (에스크로 결제 상품 정보)
customer
CustomerFormWithoutId
고객 정보
custom_data
string
가맹점에서 추가로 저장할 데이터
total_amount*
number
결제 금액
tax_free_amount
number
면세 금액 (기본값:
"0")
country
country_Country
국가
currency*
currency_Currency
화폐
notice_urls
Array[string]
결제 승인/실패 시 요청을 받을 웹훅 주소입니다. 상점에 설정되어 있는 값보다 우선적으로 적용됩니다.
card_installment_plan
integer
할부 개월 수
use_free_interest_from_mall
boolean
무이자 할부 이자를 상점이 부담할지 여부
product_type
ProductType
상품 유형
product_count
integer
상품 개수
use_card_point
boolean
카드 포인트 사용 여부
bypass
string
각 PG사 별로 필요한 파라미터를 받습니다.
tx_id * string
customer_id * string
requested_at * string
paid_at * string
pg_tx_id * string
PG사 거래ID
address_line_1 * string
주소1
address_line_2 * string
주소2
city string
도시
province string
주, 도, 시
country country_Country
국가
"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"
full_name string
first_name string
last_name string
⌨ 키인(수기) 결제
키인(수기) 결제
POST https://api.portone.io/v2/payments/{payment_id}/instant/pay
Path Parameters
payment_id*
string
Request Body
store_id
string
하위 상점 ID
order_name*
string
is_cultural_expense
boolean
문화비 지출 여부 (기본값:
"false")
is_escrow
boolean
에스크로 여부 (기본값:
"false")
products
Array[product_Product]
상품 정보. 아래 두 가지 목적으로 사용함.
customer
CustomerForm
고객 정보
custom_data
string
total_amount*
number
결제 금액
tax_free_amount
number
면세 금액 (기본값:
"0")
country
country_Country
국가
currency*
currency_Currency
화폐
notice_urls
Array[string]
결제 승인/실패 시 요청을 받을 웹훅 주소입니다. 상점에 설정되어 있는 값보다 우선적으로 적용됩니다.
channel_name*
string
결제 채널 이름
product_type
ProductType
상품 유형
product_count
integer
상품 개수
payment_method_option*
InstantPaymentMethodForm
가능한 결제 수단: 카드, 가상계좌 선택한 결제 수단에 따라
card
와
virtual_account
중 하나에만 값이 들어있어야 합니다.
tx_id * string
customer_id * string
requested_at * string
paid_at * string
pg_tx_id * string
PG사 거래ID
address_line_1 * string
주소1
address_line_2 * string
주소2
city string
도시
province string
주, 도, 시
country country_Country
국가
"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"
국가
"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"
성별
"MALE", "FEMALE", "OTHER"
id * string
name * string
tag string
code string
quantity * integer
amount * number
currency * currency_Currency
화폐
"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"
⌨ 에스크로 배송정보 등록/변경
에스크로 배송정보 등록/변경
POST https://api.portone.io/v2/payments/{payment_id}/escrow/logis
Path Parameters
payment_id*
string
결제 ID
Request Body
store_id
string
sender*
EscrowSender
receiver*
EscrowReceiver
logistics_form*
LogisticsForm
company * string
invoice_number * string
sent_at * string
applied_at * string
address_line_1 * string
주소1
address_line_2 * string
주소2
city string
도시
province string
주, 도, 시
country country_Country
국가
"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"
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 Address
주소 형식
⌨ 에스크로 구매완료
에스크로 구매완료
POST https://api.portone.io/v2/payments/{payment_id}/escrow/complete
Path Parameters
payment_id*
string
결제 ID
Request Body
store_id
string
from_store
boolean
completed_at * string
Last updated
Was this helpful?