Köteg (Batches) és tétel (Items) adatok

Sikeres lekérdezés esetén a köteg adatok (Batches) és az azokhoz tartozó tételek (Items) egyaránt a Data változóban kerülnek visszaadásra. Amennyiben egy adott napon több kiutalásra is sor került, a Batches elemben több köteg is szerepelhet. Ilyen esetben az egyes kötegek és tételek beazonosítását a következő paraméterek teszik lehetővé:

  • átutalások azonosításához használja a banki utalási közleményt (TransferNotice)

  • tételek azonosításához használja a banki utalási közleményt (TransferNotice) vagy a kötegazonosítót (SettlementBatchId)

Köteg (Batches) elemei

A kérésre visszaadott Batches a következő elemeket tartalmazhatja:

Paraméter
Típus
Leírás

SettlementBatchId

number

(8 karakter)

Köteg azonosítója.

SettlementDate

string

(10 karakter)

Kimutatás létrehozásának dátuma.

ProviderName

string

(20 karakter)

Fizetési szolgáltató azonosítója.

TerminalId

string

(64 karakter)

Terminál azonosító.

TransferNotice

string

(255 karakter)

Banki utalási közlemény.

NumberOfItems

number

(10 karatker)

Tételek száma a kötegben.

TransactionCurrency

string

(3 karakter)

Tranzakciók devizaneme.

TotalTransactionNonRefundAmount

number

(24 karakter)

Bejövő tranzakciók összege a tranzakciók devizanemében.

TotalTransactionRefundAmount

number

(24 karakter)

Visszatérítések összege a tranzakciók devizanemében.

TotalTransactionAmount

number

(24 karakter)

Tranzakciók egyenlege a tranzakciók devizanemében.

(A bejövő tranzakciók és a visszatérítések szummája.)

SettlementCurrency

string

(3 karakter)

Elszámolás devizaneme.

TotalSettlementNonRefundAmount

number

(24 karakter)

Bejövő tranzakciók összege az elszámolás devizanemében.

TotalSettlementRefundAmount

number

(24 karakter)

Visszatérítések összege az elszámolás devizanemében.

TotalSettlementAmount

number

(24 karakter)

Tranzakciók egyenlege az elszámolás devizanemében.

(A bejövő tranzakciók és a visszatérítések szummája.)

TotalSettlementCommissionAmount

number

(24 karakter)

Teljes jutalék az elszámolás devizanemében.

TotalSettlementCommissionReducedAmount

number

(24 karakter)

Jutalékkal csökkentett összeg az elszámolás devizanemében.

TotalChargebackAmount

number

(24 karakter)

Chargeback (visszaterhelési) összeg.

(Jelenleg nincs használatban.)

PreviousAccumulatedAmount

number

(24 karakter)

Nyitó görgetett egyenleg.

Akkor lesz értéke, ha az előző elszámolási állományban található tranzakciók összege nem érte el a fizetési szolgáltató által a kereskedő felé minimálisan kiutalható összeget.

CurrentAccumulatedAmount

number

(24 karakter)

Záró görgetett egyenleg.

Akkor lesz értéke, ha az adott elszámolási állományban található tranzakciók összege plusz a nyitó görgetett egyenleg (ha létezik) nem érte el a fizetési szolgáltató által a kereskedő felé minimálisan kiutalható összeget, vagy a kiutalás blokkolva van.

TransferredAmount

number

(24 karakter)

Kereskedőnek kiutalt összeg.

A visszaadott TransferredAmount paraméter értékének megállapítására a következő alaplogika van érvényben:

  • Abban az esetben, ha a fizetési szolgáltató és a kereskedő között a tranzakciók nettó értékkel, vagyis jutalékkal csökkentve kerülnek elszámolásra, a TransferredAmount paraméter értéke a TotalSettlementCommissionReducedAmount (Tranzakciók jutalékkal csökkentett összege az elszámolás devizanemében) paraméter értékével fog megegyezni.

  • Amennyiben a fizetési szolgáltató és a kereskedő között a tranzakciók bruttó értékkel, vagyis jutalékkal nem csökkentve kerülnek elszámolásra, a TransferredAmount paraméter értéke a TotalSettlementAmount (Tranzakciók jutalékkal nem csökkentett összege az elszámolás devizanemében) paraméter értékével fog megegyezni.

Ha a PreviousAccumulatedAmount, CurrentAccumulatedAmount és TransferredAmountAdjustment paramétereknek van értéke, úgy a visszaadott TransferredAmount paraméter értékének megállapítására vonatkozó logika az alábbiak szerint módosul:

  • A TransferredAmount értéke lehet 0, abban az esetben ha az adott elszámoláshoz nem tartozott kiutalás a fizetési szolgáltatótól a kereskedő felé. (Ennek okát lásd a CurrentAccumulatedAmount paraméter leírásánál.)

  • A TransferredAmount értéke a tranzakciók összegén felül magában foglalja a PreviousAccumulatedAmount (Nyitó görgetett egyenleg) és a TransferredAmountAdjustment (Korrekció mértéke a kiutalt összegen) mezők összegeit is, amennyiben történt kiutalás a fizetési szolgáltatótól a kereskedő felé.

TransferredAmountAdjustment

number

(24 karakter)

Korrekció mértéke a kiutalt összegen.

A fizetési szolgáltató a kereskedő felé kiutalt összegen (ami alapvetően a tranzakciók jutalékkal csökkentett összegéből adódik nettó elszámolás esetén) korrekciót hajthat végre, aminek oka lehet kerekítés, vagy egyéb plusz költség, például adó.

TotalSettlementInterchangeFee

number

(24 karakter)

Bankközi díjjak összege.

TotalSettlementCardSchemeFee

number

(24 karakter)

Kártyatársasági díjjak összege.

TotalSettlementMerchantServiceFee

number

(24 karakter)

Kereskedői díjjak összege.

Tétel (Items) elemei

A kérésre visszaadott Items a következő elemeket tartalmazhatja:

Paraméter
Típus
Leírás

SettlementBatchId

number

(8 karakter)

Köteg azonosító.

SettlementDate

string

(10 karakter)

Kimutatás létrejöttének dátuma.

ProviderName

string

(20 karakter)

Fizetési szolgáltató azonosítója.

TerminalId

string

(64 karakter)

Terminál azonosító.

TransferNotice

string

(255 karakter)

Banki utalási közlemény.

SettlementFileName

string

(64 karakter)

A kimutatási fájl neve.

SettlementId

string

(64 karakter)

Kimutatás azonosító.

(Szolgáltató függő, hogy van vagy nincs értéke.)

AuthCode

string

(16 karakter)

Elszámolt tranzakció banki engedélyszáma.

(Szolgáltató függő, hogy van vagy nincs értéke.)

SettlementTransactionId

string

(64 karakter)

Kimutatásban szereplő tétel azonosító.

ProviderTransactionId

string

(255 karakter)

Szolgáltatónál létrejött tranzakció azonosító.

TransactionId

string

(255 karakter)

BIG FISH Payment Gateway tranzakció azonosító.

OrderId

string

(255 karakter)

Megrendelés azonosító.

UserId

string

(255 karakter)

Felhasználó (vásárló) azonosító.

StoreName

string

(50 karakter)

A bolt neve a BIG FISH Payment Gateway rendszerében, ahol a tranzakció létrejött.

TransactionCreatedTime

string

(19 karakter)

Tranzakció inicializálásának időpontja a BIG FISH Payment Gateway rendszerében.

ProviderTransactionCreatedTime

string

(19 karakter)

Tranzakció létrejöttének időpontja a szolgáltató rendszerében.

TransactionCurrency

string

(3 karakter)

Tranzakció devizaneme.

TransactionAmount

number

(24 karakter)

Tranzakció összege a tranzakció devizanemében.

SettlementCurrency

string

(3 karakter)

Elszámolás devizaneme.

SettlementAmount

number

(24 karakter)

Tranzakció összege az elszámolás devizanemében.

SettlementCommissionAmount

number

(24 karakter)

Jutalék az elszámolás devizanemében.

SettlementCommissionReducedAmount

number

(24 karakter)

Jutalékkal csökkentett összeg az elszámolás devizanemében.

CardType

string

(64 karakter)

A tranzakció létrehozásához használt bankkártya típusa.

CardNumber

string

(20 karakter)

A tranzakció létrehozásához használt bankkártya száma.

SettlementInterchangeFee

number

(24 karakter)

Bankközi díj összege.

SettlementCardSchemeFee

number

(24 karakter)

Kártyatársasági díj összege.

SettlementMerchantServiceFee

number

(24 karakter)

Kereskedői díj összege.

Comment

string

(30 karakter)

A tranzakcióhoz tartozó kiegészítő információk.

Last updated