​

Migrating from the Service Provider API to the Network Partner API

​

What changed at a glance

1. Everything is category-scoped. Each discovery call now takes a category — for the retail ramp that is CRYPTO_ONRAMP (buy) or CRYPTO_OFFRAMP (sell). The legacy endpoints were direction-agnostic; the new ones return results for one direction at a time.
2. One currencies endpoint. The separate fiat-currencies and crypto-currencies endpoints merged into a single supported/currencies call, switched by type=FIAT|CRYPTO.
3. Limits moved into routes. There is no standalone limits endpoint. Per-(partner, payment-method) min/max now live on supported/routes, alongside the partners and rails that serve a currency pair — so limits are now direction-aware.
4. Response shapes changed. Several fields were renamed and a few were added or dropped (see each section below).
5. Routes are ordered by direction. The source/destination path segments follow the flow direction, not “fiat then crypto” (see Routes).

​

Endpoint mapping

​

1. Countries

GET /service-providers/properties/countries?accountFilter=true

GET /network-partner/supported/countries?category=CRYPTO_ONRAMP

{
  "countries": [
    {
      "countryCode": "US",
      "countryName": "United States",
      "states": ["US-NY", "US-CA", "US-TX"]
    },
    { "countryCode": "GB", "countryName": "United Kingdom" }
  ]
}

{
  "countries": [
    { "countryCode": "US", "name": "United States", "flag": "🇺🇸" },
    { "countryCode": "DE", "name": "Germany", "flag": "🇩🇪" }
  ]
}

• Now requires category (CRYPTO_ONRAMP or CRYPTO_OFFRAMP). The supported set can differ by direction, so call it once per direction you offer.
• countryName → name, and a flag emoji is now included.
• states[] is no longer returned here. Collect the US state in your own UI and pass it as the subdivision query param on Routes.

​

2. Country defaults

GET /service-providers/properties/defaults/by-country?countries=BR

GET /network-partner/defaults/BR/CRYPTO_ONRAMP

[
  {
    "countryCode": "BR",
    "defaultCurrencyCode": "BRL",
    "defaultPaymentMethods": ["PIX", "CREDIT_DEBIT_CARD", "BINANCE_CASH_BALANCE"]
  }
]

{
  "countryCode": "BR",
  "category": "CRYPTO_ONRAMP",
  "currencyCode": "BRL",
  "paymentMethods": ["PIX", "CREDIT_DEBIT_CARD", "BINANCE_CASH_BALANCE"]
}

• Country and category are now path params (/defaults/{country}/{category}), not a countries= query list.
• The response is a single object (or null), no longer an array — drop the countryDefaults[0] indexing.
• defaultCurrencyCode → currencyCode, defaultPaymentMethods → paymentMethods.

​

3. Currencies

GET /service-providers/properties/fiat-currencies?countries=US&accountFilter=true

GET /service-providers/properties/crypto-currencies?countries=US&accountFilter=true

GET /network-partner/supported/currencies?category=CRYPTO_ONRAMP&country=US&type=FIAT

GET /network-partner/supported/currencies?category=CRYPTO_ONRAMP&country=US&type=CRYPTO&network=ETHEREUM

{
  "cryptoCurrencies": [
    {
      "currencyCode": "ETH_ETHEREUM",
      "currencyName": "Ethereum",
      "networkCode": "ETHEREUM",
      "networkName": "Ethereum"
    }
  ]
}

{
  "currencies": [
    {
      "currencyCode": "USDC",
      "name": "USD Coin",
      "decimalPlaces": 6,
      "type": "CRYPTO",
      "symbol": "USDC",
      "chainCode": "ETHEREUM",
      "contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
    }
  ]
}

• One endpoint for both sides — pass type=FIAT or type=CRYPTO. category and country are required.
• The legacy crypto list was returned under a cryptoCurrencies wrapper; both fiat and crypto now return a single currencies wrapper.
• currencyName → name; networkCode → chainCode; networkName is dropped.
• New fields: decimalPlaces (use it for client-side formatting), symbol, and contract (token contract address) to disambiguate tokens on the same chain.
• Optional filters: network (e.g. ETHEREUM, SOLANA), partner, paymentType, providerCurrencyCode.

​

4. Payment methods

GET /service-providers/properties/payment-methods?fiatCurrencies=USD&accountFilter=true

GET /network-partner/supported/payment-methods?category=CRYPTO_ONRAMP&country=US&currencyCode=USD

[
  {
    "countryCode": "US",
    "providerMethod": "card",
    "method": "CREDIT_DEBIT_CARD",
    "name": "Credit / Debit Card",
    "type": "CARD",
    "headlessSupported": false
  },
  {
    "countryCode": "US",
    "providerMethod": "apple_pay",
    "method": "APPLE_PAY",
    "name": "Apple Pay",
    "type": "MOBILE_WALLET"
  }
]

• Now requires all three of category, country, and currencyCode (the fiat code — pay-with for buy, payout for sell). The legacy call keyed only off fiatCurrencies.
• Returns a bare array (not an object wrapper).

​

5. Limits and routes

GET /service-providers/limits/fiat-currency-purchases?accountFilter=true

GET /network-partner/supported/routes/CRYPTO_ONRAMP/US/USD/USDC

GET /network-partner/supported/routes/CRYPTO_OFFRAMP/US/USDC/USD

{
  "limits": {
    "USD": {
      "minAmount": 20,
      "maxAmount": 20000,
      "dailyLimit": 5000,
      "monthlyLimit": 20000
    }
  }
}

[
  {
    "partner": "TRANSAK",
    "source": "USD",
    "destination": "USDC",
    "paymentMethods": [
      {
        "paymentType": "CARD",
        "name": "CREDIT_DEBIT_CARD",
        "partnerMethodName": "credit_debit_card",
        "limits": { "currencyCode": "USD", "min": 30, "max": 20000 },
        "headlessSupported": false
      }
    ],
    "kycLimits": []
  }
]

• Limits are read from route.paymentMethods[].limits for the chosen partner + method, not from a global map keyed by currency.
• minAmount → min, maxAmount → max; the limits.currencyCode tells you which currency the bounds are expressed in (on-ramp: the fiat paid; off-ramp: the fiat received).
• Limits are now direction-aware — a buy route and a sell route for the same pair can have different min/max.
• Path order follows direction:
  • On-ramp: .../CRYPTO_ONRAMP/{country}/{fiat}/{crypto} (source = fiat).
  • Off-ramp: .../CRYPTO_OFFRAMP/{country}/{crypto}/{fiat} (source = crypto).
• Optional query params: partners, paymentMethod, paymentType, and subdivision (the US state that legacy countries.states[] used to carry).

​

Migration checklist

​

What stays the same

• POST /payments/crypto/quote, POST /crypto/session/widget, and GET /payments/transactions/{transactionId} are unchanged.
• Authorization: BASIC {apiKey} auth and the sandbox/production base URLs are unchanged.
• The overall flow — discover → quote → create session → launch the provider widget → track the transaction — is unchanged.

​

Next steps