Ligue o clube no seu app em 3 passos

curl -X POST https://clube-api.usecoins.tech/v1/sessions \
  -H "Authorization: Bearer $CLUBE_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": { "id": "8812", "audience": "PASSENGER", "name": "Paula Souza" },
    "startPath": "/app/cupons"
  }'

const r = await fetch('https://clube-api.usecoins.tech/v1/sessions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${process.env.CLUBE_SECRET_KEY}`,
  },
  body: JSON.stringify({
    user: { id: '8812', audience: 'PASSENGER', name: 'Paula Souza' },
    startPath: '/app/cupons',
  }),
});
const body = await r.json();
if (!r.ok) throw new Error(`${body.code}: ${body.error}`);

console.log(body.launchUrl); // entregue este link ao app

<?php
$ch = curl_init('https://clube-api.usecoins.tech/v1/sessions');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . getenv('CLUBE_SECRET_KEY'),
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'user'      => ['id' => '8812', 'audience' => 'PASSENGER', 'name' => 'Paula Souza'],
        'startPath' => '/app/cupons',
    ]),
]);
$body   = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status < 200 || $status >= 300) {
    throw new Exception($body['code'] . ': ' . $body['error']);
}
echo $body['launchUrl']; // entregue este link ao app

import os
import requests

r = requests.post(
    "https://clube-api.usecoins.tech/v1/sessions",
    headers={"Authorization": f"Bearer {os.environ['CLUBE_SECRET_KEY']}"},
    json={
        "user": {"id": "8812", "audience": "PASSENGER", "name": "Paula Souza"},
        "startPath": "/app/cupons",
    },
    timeout=10,
)
body = r.json()
if not r.ok:
    raise RuntimeError(f"{body['code']}: {body['error']}")

print(body["launchUrl"])  # entregue este link ao app

val config = ClubeCoinsConfig.Builder()
    .launchProvider { startPath, callback ->
        // Chame o SEU servidor (Retrofit, OkHttp, Ktor…), que chama POST /v1/sessions e devolve o launchUrl.
        meuServidor.linkDoClube(usuarioId, startPath,
            onOk = { url -> callback.onSuccess(url) },
            onErro = { e -> callback.onError(e) })
    }
    .startPath("/app/cupons")          // opcional
    .statusBarColor(0xFF1A1446.toInt()) // opcional: cor do seu app
    .listener { event -> Log.d("Clube", event.toString()) }
    .build()

ClubeCoins.open(this, config)

ClubeCoins.open(activity, new ClubeCoinsConfig.Builder()
    .launchProvider((startPath, callback) -> meuServidor.linkDoClube(startPath, callback))
    .build());

curl -X POST https://clube-api.usecoins.tech/v1/events \
  -H "Authorization: Bearer $CLUBE_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "ride.completed",
    "id": "OS-10293",
    "user": { "id": "8812", "audience": "PASSENGER" },
    "amountCents": 2550,
    "distanceMeters": 7300,
    "occurredAt": "2026-11-07T11:58:00-03:00",
    "data": { "cidade": "BH" }
  }'

const r = await fetch('https://clube-api.usecoins.tech/v1/events', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${process.env.CLUBE_SECRET_KEY}`,
  },
  body: JSON.stringify({
    type: 'ride.completed',
    id: 'OS-10293', // o mesmo id nunca credita duas vezes
    user: { id: '8812', audience: 'PASSENGER' },
    amountCents: 2550,
    distanceMeters: 7300,
    occurredAt: '2026-11-07T11:58:00-03:00',
    data: { cidade: 'BH' },
  }),
});
const body = await r.json();
if (!r.ok) throw new Error(`${body.code}: ${body.error}`);

console.log(body.status, body.coins); // ex.: CREDITED 25

<?php
$ch = curl_init('https://clube-api.usecoins.tech/v1/events');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . getenv('CLUBE_SECRET_KEY'),
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'type'           => 'ride.completed',
        'id'             => 'OS-10293', // o mesmo id nunca credita duas vezes
        'user'           => ['id' => '8812', 'audience' => 'PASSENGER'],
        'amountCents'    => 2550,
        'distanceMeters' => 7300,
        'occurredAt'     => '2026-11-07T11:58:00-03:00',
        'data'           => ['cidade' => 'BH'],
    ]),
]);
$body   = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status < 200 || $status >= 300) {
    throw new Exception($body['code'] . ': ' . $body['error']);
}
echo $body['status'] . ' ' . $body['coins']; // ex.: CREDITED 25

import os
import requests

r = requests.post(
    "https://clube-api.usecoins.tech/v1/events",
    headers={"Authorization": f"Bearer {os.environ['CLUBE_SECRET_KEY']}"},
    json={
        "type": "ride.completed",
        "id": "OS-10293",  # o mesmo id nunca credita duas vezes
        "user": {"id": "8812", "audience": "PASSENGER"},
        "amountCents": 2550,
        "distanceMeters": 7300,
        "occurredAt": "2026-11-07T11:58:00-03:00",
        "data": {"cidade": "BH"},
    },
    timeout=10,
)
body = r.json()
if not r.ok:
    raise RuntimeError(f"{body['code']}: {body['error']}")

print(body["status"], body["coins"])  # ex.: CREDITED 25