Skip to main content
POST
Create Terms Acceptance Link

Authorizations

Authorization
string
header
required

Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.

Path Parameters

customerId
string<uuid>
required

Unique identifier for the customer.

Body

application/json
redirectUrl
string
required

Where the hosted page sends the customer after they accept. Must start with one of the prefixes configured for your account; without an allowlist, any https://, worldapp:// or worldappstg:// URL.

Maximum string length: 500
Example:

"https://partner.example.com/terms/done"

Response

Link issued.

url
string<uri>
required

Single-use link to the Ripio-hosted acceptance page. Open it in a webview as is; do not store it or alter it.

Example:

"https://b2b-widget-onramp.ripio.com/#_at=4f1c2b7e-6a1d-4c39-9a8e-2b5d0f7c3e11.Q2xhdWRlIGV4YW1wbGUgc2VjcmV0"

expiresAt
string<date-time>
required

When the link stops working (30 minutes after it was issued).

Example:

"2026-11-24T15:30:00Z"