Transaction

A Barion wikiből

Tranzakció objektum

Egy adott tranzakció részleteit a Barion az alábbi formában ábrázolja. Ezekből a tranzakció objektumokból áll össze például a Transaction-List-v1 hívás által visszaadott tranzakciós lista, illetve a Transaction-Detail-v1 hívás által visszaadott tranzakciókat tartalmazó tömb.

Mező Típus Leírás Formátum / Példa
TransactionId GUID A tranzakció egyedi azonosítója a Barionban. a8d76b37-2f21-4524-9108-ae8957f3b68d
Time DateTime A tranzakció UTC időbélyege ISO-8601 formátumban, Z nélkül a végén. 2014-09-02T12:01:53.00
Amount integer A tranzakció összege ezres elválasztók és pénznem feltüntetése nélkül. Előjele attól függ, hogy a tranzakciót a küldő vagy a fogadó fél tekinti meg. 5000
FromName string A tranzakció indítójának neve, amennyiben ki van töltve. Ellenkező esetben null. Kovács Pistike
FromEmailAddress string A tranzakció indítójának e-mail címe. [email protected]
ToEmailAddress string A tranzakció címzettjének e-mail címe. [email protected]
ToName string A tranzakció címzettjének neve, amennyiben ki van töltve. Ellenkező esetben null. Horváth Aladár
FromBalance integer A tranzakció indítójának egyenlege a tranzakció végrehajtása után. 13000
Comment string A tranzakció közleménye. "A tegnapi mozijegy ára"
CommissionBySender boolean Jelzi, hogy a küldő fél átvállalta-e a tranzakciós jutalékot. true
Currency string A tranzakció pénzneme szöveges formában. Jelen pillanatban a Barion rendszer csak forint értékeket használ. Forint
TransactionType byte A tranzakció típusa a TransactionTypes-v1 felsorolás szerint. 2
RelatedTransactionId GUID Amennyiben a tranzakcióhoz tartozik egy másik tranzakció is (pl. borravalót adtunk egy vásárlási tranzakció mellé), akkor annak az azonosítója. 9a1f2b9a-8a68-42c4-8922-0edaee53d1ee
Products Products Vásárlás típusú tranzakció esetén a vásárolt termékek adatai. Products
ShopName string Vásárlás típusú tranzakció esetén a bolt neve. Online Bolt 2014
IsParkingTransaction boolean Parkolójegy vásárlása esetén ez az érték igaz. false
ShopGuid GUID Vásárlás típusú tranzakció esetén a bolt egyedi azonosítója a Barion rendszerében. c82e38cc-6de0-41a1-8816-ee70c37f3c22
RelatedTransactions TransactionDetailModel[] A tranzakcióhoz kapcsolódó tranzakciók részletei Transaction
Status byte A tranzakció státusza a TransactionStatus-v1 felsorolás szerint. 2

Példa

Íme egy példa egy tranzakciós objektumra. Gipsz Jakab 1500 forintot küldött Horváth Aladárnak. A tranzakció tehát egy egyszerű pénzküldés, ezt a 2-es értékű TransactionType jelzi. Jakab átvállalta a tranzakciós jutalékot is, bár mivel mindkét fél magánszemély, ezt nem kellett kifizetni. A tranzakciót Gipsz Jakab szemszögéből látjuk, így a tranzakció összege negatív előjelű.

{
    "TransactionId": "fd282ec7-6ac2-4571-8e20-1726208cb93b",
    "Time": "2014-10-01T08:52:10.62",
    "Amount": -1500,
    "FromName": "Gipsz Jakab",
    "FromEmailAddress": "[email protected]",
    "ToEmailAddress": "[email protected]",
    "ToName": "Horváth Aladár",
    "FromBalance": 12768,
    "Comment": "Részem a tegnapi sörözésből",
    "ComissionBySender": true,
    "Currency": "Forint",
    "TransactionType": 2,
    "RelatedTransactionId": null,
    "Products": null,
    "ShopName": null,
    "IsParkingTransaction": false,
    "ShopGuid": null,
    "RelatedTransactions": []
}