Skip to main content
Et tilbud prissættes én gang, kan forbruges af én betaling og udløber. Brug Payment Quotes API’et til at vise en køber totalbeløb, moms og valuta, før de betaler, og send derefter tilbuddets id som quote_id, når du opretter betalingen, for at opkræve præcis det tilbud. Opret et nyt tilbud, hver gang kurven, rabatkoden eller adressen ændres.

Endpoints

Attributter

string
påkrævet
Betalingstilbuds-ID med præfikset pq_.
string
påkrævet
Den konto, købet prissættes for, med præfikset biz_.
object | null
påkrævet
Den faktureringsadresse, købet blev prissat med, eller null. Det sted, hvor momsen blev beregnet, når der ikke blev angivet en leveringsadresse, og den adresse, registreringen tilhører.

Egenskaber

string | null
påkrævet
Byen.
string | null
påkrævet
ISO 3166-1 alpha-2-landekoden.
string | null
påkrævet
Den første adresselinje.
string | null
påkrævet
Den anden adresselinje.
string | null
påkrævet
Navnet på adressen.
string | null
påkrævet
Postnummeret eller ZIP-koden.
string | null
påkrævet
Staten, provinsen eller regionen.
string
påkrævet
Trebogstavs ISO 4217-kode for varianternes egen valuta med små bogstaver. Lig med currency, når intet blev konverteret.
object
påkrævet
total i base_currency ved exchange_rate: varianternes egne priser efter rabatkoden plus tax_amount konverteret ved exchange_rate, når momsen lægges oveni. Lig med total, når intet blev konverteret. Betalingen opkræver total i currency.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
string
påkrævet
Hvornår tilbuddet blev prissat, som et ISO 8601-tidsstempel.
string
påkrævet
Trebogstavs ISO 4217-valutakode, som købet prissættes og opkræves i, med små bogstaver: varianternes egen valuta eller den presentment_currency, den blev konverteret til.
object
påkrævet
Hvad rabatkoden trækker fra. Nul uden en kode.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
string | null
påkrævet
Hvor mange enheder af currency én enhed af base_currency køber, som en decimalstreng såsom "5.4321": den kurs, varianternes priser blev konverteret til, fastlåst indtil expires_at, og den kurs, en betaling, der forbruger tilbuddet, opkræves til. En streng, ligesom pengebeløb, så ingen float afrunder den undervejs. Null, når intet blev konverteret.
string
påkrævet
Hvornår tilbuddet ikke længere kan opkræves, som et ISO 8601-tidsstempel. Opret et nyt tilbud derefter.
object[]
påkrævet
Én post pr. variant i den angivne rækkefølge, hver med sin egen moms.

Egenskaber

object
påkrævet
Rabatkodens andel på denne linje. Nul uden en kode.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
integer
påkrævet
Hvor mange enheder af varianten linjen dækker.
object
påkrævet
Linjens pris før rabatkodens andel og moms; subtotal minus discount er, hvad linjen beløber sig til efter rabatten. Linjernes subtotaler summeres til tilbuddets subtotal.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
object
påkrævet
Momsen på denne linje. Nul, når tax_status ikke er calculated.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
object
påkrævet
subtotal minus discount plus tax_amount, når momsen lægges oveni, eller uden den, når prisen allerede inkluderer den.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
string | null
påkrævet
Den variant, denne linje prissætter, med præfikset plan_. Null, når købet beskriver varianten via variant, og der endnu ikke findes nogen variant med de attributter: den betaling, der forbruger tilbuddet, opretter den, og linjen henviser til den derefter.
string | null
påkrævet
Hvilken placering momsen blev beregnet for: shipping_address, når den indeholder et land, ellers fakturerings-address, når den gør, ellers den sendte presentment_country, ellers køberens ip_address. Et tilbud lokaliseret via presentment_country eller ip_address er en forhåndsvisning, der anslår momsen: en betaling kan ikke bruge det, så opret et nyt tilbud med køberens adresse for at betale. Null, når intet i anmodningen lokaliserede køberen, hvilket kun en sælger, der ikke opkræver moms på dette køb, får tilbud uden; tax_status er så not_applicable.Tilgængelige muligheder: shipping_address, address, presentment_country, ip_address
string | null
påkrævet
Den betaling, der har dette tilbud, med præfikset pay_, eller null, mens det er ubrugt. En afvist betaling beholder sit tilbud og kan forsøges igen; tjek den betalings status.
string | null
påkrævet
Den rabatkode, tilbuddet anvendte, med præfikset promo_, eller null.
ISO 4217-koder med små bogstaver, der kan tilbydes køberen i en valutavælger, de mest relevante først: valutaen for den sendte presentment_country, ellers for det land, køberens ip_address befinder sig i, når dette køb kan konverteres til den, og en betalingsmetode kan opkræve den, og derefter base_currency. Opret et nyt tilbud med en af dem som presentment_currency for at prissætte i den. Kun base_currency, når tilbuddet blev prissat uden presentment_currency eller presentment_country.
object | null
påkrævet
Den leveringsadresse, købet blev prissat med, eller null. Når den er til stede, er det her, momsen blev beregnet.

Egenskaber

string | null
påkrævet
Byen.
string | null
påkrævet
ISO 3166-1 alpha-2-landekoden.
string | null
påkrævet
Den første adresselinje.
string | null
påkrævet
Den anden adresselinje.
string | null
påkrævet
Navnet på adressen.
string | null
påkrævet
Postnummeret eller ZIP-koden.
string | null
påkrævet
Staten, provinsen eller regionen.
object
påkrævet
Prisen for alle linjer før rabatkode, moms og gebyrer.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
object
påkrævet
Den moms, en betaling, der forbruger dette tilbud, opkræver. Nul, medmindre tax_status er calculated.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
string | null
påkrævet
Om momsen lægges oven i prisen (exclusive) eller allerede er inkluderet i den (inclusive). Null, når der ikke blev beregnet moms.Tilgængelige muligheder: inclusive, exclusive
object[]
påkrævet
Køberens momsregistrering, som tilbuddet prissatte som et erhvervskøb. Tom for et forbrugerkøb.

Egenskaber

string
påkrævet
Registreringens type, såsom eu_vat.Tilgængelige muligheder: 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
påkrævet
Registreringsnummeret, som køberen indtastede det, med mellemrum fjernet (eu_vat-værdier fjerner også punktummer og bindestreger).
string
påkrævet
calculated: hver linje blev prissat, og en betaling kan forbruge tilbuddet. not_applicable: denne sælger opkræver ikke moms på dette køb, så tilbuddet skylder ingen og kan stadig forbruges. unavailable: momsen kunne ikke prissættes — udbyderen svarede ikke, eller denne sælgers momsopsætning kan ikke prissætte et køb her — så en betaling afviser tilbuddet; opret et nyt tilbud, eller opkræv uden quote_id for at få momsen beregnet ved opkrævningen.Tilgængelige muligheder: calculated, not_applicable, unavailable
object
påkrævet
Hvad køberen betaler: subtotalen fratrukket rabatten plus tax_amount, når momsen lægges oveni.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen lokalitet ved hjælp af dette.
PaymentQuote