​
Ramp API Integration

A comprehensive RESTful API that allows for deep integration of Ripio’s financial services directly into a partner’s existing infrastructure. Key Features & Purpose:
  • Direct Control: Partners can build custom user experiences by directly calling API endpoints for various functionalities.
  • Services Offered:
    • On-Ramp & Off-Ramp: Facilitate the conversion between fiat and cryptocurrencies.
    • Customer Management: Create and manage end-user accounts.
    • KYC Processes: Integrate Know Your Customer verification flows.
    • Quotes: Obtain real-time and held price quotes for conversions.
    • Fiat Accounts: Manage fiat accounts for withdrawals.
    • Transaction Management: Track and list on-ramp and off-ramp orders.
    • Network Information: Retrieve details about supported deposit and withdrawal networks.
    • Rates: Get current market rates.
  • Authentication: Utilizes OAuth2 Client Credentials flow for M2M authentication. Partners obtain a Client ID and Client Secret from Ripio to generate access tokens.
This method is ideal for partners who require a high degree of customization and want to maintain their brand’s look and feel throughout the user journey.

​
Widget Integration

The Ripio On/Off Ramp Widget is a pre-built, embeddable user interface that simplifies the integration of on-ramp and off-ramp services. It’s designed to be easily dropped into any partner platform that can host a web view. Key Features & Purpose:
  • Simplified Integration: Reduces development effort by providing a ready-to-use UI for on-ramp and off-ramp flows.
  • On-Ramp Flow:
    • Allows users to acquire cryptocurrencies using FIAT money.
    • Requires users to have a crypto wallet and undergo a KYC (Know Your Client) process.
    • Supported payment methods (Argentina): Mercado Pago and Bank Transfer.
  • Off-Ramp Flow:
    • Allows users to convert cryptocurrencies into FIAT money.
    • Requires users to have a bank account and undergo a KYC process.
    • Supported deposit method (Argentina): Bank Transfer.
  • Environment: Developed to function in any modern web browser.
  • Integration Steps:
    1. Generate Authentication Token: Partners request an access JWT token by providing their client_id, client_secret, and a unique external_ref (UUID v4 representing the partner’s user).
    2. Widget Access: Redirect the user to the widget URL, passing the generated authentication token as a query parameter.
  • Customization:
    • Theme: The widget’s UI can be customized via a CSS file provided by the partner to match their brand style.
    • Parameters: Query parameters can be used to prefill certain fields like wallet address (_addr), network (_net), amount (_amount), cryptocurrency (_crypto), and a custom tracking session ID (_tracking_session).
This method is suitable for partners looking for a quick and easy way to offer on-ramp/off-ramp services without extensive development.

​
Distinctions

FeatureRamp API IntegrationWidget Integration
Integration TypeDirect API calls, backend-to-backend primarilyEmbeddable UI, frontend integration
User ExperienceFully customizable by the partnerPre-built UI, themeable via CSS
Development EffortHigher, requires building UI and handling API logicLower, primarily involves token generation and URL redirection
ControlGranular control over each step of the processStreamlined flow managed by the widget
Use CasePlatforms needing deep, custom financial service integrationsPlatforms wanting a quick, easy way to add on/off-ramp functionality
AuthenticationOAuth2 Client Credentials for API accessJWT token generated via API for widget session authentication
Both solutions are designed to empower partners to offer robust cryptocurrency transaction services, catering to different integration needs and technical capabilities.