Payment-Refund-v2

A Barion wikiből
  • Tervezet
  • Üzlet
  • Informatika
  • Pénzügy
  • Jog
  • 80%
  • Online elfogadó
  • Mobil elfogadó
  • Pénztárgép
  • Feltöltés
  • Piactér
  • Nonprofit
  • Parkolas

Vásárlás utáni visszatérítés

POST v2/Payment/Refund

Ezt az API hívást használva van lehetősége a boltnak a sikeres vásárlást vagy lezárt befoglalást követően a vásárlás teljes vagy részösszegnek a visszatérítésére a vásárló számára. A visszatérítendő összeg érkezhet bankkártyára vagy e-pénz tárcára attól függően, hogy a tranzakciót a vásárló milyen forrásból fizette ki a bolt részére. Egy vásárlás tranzakciói maximum a tranzakciós összegig téríthetőek vissza, viszont a visszatérítés történhet több részletben is. A visszatérítésnek nincs időkorlátja, a sikeres vásárlás után bármikor visszatéríthető az összeg. Visszatérítés csak fizetési tranzakciókra lehetséges, azok vonatkozó díjaira nem. Visszatérítés a vásárló tárcájába vagy kártyás fizetés esetén a bankkártyájára történik.

Bemenet

Mező neve Mező típusa Kötelező Megkötések Alapértelmezett érték Leírás Formátum / Példa
POSKey Guid Kötelező nincs nincs Bolt egyedi és titkos azonosítója. 31532437-8D27-4C49-937B-8B3A45589127
PaymentId Guid Kötelező nincs nincs A visszatérítendő fizetési tranzakció egyedi azonosítója. c82e38cc-6de0-41a1-8816-ee70c37f3c22
TransactionsToRefund TransactionToRefund[] Kötelező nincs nincs A visszatérítendő tranzakciók listája.

Kimenet

Sikeres

Mező Típus Leírás Formátum / Példa
PaymentId Guid A fizetés azonosítója. c82e38cc-6de0-41a1-8816-ee70c37f3c22
RefundedTransactions RefundedTransaction[] A visszatérítési tranzakciók listája

Sikertelen

Hiba esetén a válasz egy hibalistát ad vissza. Ebben megtalálhatóak az előforduló hibák. A lista formátuma:

{
    Errors: [
        {
            ErrorCode: "",
            Title: "",
            Description: ""
        }
    ]
}
Hiba kódja Hiba leírása
AuthenticationFailed Nem egyező felhasználónév és jelszó.
InvalidShop Nem megfelelő bolt.
InvalidUser Nem megfelelő felhasználó.
AmountToRefundIsGreaterThanTransactionAmount A visszatérítendő összeg meghaladja a tranzakció összegét.
TransactionDoesNotBelongToPayment A tranzakció nem a megadott fizetési tranzakcióhoz(PaymentId) tartozik.
InvalidTransactionType A tranzakció típusa nem megfelelő, visszatéríteni csak fizetési tranzakciókat lehet.
PaymentStatusNotValid A fizetés státusza nem megfelelő, csak sikeresen lezárt tranzakciót lehet visszatéríteni a vásárlónak.
TooLowBalanceToMakeRefund A visszatérítést végző felhasználónak nincs elegendő fedezet a tárcájában.

Példák

Az alábbi példa tartalmazza a formátum helyes JSON példát a vásárlás visszatérítésére.

Bemenet

{
    "POSKey": "856C1CF7-05F5-47BE-AB7E-3FD261F26923",
    "PaymentId": "c82e38cc-6de0-41a1-8816-ee70c37f3c22",
    "TransactionsToRefund": [{
        "TransactionId": "d379aa92-a253-46a0-b45a-7256de48e79d",
        "AmountToRefund": 9999,
        "Comment": "vásárlás utáni visszatérítés",
        "POSTransactionId": "Shop_refund_identifier_01"
    }]
}

Kimenet

{
  "PaymentId": "c82e38cc-6de0-41a1-8816-ee70c37f3c22",
  "RefundedTransactions": [
    {
      "TransactionId": "fa9f4f4e-67c0-429f-a307-2eb5bf9a6e7c",
      "Total": 9999,
      "POSTransactionId": "Shop_refund_identifier_01",
      "Comment": "vásárlás utáni visszatérítés",
      "Status": "Succeeded"
    }
  ],
  "Errors": []
}