Köp walýuta kataloglary

(Bölüm: Amallar we Dolandyryş)

1) Wezipe we ulanylýan ugur

• bahalaryň dogry penjiresi (UX, ynam),
• hasaplaşyklaryň gaýtalanmagy (audit, yzyna gaýtarmak),
• ykdysady çaklama (marja/salgytlar),
• komplayens (salgyt salmak, sanksiýalar, walýuta çäklendirmeleri).

2) Maglumatlaryň nusgasy (salgylanma)

• Product/SKU: `{sku_id, title, attributes, region_policies[]}`
• PriceList: `{pricelist_id, base_currency, effective_from, effective_to, version}`
• PriceItem: `{sku_id, base_price, base_currency, tax_class, pricing_model, promo_refs[]}`
• FXRate: `{pair: EUR→USD, rate, source, method, precision, effective_from, version}`

• `minor_units` (ISO 4217; Mysal üçin JPY = 0, USD/EUR = 2, KWD = 3; crypto üçin - 8-e çenli)
• 'rounding _ mode': 'HALF _ UP' (bölek satuw), 'BANKERS' (maliýe), 'FLOOR '/' CEIL' (salgytlar/düzgünleşdirijiler)

3) Çeşmeler we FX syýasaty (walýuta hümmeti)

Çeşmeler: kurslaryň üpjün edijileri (täjirçilik/merkezi banklar), öz TWAP/media.
Täzeleniş syýasaty: ýygylyk (üýtgäp durýanlar üçin 1-15 minut, durnuklylar üçin 1 gezek/gün), neşiriň gijikdirilmegi.
Markaplar: 'rate (1 + fx_markup_bps)' müşderiniň tarapyna; aç-açan düzgünler per-kanal/sebit.
Kepillendirilen kotirovka penjiresi (rate lock): 5-30 min c 'fx _ version' zakazda.
Anti-bökmek: tik, circuit-breakers, fallback üçin soňky bahanyň üýtgemegi.
Wersiýalaşdyrmak: kurslaryň her neşirinde 'version', 'effective _ from' bar; taryhy yzyna gaýtarmak/jedeller üçin saklaň.

4) Nyrh döretmek strategiýalary

Base + FX: esasy bahany "ýadroda" saklamak (mysal üçin, EUR), penjirede öwürmek.
Per-currency sahypalary: esasy walýutalar üçin öňünden hasaplanan bahalar (iň gowy UX, öňünden aýdylýanlygy).
Mixed: Top 10 walýuta - öňünden hasaplama, "uzyn guýruk" - on-the-fly.
Charm-pricing: `X. 99/95/90 'sebitde, tegelek ýalňyşlyklaryň toplanmagyna gözegçilik ediň.
Komissiýalar/ýygymlar: payment fee, cross-border fee, network fee (crypto) - katalogda ýa-da "Checkout Pricing" tapgyrynda.

5) Salgytlar we "goşmak"

VAT/GST goşuldy/aýryldy: EU - köplenç VAT-goşuldy; B2B goşulan baha üçin salgydsyz bolup biler.
Salgyt gatlaklary: federal/döwlet/ýerli; onlaýn oýunlar üçin - aýratyn ýygymlar.
Çäk nyrhlary: salgyt dolanyşykdan/kategoriýadan/sebitden (threshold) üýtgeýär.
Salgytlary tegeleklemek: per-item vs per-basket; tegelek usullar we hasaplamalaryň tertibi kesgitlenmeli.
Ýur. hasabat: 'tax _ rule _ version' -ni çek/kwitansiýada saklaň.

6) Tegelek we takyklyk

Görkezilişiň soňky ädiminde tegelek; hasaplamalarda "ýokary takyklygy" saklaň (8-9 belgä çenli).
Crypto üçin decimal kitaphanasyny ulanyň (ikilik ýüzýän kitaphanasyz).
Anti-drift sebedi: "bankers rounding", ýöne UX-tegelek görkezmek üçin; 'rounding _ scope' belläň.
Jemi düzgüni: tegeleklerden soň setirleriň jemi jemi bilen gabat gelmelidir - iň soňky teňňe/sent paýlanyşyny ulanyň (penny distribution).

7) Kataloglar, mahabatlar we bandlar

Promo-правила: `if region=A and currency in [EUR,USD] then discount=10% cap=50`.
Ulanylyş tertibi: (1) esasy bahasy → (2) arzanladyş → (3) salgytlar → (4) ýygymlar → (5) tegelek.
Bundle-paýlamak: arzanladyşa çenli pozisiýalaryň tabyna proporsional; Yzyna gaýtarmak üçin.
Threshold-promo: sebet pulunda total ≥ X-de mugt eltip bermek/bonus; ekwiwalentini esasy walýutada saklaň, ýöne FX wersiýasyny düzüň.

8) Tölegler we komplayens bilen integrasiýa

Walýuta elýeterliligi: her bir walýuta her bir oýunçy/sebit/töleg üpjün ediji üçin elýeterli däl.
Guaranteed FX: kesgitlenen 'fx _ version' boýunça deslapky ygtyýarlandyrma; ekspirasiýa edilende - täze bahany tassyklamak haýyşy.
KUS/sanksiýalar: walýutalaryň/banklaryň/bellikleriň blok-sahypalary, konwersiýa çäklendirmeleri.
Yzyna gaýtarmalar/chargeback: taryhy 'fx _ version' sargyt boýunça gaýtadan hasaplamak; yzyna gaýtarmak üçin komissiýa - geleşik senesindäki katalog boýunça.

9) API arhitekturasy we şertnamasy

• `GET /catalog/prices? sku=…¤cy=…®ion=…&pricelist=…`
• Ответ: `{unit_price, currency, fx_version, pricelist_version, tax_breakdown[], fees[], display_price, rounding_mode}`

• `POST /pricing/quote { items[], region, currency, buyer_type }`
• Ответ: `{items_priced[], subtotal, discounts, taxes[], fees[], total, fx_version, lock_ttl, signature}`

• 'POST/pricing/commit {quote_id, signature}' → heş we gollary bolan kwitansiýa.

• `PriceListUpdated`, `FXRatePublished`, `TaxRuleChanged`, `PromoChanged` — с `version/effective_from`.

10) Kesmek we öndürijilik

Edge-kesh: açar 'pricelist: region: currency: sku: version'; Durnukly walýutalar üçin TTL has ýokarydyr.
Warmup: kampaniýany başlamak üçin iň ýokary kategoriýalary gyzdyrmak.
SWR (stale-while-revalidate): penjireler üçin; checkout - diňe fresh.
Partial invalidation: 'sku', 'category', 'pricelist _ version' taglary boýunça maýyplyk.
SLO: p95 ≤ 120 ms vitrin üçin, p95 ≤ 250 ms quote üçin, ≥ 99. 95% elýeterlilik.

11) Gözegçilik we audit

Tracking: 'trace _ id', 'pricelist _ version', 'fx _ version', 'tax _ rule _ version' ähli wakalarda.
Immutability: WORM-Price-listleri/kurslary çap edýän magazinesurnallar; Merkle bölekleri, sanaw gollary (DSSE).
Receipts: doly ýerleşdirilen çek/kwitansiýa we peýdaly ýük heşi; 7-10 ýyl saklamak (düzgünleşdiriji boýunça).
Daşbordlar: penjiräniň tapawudy, "ýokary/aşak" tegelek ýygylygy, FX ýalňyşlyklary, kursy blokirlemek wagty (TTL gulplama), ROI mahabat.

12) Görkezilişiň lokalizasiýasy

Walýuta görnüşi: nyşan/kod (, €, $, AED), nyşanyň ýagdaýy, bölüjiler, boşluk.
Lokallaşdyrylan düzgünler: " 1 234.56" vs "$1,234. 56”.
Psihologiýa: jadyly baha bellikleri ('.99') fintech/oýunlarda hemişe ýerlikli däl; per-sebiti synagdan geçiriň.
Hukuk gollary: "Baha goşulan baha üçin salgydy öz içine alýar", "Toruň komissiýasy aýratyn alynýar".

13) Aýratyn ýagdaýlar

Bölek bölegi bolmadyk walýutalar: JPY/ISK - minor_units=0.
Üç belgili minor units: KWD/BHD = 3.
Kripto: BTC/ETH/USDT - 8 belgä çenli, aýratyn network fee; stablecoins ≠ kross-borderde "kurs 1:1".
Goşa bahasy: "katalogyň walýutasy" ≠ "hasapdan çykarmak walýutasy" (söwdanyň bank hümmeti). Spread resminamasy.
Sport/oýunlar: katalogyň walýutasyndaky iň ýokary ýeňişlere çäklendirmeler - 'fx _ version' tapgyryň ekwiwalentlerini saklamak.

14) SLO/SLI we üstünlik metrikleri

Dogrulygy: sargytlaryň paýy, bu ýerde total_checkout = total_quote (paýlamagyň kadalarynda 1 minor unit ±) ≥ 99. 99%.
FX durnuklylygy: rate lock penjiresindäki amallaryň paýy ≥ 99%.
Ykdysadyýet: marja/birlik vs meýilnama; FX/tegelekleri sebäpli gyşarmalar (bps).
UX: tizlik quote p95, bahany gaýtadan hasaplamakda galyndylaryň paýy, NPS vitrin.
Audit: saklanan '_ version' we goly bolan çekleriň 100%.

15) Wakalaryň pleýbuklary

1. freeze keş-maýyplar, 2) praýs-sanawyň mejbury refresh, 3) deňeşdirmek 'pricelist _ version '/' fx _ version', 4) syýasat boýunça kompensasiýa.

1. 2) TTL blokyny gysgaltmak, 3) fallback çeşmesine geçmek.

1. barlamak 'tax _ rule _ version', 2) rounding_scope tassyklamasy, 3) hotfix düzgünleri we sebet göçürmesi.

1. gorag düzgünleri (min_price), 2) akymy öçürmek, 3) recalculation we audit.

16) Howpsuzlyk we gabat gelmek

Policy-as-code: PR arkaly baha sanawlarynyň/FX/salgytlaryň üýtgemegine gözegçilik etmek + goýberilen gollar.
Rollar/Elýeterlilikler: Bahalary çap etmekde 4 gözli ýörelge/FX.
Girişler/kwitansiýalar: neşirleriň we hasaplamalaryň gol çekilen wakalary.
Sebitleýin çäklendirmeler: aýry-aýry walýutalaryň/tokenleriň gadagan edilmegi; geo-syýasatlar.

17) Synaglar we optimizasiýa

A/B: charm-pricing, öňünden hasaplanan bahalar vs on-the-fly, görkeziş formaty.
Dinamiki markup: jübütiň üýtgewsizligine/günüň wagtyna garaşlylyk.
Kogort seljermesi: walýuta boýunça yzyna gaýtarmalar/chargeback, tegelege duýgurlyk.
Nagt strategiýalar: SWR/TTL-iň öwrülişige we takyklyga täsiri.

18) Girizmegiň çek-sanawy

• Sahypalaryň esasy walýutasyny we per-currency syýasatyny kesgitlemek.
• FX ýygnamagyny/çap edilmegini TTL wersiýasy, markaplary we gulplary bilen sazla.
• TaxRule we hasaplamalaryň/tegelekleriň tertibini resmileşdiriň (per-item ýa-da per-basket).
• /quote/commit katalogynyň API-sini ýerine ýetirmek + gol çekilen kwitansiýalar.
• edge-kesh we granulýar maýyplygy öz içine alyň; Ekranlar üçin SWR.
• Dashbordlary açyň (vitrin, FX ýalňyşlyklary, salgytlar, marja bps).
• Bahalary/kurslary, WORM magazinesurnallaryny çap etmek üçin rollary/gollary giriziň.
• Pleýbuklary taýýarlamak: bahanyň peselmegi, FX bökmek, salgyt ylalaşmazlygy.
• "GameDay katalogyny" geçiriň: FX çeşmesini öçürmek, mahabat-burst, salgyt çalyşmak.
• Sebitler boýunça minor_units/otobrazheniye yzygiderli gözden geçiriň.

19) FAQ

Her walýutada bahalary saklamak zerurmy?
Hökman däl. Iň ýokary walýutalar üçin öňünden hasaplamany we "guýruk" üçin öwrülişigi birleşdiriň - UX we çykdajylar deňagramly.

Näme üçin tegeleklerden soň "urmaýar"?
per-item vs per-basket tapawudy sebäpli. Bir çemeleşmäni düzüň we "penny distribution" ulanyň.

Bir aýdan soň nädip yzyna gaýtarmaly?
Taryhy 'pricelist _ version', 'fx _ version' we 'tax _ rule _ version' boýunça kwitansiýada saklanýar.

Crypto näme?
Decimal-takyklygy, network fee aýratyn ulanyň, fiata 1:1 wada bermäň; kursy we hereket penjiresini düzüň.

Gysgaça maglumat: Köp walýutaly katalog takyk matematikanyň, berk syýasatlaryň we akylly kesleşmegiň utgaşmasydyr. Hemme zady (bahalary/nyrhlary/salgytlary) wersiýa ediň, sitatalaryň penjiresini düzüň, hasaplamalaryň we tegelekleriň tertibini kesgitläň, çek-artefaktlara gol çekiň we daşbordlary görünýän ýagdaýda saklaň. Şeýdip, siz ähli walýutalarda we sebitlerde dogruçyl vitrin, köpeldilýän hasaplamalar we dolandyrylýan ykdysadyýet alarsyňyz.