- Użytkownik Billon płaci za doładowanie na dowolną kwotę
- Aplikacja PC wysyła do API Billon zapytanie o kod jednorazowy (zapytanie pinondemand)
- API Billon zwraca kod jednorazowy albo kod błędu
- Aplikacja PC drukuje potwierdzenie wpłaty z kodem jednorazowym i przekazuje je użytkownikowi Billon
- Użytkownik Billon samodzielnie doładowuje aplikację kodem jednorazowym.
Zapytanie HTTP należy wysłać metodą POST na adres https://billon.io/moneykey/pinondemand
Zapytanie pinondemand – zapytanie o kod jednorazowy
| Parametr | Typ danych | Opis |
| Timestamp | String | Czas zapytania w strefie GMT w formacie YYYYMMDDhhmmss – na przykład 20171031104530. W przypadku gdy dany Timestamp został już wykorzystany, API zwróci błąd 13. |
| Sale_Point_ID | String | ID danego punktu usługowego |
| Cashier_Login | String | Login danego kasjera |
| Amount | String | Kwota transakcji zakupu kodu jednorazowego w złotych. Format: dwa miejsca dziesiętne po kropce. Przykład: 25.00 |
| Currency | String | Trzyliterowy kod waluty zgodny z normą ISO 4217 Currency Codes (na przykład PLN) |
| Hash | String | Opis metody obliczania tej wartości znajduje się w zakładce ‚Bezpieczeństwo’ |
Odpowiedź: kod jednorazowy
| Parametr | Typ danych | Opis |
| Code | String | Kod jednorazowy służący do doładowania. W przypadku błędu parametr jest pusty. |
| Serial_No | String | Numer seryjny kodu jednorazowego |
| Amount | String | Kwota transakcji zakupu kodu jednorazowego (w złotych). Format: 10.00 |
| Expiry_Date | String | Czas wygaśnięcia ważności kodu jednorazowego |
| Unique_Response_ID | String | Unikalny numer seryjny odpowiedzi |
| ERR_Code | String | Kod błędu (parameter jest pusty w przypadku sukcesu) |
| ERR_Description | String | Opis kodu błędu (parameter jest pusty w przypadku sukcesu) |
| Hash | String | Opis metody weryfikacji poprawności tej wartości znajduje się w dziale ‚Bezpieczeństwo’ |