Skip to main content
견적은 한 번 가격이 산정되며, 하나의 결제에서만 사용할 수 있고, 만료됩니다. Payment Quotes API를 사용하여 구매자가 결제하기 전에 총액, 세금, 통화를 보여 준 다음, 결제를 생성할 때 견적의 id를 quote_id로 전달하여 해당 견적 그대로 청구하세요. 장바구니, 프로모션 코드 또는 주소가 변경될 때마다 다시 견적을 받으세요.

엔드포인트

속성

string
필수
결제 견적 ID로, 접두사는 pq_입니다.
string
필수
구매 가격이 산정된 계정으로, 접두사는 biz_입니다.
object | null
필수
구매 가격 산정에 사용된 청구 주소이며, 없으면 null입니다. 배송 주소가 제공되지 않은 경우 세금이 계산된 위치이며, 등록 정보가 속한 주소입니다.

속성

string | null
필수
도시입니다.
string | null
필수
ISO 3166-1 alpha-2 국가 코드입니다.
string | null
필수
첫 번째 도로명 주소 줄입니다.
string | null
필수
두 번째 도로명 주소 줄입니다.
string | null
필수
주소에 기재된 이름입니다.
string | null
필수
우편번호 또는 ZIP 코드입니다.
string | null
필수
주, 도 또는 지역입니다.
string
필수
변형 자체 통화의 소문자 세 글자 ISO 4217 코드입니다. 환전이 없는 경우 currency와 같습니다.
object
필수
exchange_rate로 환산한 base_currency 기준 total입니다. 프로모션 코드 적용 후 변형 자체 가격에, 세금이 별도로 추가되는 경우 exchange_rate로 환산한 tax_amount를 더한 값입니다. 환전이 없는 경우 total과 같습니다. 결제는 currency로 total을 청구합니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
견적 가격이 산정된 시점으로, ISO 8601 타임스탬프입니다.
string
필수
구매 가격이 산정되고 청구되는 소문자 세 글자 ISO 4217 통화 코드로, 변형 자체 통화이거나 환전된 presentment_currency입니다.
object
필수
프로모션 코드로 할인되는 금액입니다. 코드가 없으면 0입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
base_currency 1단위로 살 수 있는 currency의 단위 수로, "5.4321"과 같은 십진수 문자열입니다. 변형 가격이 환전된 환율로, expires_at까지 고정되며 견적을 사용하는 결제에 적용되는 환율입니다. 금액과 마찬가지로 전송 중 부동소수점 반올림이 발생하지 않도록 문자열입니다. 환전이 없는 경우 null입니다.
string
필수
견적으로 더 이상 청구할 수 없게 되는 시점으로, ISO 8601 타임스탬프입니다. 그 이후에는 다시 견적을 받으세요.
object[]
필수
변형당 하나의 항목으로, 지정된 순서대로 나열되며 각 항목에 자체 세금이 포함됩니다.

속성

object
필수
이 항목에 배분된 프로모션 코드 할인분입니다. 코드가 없으면 0입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
integer
필수
이 항목에 포함된 변형의 수량입니다.
object
필수
프로모션 코드 할인분과 세금 적용 전 항목 가격입니다. subtotal에서 discount를 뺀 값이 할인 후 항목 금액입니다. 항목들의 소계 합계는 견적의 subtotal과 같습니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
이 항목의 세금입니다. tax_status가 calculated가 아니면 0입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
subtotal에서 discount를 빼고, 세금이 별도로 추가되는 경우 tax_amount를 더한 값이며, 가격에 이미 세금이 포함된 경우에는 더하지 않습니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
이 항목이 가격을 산정하는 변형으로, 접두사는 plan_입니다. 구매에서 variant로 변형을 설명했지만 해당 속성을 가진 변형이 아직 없는 경우 null입니다. 이 경우 견적을 사용하는 결제가 변형을 생성하며, 그때부터 항목이 해당 변형을 가리킵니다.
string | null
필수
세금이 계산된 위치입니다. 국가가 포함된 경우 shipping_address, 그렇지 않고 청구 address에 국가가 포함된 경우 해당 주소, 그렇지 않으면 전송된 presentment_country, 그렇지 않으면 구매자의 ip_address입니다. presentment_country 또는 ip_address로 위치가 파악된 견적은 세금을 추정하는 미리보기입니다. 결제에 사용할 수 없으므로, 결제하려면 구매자의 주소로 다시 견적을 받으세요. 요청에서 구매자의 위치를 파악할 수 있는 정보가 없는 경우 null이며, 이는 이 구매에 세금을 징수하지 않는 판매자에게만 허용됩니다. 이때 tax_status는 not_applicable입니다.사용 가능한 옵션: shipping_address, address, presentment_country, ip_address
string | null
필수
이 견적을 보유한 결제로, 접두사는 pay_이며 사용되지 않은 동안에는 null입니다. 거절된 결제는 견적을 유지하며 재시도할 수 있으니, 해당 결제의 status를 확인하세요.
string | null
필수
견적에 적용된 프로모션 코드로, 접두사는 promo_이며 없으면 null입니다.
통화 선택기에서 구매자에게 제공할 소문자 ISO 4217 코드로, 관련성이 높은 순서로 정렬됩니다. 이 구매를 해당 통화로 환전할 수 있고 결제 수단이 해당 통화로 결제를 받을 수 있는 경우 전송된 presentment_country의 통화, 그렇지 않으면 구매자의 ip_address가 속한 국가의 통화가 먼저 오고, 그다음 base_currency가 옵니다. 해당 통화로 가격을 산정하려면 그중 하나를 presentment_currency로 지정하여 다시 견적을 받으세요. presentment_currency나 presentment_country 없이 견적을 산정한 경우 base_currency만 포함됩니다.
object | null
필수
구매 가격 산정에 사용된 배송 주소이며, 없으면 null입니다. 존재하는 경우 세금이 계산된 위치입니다.

속성

string | null
필수
도시입니다.
string | null
필수
ISO 3166-1 alpha-2 국가 코드입니다.
string | null
필수
첫 번째 도로명 주소 줄입니다.
string | null
필수
두 번째 도로명 주소 줄입니다.
string | null
필수
주소에 기재된 이름입니다.
string | null
필수
우편번호 또는 ZIP 코드입니다.
string | null
필수
주, 도 또는 지역입니다.
object
필수
프로모션 코드, 세금, 수수료 적용 전 모든 항목의 가격입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
이 견적을 사용하는 결제가 청구하는 세금입니다. tax_status가 calculated가 아니면 0입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
세금이 가격에 별도로 추가되는지(exclusive) 이미 포함되어 있는지(inclusive) 여부입니다. 세금이 계산되지 않은 경우 null입니다.사용 가능한 옵션: inclusive, exclusive
object[]
필수
견적이 비즈니스 구매로 가격을 산정한 구매자의 세금 등록 정보입니다. 소비자 구매의 경우 비어 있습니다.

속성

string
필수
eu_vat과 같은 등록 유형입니다.사용 가능한 옵션: ad_nrt, ao_tin, ar_cuit, al_tin, am_tin, aw_tin, au_abn, au_arn, eu_vat, az_tin, bs_tin, bh_vat, bd_bin, bb_tin, by_tin, bj_ifu, bo_tin, ba_tin, br_cnpj, br_cpf, bg_uic, bf_ifu, kh_tin, cm_niu, ca_bn, ca_gst_hst, ca_pst_bc, ca_pst_mb, ca_pst_sk, ca_qst, cv_nif, cl_tin, cn_tin, co_nit, cd_nif, cr_tin, hr_oib, do_rcn, ec_ruc, eg_tin, sv_nit, et_tin, eu_oss_vat, ge_vat, gh_tin, de_stn, gb_vat, gn_nif, hk_br, hu_tin, is_vat, in_gst, id_npwp, il_vat, jp_cn, jp_rn, jp_trn, kz_bin, ke_pin, kg_tin, la_tin, li_uid, li_vat, my_frp, my_itn, my_sst, mr_nif, mx_rfc, md_vat, me_pib, ma_vat, np_pan, nz_gst, ng_tin, mk_vat, no_vat, no_voec, om_vat, pe_ruc, ph_tin, pl_nip, ro_tin, ru_inn, ru_kpp, sa_vat, sn_ninea, rs_pib, sg_gst, sg_uen, si_tin, za_vat, kr_brn, es_cif, ch_uid, ch_vat, tw_vat, tj_tin, tz_vat, th_vat, tr_tin, ug_tin, ua_vat, ae_trn, us_ein, uy_ruc, uz_tin, uz_vat, ve_rif, vn_tin, zm_tin, zw_tin, sr_fin, xi_vat
string
필수
구매자가 입력한 등록 번호에서 공백을 제거한 값입니다(eu_vat 값은 점과 대시도 제거됩니다).
string
필수
calculated: 모든 항목의 가격이 산정되었으며 결제가 견적을 사용할 수 있습니다. not_applicable: 이 판매자는 이 구매에 세금을 징수하지 않으므로 견적에 부과되는 세금이 없으며 여전히 사용할 수 있습니다. unavailable: 세금을 산정할 수 없었습니다. 제공업체가 응답하지 않았거나 이 판매자의 세금 설정으로 이곳의 구매 가격을 산정할 수 없으므로 결제가 견적을 거부합니다. 다시 견적을 받거나, quote_id 없이 청구하여 청구 시점에 세금이 계산되도록 하세요.사용 가능한 옵션: calculated, not_applicable, unavailable
object
필수
구매자가 지불하는 금액으로, 소계에서 할인을 빼고 세금이 별도로 추가되는 경우 tax_amount를 더한 값입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
PaymentQuote