Când realizați un număr de apeluri eGenius PlatformAPI (de exemplu, Pay, Authorize, Refund, Capture, Save, Check 3DS Enrollment Initiate Authentication, Authenticate Payer), trebuie furnizate detaliile cardului. Aceste detalii ale cardului pot fi specificate utilizând mai multe „surse”.
Dacă un detaliu al cardului, cum ar fi numărul acestuia, este furnizat de mai multe ori într-o singură solicitare deoarece apare în două sau mai multe surse, regulile de precedență vor stabili care sursă este utilizată. Ordinea precedenței este următoarea:
Mai exact, datele din câmpurile solicitării API vor avea prioritate în raport cu datele stocate în sesiune, care vor avea prioritate în raport cu detaliile stocate în simbol.
De exemplu, dacă includeți atât un identificator de sesiune (care conține numărul de card, data expirării și codul CSC) și un simbol de card (care conține numărul de card și data expirării) într-o solicitare Pay atunci, pe baza ordinii de precedență, detaliile cardului specificate în identificatorul de sesiune vor fi utilizate în cadrul tranzacției financiare.
Referință API Sursă de fonduri[REST][NVP]
Puteți specifica detaliile de plată utilizând una dintre aceste surse sau o combinație a acestora.
Doriți să trimiteți o operațiune Pay utilizând numărul de card și data expirării stocate într-un simbol de card și codul CSC colectat într-o sesiune. Următorul exemplu de solicitare vă prezintă modul în care puteți să furnizați ca surse atât simbolul de card, cât și sesiunea în cadrul solicitării Pay:
Metoda HTTP | PUT |
URL | https://egenius.unicredit.ro/api/rest/version/72/merchant/<merchant>/order/<orderId>/transaction/<transactionId> |
JSON |
{ "apiOperation": "PAY", "session": { "id": "SESSION000177777777777777777777" }, "sourceOfFunds": { "token": "9999999999999999" }, "order": { "amount": "34.00", "currency": "AUD" } } |
Mesajul JSON anterior presupune:
Doriți să actualizați data expirării într-un simbol stocat utilizând operațiunea Tokenization (dar lăsați numărul de card nemodificat). Simbolul furnizat în adresa URL de solicitare identifică simbolul pe care doriți să-l actualizați. Furnizarea aceluiași simbol ca sursă pentru detaliile de plată va determina reutilizarea detaliilor stocate anterior. Acest lucru înseamnă că nu mai este necesar să reintroduceți numărul de card. Prin furnizarea unei noi date de expirare în secțiunea Detalii card a solicitării, valoarea va suprascrie data de expirare deja existentă în simbol (consultați secțiunea Reguli de precedență).
Următorul exemplu de solicitare vă prezintă modul în care sunt furnizate ca surse detaliile de plată și simbolurile în operațiunea Tokenization:
Metoda HTTP | PUT |
URL | https://egenius.unicredit.ro/api/rest/version/72/merchant/<merchant>/token/9999999999999999 |
JSON |
{ "sourceOfFunds": { "provided": { "card": { "expiry": { "month": "05", "year": "13" }, "number": "5123456789012346" } }, "type": "CARD" } } |
Mesajul JSON anterior presupune:
Rezultatul acestei operațiuni va fi acela că simbolul „9999999999999999” are acum data expirării 05/13 (numărul de card rămâne neschimbat).