1. Home
  2. Web services
  3. One-time codes
  4. codeStatus

codeStatus

  1. PC applications sends query about checking status of the one-time code to Billon API (query codeStatus)
  2. Billon API returns status of the one-time code

 

HTTP request must be sent by POST method to https://billon.io/moneykey/checkCode

 

Query codeStatus – query about status of the one-time code

Parameter Data type Description
Timestamp String GMT time of query in YYYYMMDDhhmmss fomat – for exmaple 20171031104530. API returns error 13 in the event that given Timestamp has been already used.
Sale_Point_ID String ID of given top-up point
Serial_No String Serial number of the one-time code
Hash String See article ‘Security’ for a description of a method that calculates this value.

 

Response:

Parameter Data type Description
Serial_No String The serial number of the one-time code from the query
Status String Possible statuses: “READY”, “LOCKED”, “INVALID”, “USED”
Amount String The value od given one-time code. Format: 10.00
Currency String Three-letter currency code consistent with norm ISO 4217 Currency Codes (for example PLN)
Unique_Response_ID String Unique serial number of response
ERR_Code String Error code (the parameter is blank in the event of success)
ERR_Description String Description of the error code (the parameter is blank in the event of success)
Hash String See article ‘Security’ for a description of a method that verifies correctness of this value
Was this article helpful to you? Yes No

How can we help?