Skip to main content
These endpoints and flows are deprecated. They keep working until their sunset date, after which they’re removed; migrate off them before then (see each entry’s replacement). How deprecations are announced and retired is described in the deprecation policy. Customer onboarding’s default is a single hosted flow: create the customer’s personal organization, then launch them into /idv, which runs identity verification and agreement signing in one step. See KYC WebSDK. Everything below was deprecated as a result.
A programmatic path exists again, on new endpoints under /ramp/customer/{customer_id}/verification. It is not a revival of the endpoints below: the shapes and semantics differ: real multipart uploads, an explicit submission order, 202 responses. See KYC API, or KYC Sumsub Shared Token if your customers are already verified with you. The endpoints below remain deprecated on their stated dates.

​
Presigned onboarding URL

POST /ramp/onboarding-url The presigned “hosted UI” onboarding link is replaced by the /idv launch. Create the customer’s org, then launch them into /idv.

​
Presigned bank-account registration

POST /ramp/onboarding/bank-accounts Registering a bank account using the presigned URL for auth is replaced by registering it with your API key.

​
Programmatic KYC submission

POST /ramp/customer/{customer_id}/kyc Submitting a customer’s identity fields over the API is replaced by the customer entering them inside the /idv launch.

​
KYC document upload

POST /ramp/customer/{customer_id}/kyc/documents Uploading ID and selfie images over the API is replaced by document capture inside the /idv launch.

​
/agreements launch

scope: agreements · target: /agreements Launching the customer into a separate agreements-signing step is replaced by signing inside /idv.
  • Status: Deprecated. Sunset: August 16, 2026.
  • Replacement: agreement signing happens automatically inside the /idv launch.

​
Direct agreement-signing endpoints

POST /ramp/agreements/electronic-signature · POST /ramp/agreements/terms-and-conditions · POST /ramp/agreements/customer-agreement
  • Status: Removed.
  • Replacement: agreements are signed inside the /idv launch.

​
Inline bankAccount on POST /ramp/organization

POST /ramp/organization no longer creates a bank account inline, and the response no longer includes bankAccount. Bank accounts can only be registered once the owning organization is approved.
Not deprecated: GET /ramp/customer/{customer_id}/kyc (KYC status) and the kyc_updated webhook are unchanged; keep using them to track KYC state.