Create Terms Acceptance Link
curl --request POST \
--url https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"redirectUrl": "https://partner.example.com/terms/done"
}
'import requests
url = "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/"
payload = { "redirectUrl": "https://partner.example.com/terms/done" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({redirectUrl: 'https://partner.example.com/terms/done'})
};
fetch('https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'redirectUrl' => 'https://partner.example.com/terms/done'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/"
payload := strings.NewReader("{\n \"redirectUrl\": \"https://partner.example.com/terms/done\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"redirectUrl\": \"https://partner.example.com/terms/done\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"redirectUrl\": \"https://partner.example.com/terms/done\"\n}"
response = http.request(request)
puts response.read_body{
"url": "https://b2b-widget-onramp.ripio.com/#_at=4f1c2b7e-6a1d-4c39-9a8e-2b5d0f7c3e11.Q2xhdWRlIGV4YW1wbGUgc2VjcmV0",
"expiresAt": "2026-11-24T15:30:00Z"
}Terms and Conditions
Create Terms Acceptance Link
Issues a single-use link to a Ripio-hosted page where the customer reads and accepts the active Terms and Conditions. Use it when your integration does not show the terms itself: open url in a webview, and when the customer has accepted, the page sends them to redirectUrl.
- The link is valid for 30 minutes (
expiresAt) and can be used once. - Requesting a new link for the same customer invalidates the previous one, even if it has not expired.
- Request it right before opening it. Do not store it or send it by push notification or email.
redirectUrlmust match your account’s allowlist of prefixes, configured with Ripio. Without an allowlist, anyhttps://,worldapp://orworldappstg://URL is accepted.- A link is issued even when the customer has already accepted the active version.
Arriving at redirectUrl does not prove the customer accepted: confirm with Get Terms Acceptance Status. See Terms and Conditions.
POST
/
api
/
v1
/
customers
/
{customerId}
/
termsLink
/
Create Terms Acceptance Link
curl --request POST \
--url https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"redirectUrl": "https://partner.example.com/terms/done"
}
'import requests
url = "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/"
payload = { "redirectUrl": "https://partner.example.com/terms/done" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({redirectUrl: 'https://partner.example.com/terms/done'})
};
fetch('https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'redirectUrl' => 'https://partner.example.com/terms/done'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/"
payload := strings.NewReader("{\n \"redirectUrl\": \"https://partner.example.com/terms/done\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"redirectUrl\": \"https://partner.example.com/terms/done\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/termsLink/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"redirectUrl\": \"https://partner.example.com/terms/done\"\n}"
response = http.request(request)
puts response.read_body{
"url": "https://b2b-widget-onramp.ripio.com/#_at=4f1c2b7e-6a1d-4c39-9a8e-2b5d0f7c3e11.Q2xhdWRlIGV4YW1wbGUgc2VjcmV0",
"expiresAt": "2026-11-24T15:30:00Z"
}Authorizations
Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.
Body
application/json
Response
Link issued.
Was this page helpful?