Skip to main content

Off-Ramp use case

Phase 1: Integration & Debugging (Test Environment)​

At this phase, set up a test environment for debugging.

  1. Process — contact the manager to get the Sandbox API Keys.

Phase 2: User Off-Ramp Selling Flow (Runtime)​

This is the main flow, which occurs first in a test environment with the Sandbox API keys, and then in production.

  1. API — get the list of available countries with the /v1/available-countries method and sell value in supportedFlow away.
  2. GUI — display available countries in your interface.
  3. API — get the list of currently available fiat currencies and cryptocurrencies with the /v1/currencies method and sell value in supportedFlow away.
  4. GUI — ask the user for the currency pair to exchange: crypto as a payin currency and fiat as a payout. For example, it can be ETH (Ethereum) to EUR.
  5. GUI — ask the user for the amount to sell.
  6. API — call the /v1/sell/offers method to get selling offers from providers with an estimated EUR amount after selling.
  7. API — call the /v1/providers method to get info about Off-Ramp providers.
  8. GUI — show the offers with an estimated amount to the user and display info about providers who made the offers.
  9. GUI — ask the user to specify the wallet refund address in case of a failed transaction.
  10. API — call the /v1/validate-address method to validate the user's refund address for a given currency.
  11. GUI — ask the user to choose the offer.
  12. GUI — ask the user to accept KYC/AML Policy and confirm the selling.
  13. API — call POST /v1/sell/orders to create a selling order. For the order made with Sandbox API keys, the method returns a redirect URL to the Changelly selling page. Otherwise, returns a redirect URL to the provider's selling page.
  14. API — (for debugging of test orders only) call POST /v1/sandbox/order/id to change the order status and other properties.
  15. API — (for debugging of test orders only) call POST /v1/sandbox/order/id/resend-callback to check callback sending.
  16. GUI — redirect the user to the selling page.
  17. API — call GET /v1/orders to get the full list of orders.
  18. API — get status updates in real-time via /Webhooks.

Phase 3: Go-Live (Production Environment)​

After successful debugging of the test Off-Ramp selling flow from Phase 2, set up a production environment.

  1. System — replace the Sandbox Keys with the Production ones.