Skip to main content
Bir teklif bir kez fiyatlandırılır, bir ödeme tarafından kullanılabilir ve süresi dolar. Bir alıcıya ödeme yapmadan önce toplamı, vergiyi ve para birimini göstermek için Payment Quotes API’yi kullanın, ardından tam olarak o teklifi tahsil etmek için ödemeyi oluştururken teklifin id değerini quote_id olarak iletin. Sepet, promosyon kodu veya adres her değiştiğinde yeniden teklif alın.

Uç noktalar

Özellikler

string
gerekli
pq_ önekli ödeme teklifi kimliği.
string
gerekli
Satın alımın fiyatlandırıldığı biz_ önekli hesap.
object | null
gerekli
Satın alımın fiyatlandırıldığı fatura adresi veya null. Gönderim adresi verilmediğinde verginin hesaplandığı yer ve kaydın ait olduğu adres.

Özellikler

string | null
gerekli
Şehir.
string | null
gerekli
ISO 3166-1 alpha-2 ülke kodu.
string | null
gerekli
Birinci sokak adresi satırı.
string | null
gerekli
İkinci sokak adresi satırı.
string | null
gerekli
Adresteki ad.
string | null
gerekli
Posta kodu.
string | null
gerekli
Eyalet, il veya bölge.
string
gerekli
Varyantların kendi para biriminin küçük harfli, üç harfli ISO 4217 kodu. Hiçbir şey dönüştürülmediğinde currency değerine eşittir.
object
gerekli
exchange_rate oranında base_currency cinsinden total: varyantların promosyon kodundan sonraki kendi fiyatları, artı vergi üste eklendiğinde exchange_rate oranında dönüştürülmüş tax_amount. Hiçbir şey dönüştürülmediğinde total değerine eşittir. Ödeme, currency cinsinden total tutarını tahsil eder.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
string
gerekli
Küçük harfli, üç harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
string
gerekli
Teklifin fiyatlandırıldığı zaman, ISO 8601 zaman damgası olarak.
string
gerekli
Satın alımın fiyatlandırıldığı ve tahsil edildiği küçük harfli, üç harfli ISO 4217 para birimi kodu: varyantların kendi para birimi veya dönüştürüldüğü presentment_currency.
object
gerekli
Promosyon kodunun düştüğü tutar. Kod yoksa sıfır.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
string
gerekli
Küçük harfli, üç harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
string | null
gerekli
Bir birim base_currency ile kaç birim currency alındığı, "5.4321" gibi bir ondalık dize olarak: varyantların fiyatlarının dönüştürüldüğü, expires_at zamanına kadar sabit kalan ve teklifi kullanan bir ödemenin tahsil edildiği oran. Para tutarları gibi bir dizedir, böylece aktarım sırasında hiçbir kayan nokta sayısı onu yuvarlamaz. Hiçbir şey dönüştürülmediğinde null.
string
gerekli
Teklifin tahsil edilebilir olmaktan çıktığı zaman, ISO 8601 zaman damgası olarak. Bundan sonra yeniden teklif alın.
object[]
gerekli
Verilen sırayla, her biri kendi vergisini taşıyan, varyant başına bir giriş.

Özellikler

object
gerekli
Promosyon kodunun bu satırdaki payı. Kod yoksa sıfır.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
string
gerekli
Küçük harfli, üç harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
integer
gerekli
Satırın kapsadığı varyant birimi sayısı.
object
gerekli
Satırın promosyon kodu payından ve vergiden önceki fiyatı; subtotal eksi discount, satırın indirimden sonraki tutarıdır. Satırların ara toplamları, teklifin subtotal değerine eşittir.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
string
gerekli
Küçük harfli, üç harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
object
gerekli
Bu satırdaki vergi. tax_status değeri calculated olmadığında sıfır.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
string
gerekli
Küçük harfli, üç harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
object
gerekli
subtotal eksi discount, vergi üste eklendiğinde artı tax_amount veya fiyat vergiyi zaten içerdiğinde vergisiz.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
string
gerekli
Küçük harfli, üç harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
string | null
gerekli
Bu satırın fiyatlandırdığı plan_ önekli varyant. Satın alım varyantı variant ile tanımladığında ve bu özelliklere sahip bir varyant henüz mevcut olmadığında null: teklifi kullanan ödeme onu oluşturur ve satır o andan itibaren onu adlandırır.
string | null
gerekli
Verginin hangi konum için hesaplandığı: bir ülke taşıdığında shipping_address, aksi halde taşıdığında fatura address değeri, aksi halde gönderilen presentment_country, aksi halde alıcının ip_address değeri. presentment_country veya ip_address ile konumu belirlenen bir teklif, vergiyi tahmin eden bir önizlemedir: bir ödeme onu kullanamaz, bu nedenle ödeme yapmak için alıcının adresiyle yeniden teklif alın. İstekteki hiçbir şey alıcının konumunu belirlemediğinde null; bu yalnızca bu satın alımda vergi toplamayan bir satıcı için mümkündür; bu durumda tax_status değeri not_applicable olur.Kullanılabilir seçenekler: shipping_address, address, presentment_country, ip_address
string | null
gerekli
Bu teklifi tutan pay_ önekli ödeme veya kullanılmadığı sürece null. Reddedilen bir ödeme teklifini korur ve yeniden denenebilir; o ödemenin status değerini kontrol edin.
string | null
gerekli
Teklifin uyguladığı promo_ önekli promosyon kodu veya null.
Alıcıya bir para birimi seçicide sunulacak, en alakalıdan başlayarak küçük harfli ISO 4217 kodları: bu satın alım ona dönüştürülebildiğinde ve bir ödeme yöntemi onu tahsil edebildiğinde, gönderilen presentment_country ülkesinin, aksi halde alıcının ip_address adresinin bulunduğu ülkenin para birimi, ardından base_currency. O para biriminde fiyatlandırmak için birini presentment_currency olarak kullanarak yeniden teklif alın. Teklif presentment_currency veya presentment_country olmadan fiyatlandırıldığında yalnızca base_currency.
object | null
gerekli
Satın alımın fiyatlandırıldığı gönderim adresi veya null. Bulunduğunda verginin hesaplandığı yerdir.

Özellikler

string | null
gerekli
Şehir.
string | null
gerekli
ISO 3166-1 alpha-2 ülke kodu.
string | null
gerekli
Birinci sokak adresi satırı.
string | null
gerekli
İkinci sokak adresi satırı.
string | null
gerekli
Adresteki ad.
string | null
gerekli
Posta kodu.
string | null
gerekli
Eyalet, il veya bölge.
object
gerekli
Promosyon kodu, vergi ve ücretlerden önce tüm satırların fiyatı.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
string
gerekli
Küçük harfli, üç harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
object
gerekli
Bu teklifi kullanan bir ödemenin tahsil ettiği vergi. tax_status değeri calculated olmadıkça sıfır.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
string
gerekli
Küçük harfli, üç harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
string | null
gerekli
Verginin fiyatın üstüne mi eklendiği (exclusive) yoksa zaten içinde mi olduğu (inclusive). Vergi hesaplanmadığında null.Kullanılabilir seçenekler: inclusive, exclusive
object[]
gerekli
Teklifin bir işletme satın alımı olarak fiyatlandırdığı alıcının vergi kaydı. Tüketici satın alımı için boş.

Özellikler

string
gerekli
Kaydın türü, örneğin eu_vat.Kullanılabilir seçenekler: 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
gerekli
Alıcının girdiği şekliyle, boşlukları kaldırılmış kayıt numarası (eu_vat değerlerinde noktalar ve tireler de kaldırılır).
string
gerekli
calculated: her satır fiyatlandırıldı ve bir ödeme teklifi kullanabilir. not_applicable: bu satıcı bu satın alımda vergi toplamaz, bu nedenle teklif vergi borçlu değildir ve yine de kullanılabilir. unavailable: vergi fiyatlandırılamadı — sağlayıcı yanıt vermedi veya bu satıcının vergi kurulumu burada bir satın alımı fiyatlandıramıyor — bu nedenle bir ödeme teklifi reddeder; yeniden teklif alın veya verginin tahsilat sırasında hesaplanması için quote_id olmadan tahsil edin.Kullanılabilir seçenekler: calculated, not_applicable, unavailable
object
gerekli
Alıcının ödediği tutar: ara toplam eksi indirim, vergi üste eklendiğinde artı tax_amount.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için bir dizedir.
string
gerekli
Küçük harfli, üç harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ödemenin kendisinin yürütüldüğü hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals değerine eşittir, ancak bilerek her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
PaymentQuote