API reference / Payments

get/v2/providers

Payment providers available for a corridor

Operation
listProviders
Authentication
API key

Which payment methods are viable for a payer in a given country, in a given currency, at a given amount. Card acquiring is close to nonexistent in Ethiopia and Somalia, so this is a corridor question rather than a global list.

Request

Parameters

countryqueryrequiredstring
currencyqueryrequiredstring
amount_centsqueryintegernull
product_codequerystring

Responses

200Providers, best fit first.
providersProvider[]required
400The request body or query failed validation.
errorobjectrequired
401No key, an unknown key, a revoked key, or a key whose tenant is not active. All four return an identical body on purpose: distinguishing them would let a caller discover which partners we have.
errorobjectrequired

Example

curl
curl -X GET https://api.haavisa.com/v2/providers \
  -H "Authorization: Bearer $HAAVISA_API_KEY"?country=<country>&currency=<currency>

More in Payments

Something unclear? The eligibility guide explains the model behind the answers; the errors guide covers the envelope.