Úvod

Aby ste mohli používať a testovať platobnú bránu, potrebujete Client ID a Client secret z TB developer portálu. Pre získanie týchto údajov sa musíte registrovať v TB developer portáli. Viac info na Developer portál dokumentácia.

Inštalácia

Pre používanie API klienta je potrebné nainštalovať balík tatrapayplus-node.

npm i @tatrabanka/tatrapayplus-node

Overenie inštalácie

Pre overenie správnej inštalácie môžete využiť nasledujúcu minimálnu konfiguráciu.

Ak ste tak ešte nevykonali, vytvorte si účet a aplikáciu v TB developer portáli.

Skopírujte nasledujúci kód do nového súboru test_tb.mjs. Zameňte API_KEY, API_SECRET a REDIRECT_URI údajmi z vášho účtu.

import { TBPlusSDK } from "@tatrabanka/tatrapayplus-node";

const API_KEY = "REPLACE FROM TB PORTAL";
const API_SECRET = "REPLACE FROM TB PORTAL";
const REDIRECT_URI = "REPLACE FROM TB PORTAL";
const sdk = new TBPlusSDK(API_KEY, API_SECRET, "192.0.2.123");
const { data } = await sdk.createPayment(
  {
    bankTransfer: {},
    basePayment: {
      endToEnd: "/VS0123456789/SS0123456789/KS123456",
      instructedAmount: {
        amountValue: 10,
        currency: "EUR",
      },
    },
  },
  REDIRECT_URI,
);
console.log(JSON.stringify(data));

Spustite príkaz: node test_tb.mjs

Ak sa príkaz vykonal úspešne, uvidíte odpoveď z API v JSON formáte:

{
    "paymentId": "fcdab2d3-f471-4434-8834-df3cebdab03d",
    "tatraPayPlusUrl": "https://api.tatrabanka.sk/tatrapayplus/sandbox/v1/auth?paymentId=xxxx&client_id=xxxx&hmac=xxxx",
    "availablePaymentMethods": [
        {
            "isAvailable": true,
            "paymentMethod": "CARD_PAY"
        },
        {
            "isAvailable": true,
            "paymentMethod": "PAY_LATER"
        },
        {
            "isAvailable": true,
            "paymentMethod": "BANK_TRANSFER"
        },
        {
            "isAvailable": true,
            "paymentMethod": "QR_PAY"
        }
    ]
}

Môžete skopírovať tatraPayPlusUrl do vášho prehliadača a mali by ste sa dostať na platobnú bránu Tatrapay+. 🎉