Get merchant config
curl --request GET \
--url https://uat-secure.float.co.za/api/config \
--header 'Authorization: Bearer <token>'import requests
url = "https://uat-secure.float.co.za/api/config"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://uat-secure.float.co.za/api/config', 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://uat-secure.float.co.za/api/config",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://uat-secure.float.co.za/api/config"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://uat-secure.float.co.za/api/config")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://uat-secure.float.co.za/api/config")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data.id": {},
"data.attributes.name": "<string>",
"data.attributes.rules": [
{
"from_amount": 123,
"to_amount": 123,
"terms": [
123
]
}
]
}Merchant Config
Get merchant config
GET /api/config β your merchant profile and available instalment terms.
GET
/
api
/
config
Get merchant config
curl --request GET \
--url https://uat-secure.float.co.za/api/config \
--header 'Authorization: Bearer <token>'import requests
url = "https://uat-secure.float.co.za/api/config"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://uat-secure.float.co.za/api/config', 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://uat-secure.float.co.za/api/config",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://uat-secure.float.co.za/api/config"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://uat-secure.float.co.za/api/config")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://uat-secure.float.co.za/api/config")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data.id": {},
"data.attributes.name": "<string>",
"data.attributes.rules": [
{
"from_amount": 123,
"to_amount": 123,
"terms": [
123
]
}
]
}Returns the merchant linked to your Bearer token, including the rules that define which amounts Float will accept and which instalment terms are offered per amount band.
No parameters.
Rate limited to 5 requests per hour. Fetch at boot or on a schedule and cache β donβt call this per checkout.
Request
curl https://uat-secure.float.co.za/api/config \
-H "Authorization: Bearer $FLOAT_CLIENT_SECRET"
Response
200
{
"data": {
"id": "12345678-1111-1111-1111-1234567890ab",
"type": "merchants",
"attributes": {
"name": "South Park Cows Merch",
"rules": [
{
"from_amount": 10000,
"to_amount": 100000000,
"terms": [1, 2, 3, 4, 5, 6]
}
]
}
}
}
Your merchant identifier on the Float platform.
Your merchant display name, as shown to shoppers on the payment page.
Amount bands and their available instalment terms.
Errors
| HTTP | When |
|---|---|
401 | Missing or invalid Bearer token |
429 | More than 5 requests in an hour |
βI