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

ParameterData typeDescription
TimestampStringGMT 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_IDStringID of given top-up point
Serial_NoStringSerial number of the one-time code
HashStringSee article ‘Security’ for a description of a method that calculates this value.

 

Response:

ParameterData typeDescription
Serial_NoStringThe serial number of the one-time code from the query
StatusStringPossible statuses: “READY”, “LOCKED”, “INVALID”, “USED”
AmountStringThe value od given one-time code. Format: 10.00
CurrencyStringThree-letter currency code consistent with norm ISO 4217 Currency Codes (for example PLN)
Unique_Response_IDStringUnique serial number of response
ERR_CodeStringError code (the parameter is blank in the event of success)
ERR_DescriptionStringDescription of the error code (the parameter is blank in the event of success)
HashStringSee 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?