Resolve integration errors

While integrating Fiat API, you may encounter specific technical issues. This guide helps you identify and resolve them.

Possible error types

Fiat API can return several possible errorType values:

Type	Description
currency	Specified currency pair is not supported by the provider.
invalidOffer	On-Ramp provider returned an invalid offer.
outOfLimits	Specified payin amount is less than the minimum or more than the maximum value for the fiat currency.
paymentMethod	Specified payment method is not supported by the provider.
timeout	Request to the provider was not completed in the allotted time.
unavailable	Request failed at the provider's end.
unsupportedCountry	Specified country is not supported by the provider.
state	Offer requested for the United States, but the state parameter is not provided.

Also, you may get 200 Success and error object.

Error object example

{
  "providerCode": "banxa",
  "errorType": "outOfLimits",
  "errorMessage": "Limits error",
  "errorDetails": [
    {
      "cause": "min",
      "value": "20"
    }
  ]
}

Possible error solution

Review the symptoms and possible solutions in the following table.

Symptom	Possible solution
200 Success with empty response	For request /v1/offers, check errorMessage and fix the problem. If the issue persists, current provider may not have this offer. Try using another provider.
400 Validation Error	For request /v1/offers - if your country is US, ensure that you send the country code (format ISO 3166-1) and the state code (format ISO 3166-2) correctly. You can use an example. For request /v1/offers, if you get "errorType": "state" in the response, try using another provider.
401 Unauthorized Error	Ensure that the X-Api-Signature value is valid. It must include the variables for the URL and body message of the API method you want to request. Check the Manual of sending a request, paragraphs 7 and 8.
429 Too Many Requests	The RPS/RPM limit has been exceeded. Try again in 10 minutes.
Issues with opening address	Ensure you use an iFrame instead of a redirect.