sERPa súgó

Leírás

Lehetőség van a bankkártyás fizetések állapotának nyomon követésére a sERPa rendeléseken.

Jelenleg ezen szolgáltatóktól jövő információkat tudjuk feldolgozni:

•SimplePay

•Barion

Ez fejlesztéssel bővíthető, ha ügyfelünk beküld minta hívásokat a fejlesztési igény benyújtásával.

A webáruháztól a vevőrendeléssel együtt kapott fizetési információkat eltároljuk a programban felvett vevőrendelésben két módon:

1. Kifizetés státusz További adatként

Egyrészt az éppen aktuális sikeres / sikertelen fizetés állapotot a Vevőrendelésben az Általános fülön található További adat táblázatban mentjük le.

A működéshez szükséges a webáruház paraméterben a Kifizetés státuszt egy meghatározott további adat típusra állítani.

Formátum: XML

Elküldendő adat: payment/bank_status

<bank_status>Sikeres fizetés</bank_status>

2. Kártyás fizetési adatok

Másrészt ha a webáruháztól érkezik bankkártyás fizetésre vonatkozó információ (BankAnswerCode mezők, pl. dátum, tranzakciószám, banki válasz), akkor azt a Vevőrendelés bizonylaton a Kártyás fizetés fülön megjelenítjük. Ha a Kártyás fizetés fülön esemény található, akkor a legutolsó banki kifizetés állapotot a Vevőrendelés Általános fülén a Kártyás fizetés státusz mezőben is kijelezzük.

Kártyás fizetés kerül felvételre, ha az összes felsorolt feltétel együttesen teljesül:

[ I. eset - Rendelés - Rendeles.xml]

+  rendelés felvételkor sikeresen létrejön a vevőrendelés

+ 'payment_bank_code' értéke = 'simple' vagy 'barion'

+ 'payment_paid_amount' értéke nem üres vagy nem '0'.

+ és az a) vagy b) közül az egyik teljesül:

    a) a 'payment_bank_answer_code' értéke = '0' vagy 'Succeeded', továbbá 'payment_trans_code' is szerepel az XML-ben

    b) a 'payment_trans_code' nem szerepel az XML-ben (NULL).

 

Eredménye:

1. Amennyiben van értéke a 'payment_trans_code' bejegyzésnek (és a rendelésnek van érvényes dátuma, ami maga a tranzakció dátuma is lesz), akkor:

oA 'payment_trans_code' mezőben átadott értéket eltároljuk és megmutatjuk a vevőrendelés Kártyás fizetés fülén a Tranzakció azonosító mezőben.

2. Amennyiben nincs értéke a 'payment_trans_code' bejegyzésnek:

oFeltételezzük, hogy nem egylépcsős módon kapunk fizetési információt, ezért üresen hagyjuk a vevőrendelés Kártyás fizetés fülén a Tranzakció azonosító mezőt.

 

Megjegyzések:

•Rendelés módosításakor a kártyás fizetés adatait nem lehet módosítani.

•Ha a Webáruház paraméter / További adatok fülön a Kártyás fizetés nyugtázott figyelés mező = hamis, akkor a vevőrendelés Kártyás fizetés fülén most rögzített fizetési információt nyugtázottnak tekintjük, függetlenül attól, hogy sikeresnek jelölték-e. (Következményt ld. a mező súgójánál.)

•Ha a Kártyás fizetés nyugtázott figyelés = igaz, akkor csak akkor tekintjük nyugtázottnak a vevőrendelés Kártyás fizetés fülén most rögzített fizetési információt, ha a 'payment_bank_answer_code' értéke = '0' vagy 'Succeeded'. Minden más esetben nem tekintjük sikeresnek a fizetési információt.

[ II. eset - Rendelésre befizetés- Rendeles2.xml]

 + létezik a rendelés, amire hivatkozunk az 'erp_order_code' mezőben

 + 'payment_bank_answer_code' értéke = '0' vagy 'Succeeded'

 + a tranzakciónak van dátuma (az üzenet beküldés valós dátuma).

 

Eredménye:

oA 'payment_trans_code' mezőben átadott értéket (ha van és nem NULL) eltároljuk és megmutatjuk a vevőrendelés Kártyás fizetés fülén a Tranzakció azonosító mezőben.

oA vevőrendelésen rögzített fizetési információt nyugtázottnak tekintjük. (Ld. Webáruház paraméter / További adatok fülön a Kártyás fizetés nyugtázott figyelés mező.)

 

Hibaüzenetek

1. "A 'Kifizetés státusz' mező nincs kitöltve a paraméterben!"

      Akkor küldjük, ha az összes felsorolt feltétel együttesen teljesül:

        - a Webáruház paraméter / További adatok / Kifizetés státusz mező értéke nem üres

        - payment[1]/bank_status[1] nincs kitöltve

        - payment[1]/bank_answer_code[1] nincs kitöltve

        - payment[1]/trans_code[1] nincs kitöltve

       (megjegyzés: <bank_status/> itt nem számít nem kitöltésnek. Ezzel törölni lehet a címke szövegét.)

2. "Érvénytelen banki tranzakció érkezett! Hiányzó mező: "

      Akkor küldjük, ha bármelyik felsorolt feltétel teljesül:

        - a Webáruház paraméter / További adatok / Kifizetés státusz mező értéke üres és az alábbi bejegyzések közül bármelyik üres: payment[1]/bank_answer_code[1], payment[1]/trans_code[1]

        - payment[1]/bank_answer_code[1] nem üres, de a payment[1]/trans_code[1] üres

        - payment[1]/bank_answer_code[1] üres, de a payment[1]/trans_code[1] nem üres

       (megjegyzés: ha a bank_answer_code és trans_code mező is hiányzik, eszerint a sorrend szerint mindig csak egy mezőt jelzünk hibásnak)

 

Példák

Példa egylépcsős kártyás fizetésre:

XML:

<serpa>

<head>

<token>x</token>

<type>order</type>

<time>2026-01-14 10:00:00</time>

</head>

<content>

<order>

<order_code>2103300199</order_code>

<store_code>KR DK</store_code>

<order_series>WGP1</order_series>

<currency>HUF</currency>

<customer>

<name>Kertész József</name>

<phone>+36707777588</phone>

<email>KertJozsi003@gmail.com</email>

<customer_webshop_code>netgo_customer_32</customer_webshop_code>

<customer_groups/>

<agent/>

</customer>

<bill>

<name>Kertészet Nagyker01 Kft.</name>

<zip>1184</zip>

<city>Budapest</city>

<street>Pesti út 7.</street>

<taxnumber>10307078-2-44</taxnumber>

<!--<company/>-->

<postal_name>Kertészet Nagyker01 Kft.</postal_name>

<postal_zip>1184</postal_zip>

<postal_city>Budapest</postal_city>

<postal_street>Pesti út 7.</postal_street>

<bill_webshop_code>netgo_bill_23</bill_webshop_code>

</bill>

<items>

<item>

<item_id>1</item_id>

<product_code>WEB001</product_code>

<pc>1</pc>

<net_unit_price>1020</net_unit_price>

<gross_unit_price>1227</gross_unit_price>

<net_price>100</net_price>

<gross_price>127</gross_price>

<discount_percent>0</discount_percent>

<vat>27</vat>

</item>

</items>

<coupon>

<coupon_code/>

<coupon_name/>

<coupon_gross>0</coupon_gross>

</coupon>

<delivery>

<delivery_id>14</delivery_id>

<delivery_name>Budapest 1149, Egressy tér 11/B - Szaküzlet</delivery_name>

<delivery_cost_net>200</delivery_cost_net>

<delivery_cost_gross>200</delivery_cost_gross>

</delivery>

<payment>

<payment_id>19</payment_id>

<payment_name>ND bankkártya</payment_name>

<payment_cost_net>0</payment_cost_net>

<payment_cost_gross>0</payment_cost_gross>

<paid>0</paid>

<bank_status>Sikeres fizetés</bank_status>

<bank_code>SIMPLE</bank_code>

<bank_answer_code>Succeeded</bank_answer_code>

<trans_code>12345678</trans_code>

<paid_amount>1227</paid_amount>

<auth_code/>

</payment>

<customer_comment/>

</order>

</content>

</serpa>

 

Példa kétlépcsős kártyás fizetésre:

Rendelés - Rendeles.xml

XML:

<serpa>

<head>

<token>x</token>

<type>order</type>

<time>2026-01-14 10:00:00</time>

</head>

<content>

<order>

<order_code>2103300199</order_code>

<store_code>KR DK</store_code>

<order_series>WGP1</order_series>

<currency>HUF</currency>

<customer>

<name>Kertész József</name>

<phone>+36707777588</phone>

<email>KertJozsi003@gmail.com</email>

<customer_webshop_code>netgo_customer_32</customer_webshop_code>

<customer_groups/>

<agent/>

</customer>

<bill>

<name>Kertészet Nagyker01 Kft.</name>

<zip>1184</zip>

<city>Budapest</city>

<street>Pesti út 7.</street>

<taxnumber>10307078-2-44</taxnumber>

<!--<company/>-->

<postal_name>Kertészet Nagyker01 Kft.</postal_name>

<postal_zip>1184</postal_zip>

<postal_city>Budapest</postal_city>

<postal_street>Pesti út 7.</postal_street>

<bill_webshop_code>netgo_bill_23</bill_webshop_code>

</bill>

<items>

<item>

<item_id>1</item_id>

<product_code>WEB001</product_code>

<pc>1</pc>

<net_unit_price>1020</net_unit_price>

<gross_unit_price>1227</gross_unit_price>

<net_price>100</net_price>

<gross_price>127</gross_price>

<discount_percent>0</discount_percent>

<vat>27</vat>

</item>

</items>

<coupon>

<coupon_code/>

<coupon_name/>

<coupon_gross>0</coupon_gross>

</coupon>

<delivery>

<delivery_id>14</delivery_id>

<delivery_name>Budapest 1149, Egressy tér 11/B - Szaküzlet</delivery_name>

<delivery_cost_net>200</delivery_cost_net>

<delivery_cost_gross>200</delivery_cost_gross>

</delivery>

<payment>

<payment_id>19</payment_id>

<payment_name>ND bankkártya</payment_name>

<payment_cost_net>0</payment_cost_net>

<payment_cost_gross>0</payment_cost_gross>

<paid>0</paid>

<bank_status>Fizetés alatt</bank_status>

<bank_code>SIMPLE</bank_code>

<bank_answer_code>Succeeded</bank_answer_code>

<paid_amount>1227</paid_amount>

<bank_answer_code/>

<auth_code/>

</payment>

<customer_comment/>

</order>

</content>

</serpa>'

 

Rendelésre befizetés- Rendeles2.xml

XML:

<serpa>

 <head>

   <token>X</token>

   <type>order</type>

   <time>2026-01-14-10-01-59</time>

 </head>

 <content>

   <order>

     <order_code>2103300199</order_code>

     <erp_order_code>2026-WGP1/000001</erp_order_code>

     <payment>

        <bank_code>SIMPLE</bank_code>

        <bank_status>Sikeres</bank_status>

        <bank_answer_code>Succeeded</bank_answer_code>

        <trans_code>12345678</trans_code>

     </payment>

   </order>

 </content>

</serpa>