Odbieranie informacji o płatnościach

W celu pobrania informacji o wykonanych płatnościach należy wykonać zapytanie na adres:

Ścieżka

GET /pay/v1/payments/search?fromDate=1595513742

Przykładowe zapytanie

curl --location --request GET 'https://pay.billtech.pl/pay/v1/payments/search?fromDate=1595513742' \
--header 'Content-Type: application/json'
--header 'Authorization: Basic YXBpVG9rZW46YXBpU2VjcmV0Cg==' \

Parametr fromDate określa czas podany w formacie unix timestamp. Zwrócona zostanie lista wykonanych płatności wykonana od tego czasu.

Przykładowa odpowiedź

[
    {
        "userId": "user-1234",
        "paidAt": "2020-01-01T00:00:00",
        "amount": 123.45,
        "title": "FV 123/2020",
        "referenceNumber": "20200723-123456",
        "token": "d2333193e3d075140cbe01613e282d76e04004a127395d16201c7129d4a134f9fb7c81b544d3bc9624c6baf3c9c10273b678580ac8e1e7f7e6bbfa998f205f69"
    },
    ...
]

Dostawca powinien cyklicznie, np. co 2 minuty wykonywać zapytanie o listę wykonanych płatności odpowiednio zmieniając wartość parametru fromDate przy każdym zapytaniu.

Księgowanie wpłat

Po odebraniu informacji o wykonanej płatności, dostawca może niezwłocznie zwiększyć saldo klienta oraz ew. zdjąć blokadę usług. Można powiązać wykonaną płatność z danym linkiem wykorzystując pole token. Wpłacone przez klienta pieniądze pojawią się na rachunku bankowym Dostawcy w ciągu 1-3 dni roboczych.

Jeżeli dostawca korzysta z automatycznego systemu księgowania wpłat np. poprzez import wyciągu bankowego, należy zwrócić uwagę na możliwość podwójnego zaksięgowania tej samej wpłaty. W systemie importu wyciągu bankowego konieczna jest zmiana, która wyfiltruje płatności wykonane przez BillTech (te zostały zaksięgowane tuż po wykonaniu płatności). Jest to możliwe dzięki stałemu formatowi tytułu przelewu:

ref <referenceNumber> ID <userId> <title>

Przykład

ref 20200723-123456 ID user-1234 FV 123/2020

Dzięki temu system dostawcy może odróżnić przelewy wykonane przez Bill Gateway od pozostałych oraz ew. dopasować je do konkretnych faktur.

info

Płatność za koszyk, czyli płatność z kilka zobowiązań naraz, skutkuje nadaniem jednakowego referenceNumber dla wszystkich rachunków biorących udział w tym procesie płatności. W takim przypadku system automatycznego księgowania wpłat powinien działać w oparciu o referenceNumber oraz operationId (identyfikator zobowiązania w systemie klienta wysyłany do BT-API w momencie tworzenia linku płatności).