Return Codes

api return codes klavi payment apis use standard http error codes to communicate errors back to you in particular, our apis use standard http status 416 to express business processing errors here's a table of the possible error codes that you may encounter while using our apis https //docs klavipay ai/docs/dev guides/integration api/code#common return code code description notes 200, 201 successful request the request was successful 400, 422 bad request the request was malformed or missing required parameters 401 unauthorized the access token provided was invalid or has expired 403 forbidden the access token provided does not have sufficient permissions 404 not found the requested resource could not be found 409 conflict the request conflicts with an existing resource this error is usually related to idempotency key 416 business processing error some kind of business processing error occurred in the request the filed "statuscode" in the response payload specifically represents a kind of business process error please refer to the response instructions for each api 429 too many requests the api rate limit has been exceeded use exponential backoff for requests the transactions per second (tps) rate is adjusted based on the specific needs of each customer 500, 502, 503, 504 server errors something went wrong on our end if you receive this error, please contact our support team and provide the necessary information for us to investigate the issue business status codes code description notes 4101 qrcode not related pix the scanned qrcode is not related to pix 4102 qrcode from pixcobrança the scanned qrcode is from "pix cobrança" 4103 qrcode from pixtroco the scanned qrcode is from "pix troco" 4104 qrcode from pixsaque the scanned qrcode is from "pix saque" 4105 payment has been created payment links has been created(only for whitelabel) 4106 payment initiation is canceled payment initiation is canceled(only for whitelabel) 4107 consent has been created consent has been created(only for whitelabel) 4109 payment fidooptions unknown error payment fidooptions unknown error 4110 payment final state payment fidooptions unknown error