Bibliotecă EuPlătesc pentru Node.js

Bibliotecă EuPlătesc pentru Node.js

acum un an ·
•••
 · 5 min de citit

Nu de puține ori mi-a fost dat să integrez API-ul de la serviciul de plăți online EuPlătesc în proiectele pe care le-am întreprins. De obicei, în rândul proiectelor pentru clienții din România, EuPlătesc a fost printre primele servicii pe care le-am recomandat clienților atunci când le-am propus astfel de soluții. Și așa am tot cochetat cu API-ul lor, până când am creat această bibliotecă pentru Node.js pentru a-mi ușura mie munca, în primul rând, și apoi pentru a oferi înapoi un plus valoare, sper eu, comunității de programatori din România.

Intro

Pentru cei ce nu știu, documentația și API-ul în sine de la EuPlătesc nu respectă vreun standard. Fără a fi rău, atât documentația cât și API-ul în sine, din păcate, par să fi fost scrise de un elev de liceu care și-a dat atestatul la informatică. Dar să trecem peste asta, tot răul spre bine, acum există biblioteca euplatesc pentru Node.js publicată pe npmjs.com și pe Github Packages 🎉.

Astfel, „după lupte seculare, care au durat aproape...”, am reușit să implementez în bibliotecă API-ul EuPlătesc în întregime și este și documentată pe măsură. Bineînțeles sunt așteptate cu drag și câteva teste și eventual raportări de probleme din partea celor care o folosesc.

Generare legătură de inițiere de plată recurentă

Hai să încercăm și un exemplu de utilizare, mai exact voi folosi biblioteca pentru a genera o legătură de plată recurentă.

1. Inițiere proiect

Voi începe prin a crea un director nou pentru proiectul meu:

$ cd ~/www
$ mkdir euplatesc-recurrent-payment
$ cd euplatesc-recurrent-payment

Inițiez proiectul și instalez pachetul euplatesc:

$ npm init -y
$ npm install euplatesc

sau dacă folosești yarn:

$ yarn init -y
$ yarn add euplatesc

2. Instanțiere EuPlătesc

Și voi crea fișierul index.js unde voi instanția un obiect EuPlătesc:

index.js
const { EuPlatesc } = require('euplatesc');
 
const epClient = new EuPlatesc({
  merchantId: '123456',
  secretKey: '987654',
  testMode: true
});

După cum se observă, am setat instanța mea în modul test. Asta înseamnă că nu am neapărat nevoie de merchantId și secretKey reale, ne vom juca mai departe cu datele de test (care vor fi setate automat de bibliotecă 🙌🏼), iar pentru a genera doar o legătură de plată nu avem nevoie de un cont real.

3. Definire parametri metodă paymentUrl

Mai departe voi defini o constantă de parametri pe care o voi transmite mai departe metodei de generare legătură de plată:

index.js
const date = new Date();
const nextYear = new Date(date.setFullYear(date.getFullYear() + 1));
 
const data = {
  amount: 1,
  currency: 'RON',
  invoiceId: '00016',
  // dacă folosești diacritice în orderDescription, vei avea surprize 🎁
  orderDescription: 'Campanie de donatii pentru BookTruck',
  frequency: {
    days: 30,
    expiresAt: nextYear
  }
};

De notat faptul că această plată va fi una recurentă, automată la 30 de zile până în anul viitor când va expira, așa cum am setat în liniile 9-12.

🎁 Glumesc, dar algoritmii de calculare a semnăturii nu se înțeleg cu diacriticele 🤷🏻‍♂️ și vei vedea în locul paginii de plată un mesaj de genul:

Incorrect signature.
Redirecting...
Array ( [Ammount] => 1.00 [Currency] => RON [InvoiceID] => 00016 [OrderDesc] => Campanie de donații pentru BookTruck [MerchantID] => testaccount [TranTimeStamp] => 20221006200725 [Nonce] => 6987594dfe4e62e6217b46f4e7eaa02e [RECUR_FREQ] => 30 [RECUR_EXP] => 20231006 )
B332D594566571A72EE06B7DC3A04528

4. Apelare metodă paymentUrl

În final apelez metoda paymentUrl într-un bloc try-catch* și voi obține legătura de plată către platforma euplatesc.ro (vezi comentariul de la linia 4):

index.js
try {
  const { paymentUrl } = ep.paymentUrl(data);
  console.log(paymentUrl);
  // https://secure.euplatesc.ro/tdsprocess/tranzactd.php?amount=1.00&curr=RON&invoice_id=00016&order_desc=Campanie+de+donatii+pentru+BookTruck&merch_id=testaccount&timestamp=20221006200159&nonce=0da1459243140a81821c9749c1f960f9&recurent_freq=30&recurent_exp=20231006&fp_hash=6375E870C7760ACB7B7DD06A7DD1FFED&recurent=Base
} catch (e) {
  console.error(e);
}

Astfel am generat o legătură care va conduce utilizatorul pe pagina de plată euplatesc.ro unde va continua plata cu cardul.

* Este posibil ca dacă te joci cu parametri să primești anumite excepții sau în pagina de plată să apară un mesaj de eroare. Îți recomand să urmărești cu atenție documentația bibliotecii sau dacă vrei să te încumeți, chiar și pe cea oferită de EuPlătesc din panoul lor de control.

Tot codul

Cuprins în 28 de linii:

index.js
const { EuPlatesc } = require('euplatesc');
 
const ep = new EuPlatesc({
  merchantId: '123456',
  secretKey: '987654',
  testMode: true
});
 
const date = new Date();
const nextYear = new Date(date.setFullYear(date.getFullYear() + 1));
 
const data = {
  amount: 1,
  currency: 'RON',
  invoiceId: '00016',
  orderDescription: 'Campanie de donatii pentru BookTruck',
  frequency: {
    days: 30,
    expiresAt: nextYear
  }
};
 
try {
  const { paymentUrl } = ep.paymentUrl(data);
  console.log(paymentUrl);
} catch (e) {
  console.error(e);
}

Concluzii

Prin dezvoltarea acestei biblioteci mi-am ușurat munca și tare sper că nu doar mie și de-acum în colo voi evita, în proiectele viitoare, toată nebunia de calcule de semnături, verificări de hash-uri, câmpuri care trebuie să vină neapărat după alte câmpuri într-un obiect, etc. Cunoscătorii știu despre ce vorbesc.

Am luat în vizor și alte servicii care nu au dezvoltate biblioteci pentru Node.js și pe care mi-ar plăcea să le dezvolt. Aici intră LibraPay, Oblio, poate serviciile de curierat.

Partajează pe: