Redsys

A Redsys az a fizetésfeldolgozó a virtuális POS (TPV virtual) mögött, amelyet a legtöbb spanyol bank kínál üzleti ügyfeleinek. A Redsys fizetésszolgáltató lehetővé teszi ügyfelei számára, hogy bankkártyával vagy a Bizum segítségével fizessenek az eCommerce weboldalán és az ügyfélportálon.

Az átirányításos integrációval az ügyfeleket a biztonságos Redsys fizetési oldalra irányítja a rendszer a fizetés befejezéséhez, majd visszahozza őket az adatbázisába. Kártyaadatot az adatbázisa nem kér be és nem tárol.

Megjegyzés

A Redsys szolgáltatót az eYssen payment_redsys modulja biztosítja. A modullal automatikusan aktiválódik: nincs szükség további modul telepítésére.

Előfeltételek

  • Egy Redsys virtuális POS szerződés a bankjával, amely megad Önnek egy kereskedőkódot (más néven FUC), egy terminál**számot és egy **titkos kulcsot (clave secreta de firma) környezetenként (teszt és éles).

  • A Bizum használatához a bankjának engedélyeznie kell a Bizumot a virtuális POS-én.

  • A fizetés pénznemének rendelkeznie kell ISO 4217 numerikus kóddal (az összes elterjedt pénznem rendelkezik).

Redsys konfiguráció

A bankja hozzáférést biztosít a Redsys adminisztrációs portálhoz (Canales), külön portállal a tesztkörnyezethez és az éles környezethez. Mindkettőben gyűjtse össze a következő értékeket:

  • a kereskedőkód (FUC);

  • a terminál száma (általában 1);

  • a terminál titkos kulcsa (clave secreta de firma).

Fontos

Az Odoo csak a HMAC_SHA512_V2 aláírási verzióval aláírt üzeneteket fogadja el. Gondoskodjon arról, hogy a terminálja a Redsys adminisztrációs portálon ennek használatára legyen beállítva; ha nem tudja, hogyan, kérdezze meg a bankját. A más verzióval aláírt üzenetek, például a HMAC_SHA256_V1, elutasításra kerülnek (lásd Hibaelhárítás).

Megjegyzés

Azokat az URL-eket, amelyeken a Redsys a fizetés eredményét jelzi az Odoónak (az online értesítés és az ügyfél-visszatérési URL-ek), minden fizetési kéréssel együtt elküldi a rendszer a Redsysnek, ezért nem kell megadnia őket a Redsys adminisztrációs portálon.

Odoo konfiguráció

  1. Lépjen a Redsys fizetésszolgáltatóhoz.

  2. A Hitelesítő adatok fülön töltse ki a mezőket a Redsys konfiguráció lépésben összegyűjtött értékekkel:

    • Kereskedőkód (FUC): a kereskedőkód. Csak számjegyeket tartalmazhat.

    • Terminál: a terminál száma, 1–3 számjegy. Alapértelmezés szerint 1.

    • Titkos kulcs: a terminál titkos kulcsa.

  3. Szükség szerint konfigurálja a többi beállítást.

  4. Állítsa az Állapot mezőt Engedélyezve értékre (vagy Teszt mód értékre, ha ki szeretné próbálni az integrációt).

screenshot: finance-payment-providers-redsys-redsys-credentials
menu
Accounting ‣ Configuration ‣ Payment Providers ‣ Redsys ‣ Credentials
shows
The Redsys provider form, Credentials tab: Merchant Code (FUC), Terminal, Secret Key.
highlight
The Merchant Code (FUC), Terminal and Secret Key fields.
data
Fictitious merchant code and terminal 1; the secret key is masked (never use a real key).
module
payment_redsys
notes
English UI, light theme, 1440px width; developer mode off.

Fontos

A Titkos kulcs csak a Beállítások adminisztrátori hozzáférési csoportjába tartozó felhasználók számára látható és szerkeszthető (technikai csoport: base.group_system). A képernyőn maszkolva jelenik meg. A három mező kötelező, amint a szolgáltató nincs letiltva. A kereskedőkód és a titkos kulcs törlődik az adatbázis semlegesítésekor (például amikor egy éles adatbázist tesztelés céljából duplikálnak), ezért a másolaton adja meg őket újra.

Fizetési módok

A modul telepítésekor a Kártya, Bizum, Visa és Mastercard fizetési módok aktiválódnak a szolgáltatónál. Ennek módosításához kattintson a Fizetési módok engedélyezése gombra a szolgáltató Konfiguráció fülén. További információkért lásd: Fizetési módok.

A Redsysszel csak az ISO 4217 numerikus kóddal rendelkező pénznemek érhetők el. Az összegeket a Redsysnek a pénznem legkisebb egységében küldi a rendszer (például az euró esetében centben).

Tesztmód és éles működés

Az Odoo által használt környezetet a fizetésszolgáltató Állapot mezője határozza meg:

Megye

Redsys-környezet

Teszt mód

Redsys tesztkörnyezet (sis-t.redsys.es).

Engedélyezve

Redsys éles környezet (sis.redsys.es).

Az integráció kipróbálásához valódi fizetések feldolgozása nélkül:

  1. Állítsa az Állapot mezőt Teszt mód értékre.

  2. A Hitelesítő adatok fülön adja meg a teszt virtuális POS-e kereskedőkódját, terminálját és titkos kulcsát.

  3. Fizessen ki egy számlát vagy egy eCommerce rendelést a Redsys által a fejlesztői dokumentációjában megadott tesztkártyák egyikével.

Amikor készen áll a valódi fizetések fogadására, cserélje le a három hitelesítő adatot az éles virtuális POS-éire, majd állítsa az Állapot mezőt Engedélyezve értékre.

Figyelem

A teszt- és az éles környezet titkos kulcsa különbözik. Ha az Állapot mezőt a hitelesítő adatok cseréje nélkül módosítja, minden fizetés aláírási hibával meghiúsul.

Javaslat

Minden fizetés saját, véletlenszerű rendelésszámot kap, így egy duplikált tesztadatbázis és az éles adatbázis biztonságosan használhat közös terminált. Ennek ellenére duplikált vagy tesztadatbázison használja a tesztmódot, ahogy a Tesztmód ajánlja.

A fizetések feldolgozása

  1. Az ügyfél a fizetési űrlapon kiválasztja a Redsyst (vagy a Bizumot), és rákattint a Fizetés gombra.

  2. Az Odoo egy egyedi, 12 karakteres rendelésszámot hoz létre a tranzakcióhoz: 4 számjegyet, amelyet 8 számjegy vagy nagybetű követ. Ez azonosítja a fizetést a Redsys adminisztrációs portálon, és a tranzakció Redsys-rendelésszám mezőjében tárolódik. Szolgáltatói hivatkozásként is ez szolgál.

  3. Az ügyfél átirányításra kerül a Redsys fizetési oldalára, ahol fizet, és – ha a bankja megköveteli – hitelesíti magát.

  4. A Redsys aláírt értesítést küld az Odoónak, és visszahozza az ügyfelet az adatbázisa fizetési állapot oldalára. A fizetés eredményének hivatkozási alapja az értesítés; az ügyfél visszatérése csak akkor számít, ha aláírt adatokat hordoz.

  5. A tranzakció állapotát a Redsys válaszkódjából (Ds_Response) származtatja a rendszer:

    Válaszkód

    Tranzakció állapota

    0000–0099

    Megerősítve (a fizetés engedélyezve)

    9915

    Visszavonva (az ügyfél visszavonta a fizetést)

    8210, 8220, 9997, 9998, 9999

    Függő (a művelet még folyamatban van, pl. hitelesítés)

    Bármely más kód

    Hiba; az ok megjelenítésre kerül, ha ismert, majd a Redsys-kód következik

Az Odoo azt is ellenőrzi, hogy a Redsys által jelentett összeg és pénznem megegyezik-e a tranzakcióéval; ha nem, a tranzakció hibás állapotba kerül.

Bizum

A Bizum lehetővé teszi a spanyolországi ügyfeleknek, hogy a bankjuk mobilalkalmazásából, a telefonszámuk segítségével fizessenek. Ugyanazon a Redsys virtuális POS-en keresztül kerül feldolgozásra.

Ennek felkínálásához gondoskodjon arról, hogy a Bizum engedélyezve legyen a Redsys virtuális POS-én, és hogy a Bizum fizetési mód aktiválva legyen a Redsys szolgáltatónál (lásd: Fizetési módok).

Megjegyzés

  • A Bizum csak EUR pénznemű, Spanyolország országból indított fizetésekhez érhető el, a fizetési módon beállítottak szerint.

  • Ha az ügyfél a Bizumot választja, a Redsys fizetési oldala a Bizumra korlátozódik. Amikor a Redsys egy fizetést Bizummal teljesítettként jelent, a tranzakció fizetési módja Bizum értékre áll.

  • A Bizum nem támogatja a fizetési módok mentését és az expressz fizetést (express checkout).

Visszatérítések

A teljes és részleges visszatérítések közvetlenül az Odoóból is elvégezhetők, kártyás és Bizum-fizetések esetén. Egy fizetés visszatérítéséhez keresse meg azt, és kattintson a Visszatérítés gombra, ahogyan a Visszatérítések leírja.

Az Odoo azonnal elküldi a visszatérítési kérelmet a Redsysnek, és a visszatérítési tranzakció megerősített állapotba kerül, amikor a Redsys jóváhagyja (900-as válaszkód). Ha a Redsys elutasítja (például A visszatérítés nem engedélyezett) vagy nem érhető el, a visszatérítési tranzakció hibás állapotba kerül, az okkal együtt.

Megjegyzés

A visszatérítések mindig az eredeti fizetés Redsys-rendelésszámán alapulnak, és ugyanazt a pénznemet használják. A Redsys saját korlátokat alkalmaz a visszatérítésekre (például a visszatérített összeg nem haladhatja meg az eredeti összeget).

Hibaelhárítás

Minden fizetés és értesítés technikai részletei a szervernaplókba kerülnek. A következő helyzetek a leggyakoribbak.

Az üzenet nem támogatott verzióval van aláírva

Az Odoo elutasítja az értesítést vagy a választ a következő üzenettel: Az üzenet HMAC_SHA256_V1 verzióval van aláírva, de csak a HMAC_SHA512_V2 támogatott. Állítsa a terminált a HMAC_SHA512_V2 használatára. Módosítsa a terminál aláírástípusát HMAC_SHA512_V2 értékre a Redsys adminisztrációs portálon, vagy kérje meg a bankját, hogy tegye meg.

Érvénytelen aláírás

  • Ellenőrizze, hogy a Titkos kulcs megegyezik-e az Állapot mezőben beállított környezettel (teszt vagy éles), és a Terminál mezőben megadott terminállal.

  • Ellenőrizze, hogy a hitelesítő adatok elején vagy végén nincs-e szóköz.

  • Győződjön meg arról, hogy az értesítések elérik az adatbázisát: annak az alap-URL-jén nyilvánosan elérhetőnek kell lennie, és nem lehet olyan tűzfal vagy proxy mögött, amely blokkolja a Redsys felől érkező kéréseket.

A hiányzó vagy érvénytelen aláírású értesítéseket a rendszer figyelmen kívül hagyja, és a tranzakció nem frissül.

A Redsys elutasítja a fizetési oldalt

  • A kereskedőkódnak meg kell egyeznie a környezettel, és a terminálnak léteznie kell a virtuális POS-én (A kereskedő nincs regisztrálva az FUC-ban).

  • Az Ismétlődő rendelésszám azt jelenti, hogy a Redsys már ismeri a rendelésszámot. A rendelésszámok véletlenszerűen jönnek létre; próbálja újra a fizetést.

  • A Redsys elutasíthat egy olyan pénznemet, amelyet a bankja nem engedélyezett a terminálján. Ha az eurótól eltérő pénznemet használ, kérdezze meg a bankját.

Pénznem- és összeghibák

  • A(z) … pénznemnek nincs ISO 4217 numerikus kódja: a pénznemet a Redsys nem támogatja. Használjon másik pénznemet, például az eurót.

  • A kapott összeg … nem egyezik a tranzakció összegével vagy A kapott pénznem … nem egyezik: a tranzakció hibás állapotba kerül, mert a Redsys által visszaadott adatok eltérnek a kéréstől. Bármi másra való áttérés előtt ellenőrizze a fizetést a Redsys adminisztrációs portálon.

Az ügyfél fizetett, de a tranzakció nincs megerősítve

A tranzakciót a szerverek közötti értesítés frissíti. Ha ez hiányzik, ellenőrizze a Redsys adminisztrációs portálon a tranzakció Redsys-rendelésszám mezőjében tárolt rendelésszámot, a szervernaplókban pedig az értesítést. A rendelésszámot a naplók akkor jelzik, ha nem található megfelelő tranzakció.

Egy tranzakció hibás állapotba kerül

Az ok a tranzakción és a kapcsolódó dokumentum csevegőjében (chatter) látható. Tartalmazza a Redsys válaszkódját, például Nincs elegendő fedezet. (Redsys-kód: 0116).

Lásd még