Introduction
SettleRamp is a compliance-first API that lets fintech partners bridge fiat and digital assets. Our infrastructure handles KYC, multi-currency settlement, and regulatory requirements across LATAM.
How SettleRamp Works
The typical integration follows four steps. Each step maps to a set of API endpoints and webhook events.
Authenticate
Obtain an API key and include it in every request as a Bearer token.
Onboard customers (KYC)
Submit customer identity data. SettleRamp runs compliance checks and returns a status.
Create orders
Initiate Deposit or Withdraw orders once the customer is approved.
Receive webhooks
Listen for async lifecycle events such as order completion, KYC status changes, and more.
Core Principles
Security First: All requests must be made over HTTPS. Authentication is required for every request.
Async by default: Lifecycle events are delivered via webhooks. Polling endpoints are available as a fallback.
Idempotency-friendly: Use partner reference IDs to safely retry requests without creating duplicate resources.
Predictable errors: Error responses use standard HTTP status codes and return a structured error body with actionable feedback.
Environments
SettleRamp provides two isolated environments. Use Sandbox for development and testing, and Production for live traffic.
Ask the team for the corresponding urls according to your integration needs.