curl --request POST \
  --url https://hpay-api.host-sl.com/api/v1/transactions/wallet/complete-onboarding/ \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY' \
  --header 'X-Forwarded-For: 41.223.10.5' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_id": "9a8b7c6d-...",
    "individual": { "first_name": "Alice", "last_name": "Kamara", "address": { "country": "SL" } },
    "business_profile": { "mcc": "5734" }
  }'

from hostpay import HostPay

client = HostPay(api_key="YOUR_API_KEY", secret_key="YOUR_SECRET_KEY")

result = client.connect.complete_onboarding(
    wallet_id="9a8b7c6d-...",
    individual={"first_name": "Alice", "last_name": "Kamara", "address": {"country": "SL"}},
    business_profile={"mcc": "5734"},
    client_ip=request.client.host,  # the END CUSTOMER's IP, not your server's
)
print(result["payouts_enabled"], result["currently_due"])

import { HostPay } from "@hostpay/sdk";

const client = new HostPay({ apiKey: "YOUR_API_KEY", secretKey: "YOUR_SECRET_KEY" });

const result = await client.connect.completeOnboarding({
  walletId: "9a8b7c6d-...",
  individual: { first_name: "Alice", last_name: "Kamara", address: { country: "SL" } },
  businessProfile: { mcc: "5734" },
  clientIp: req.ip, // the END CUSTOMER's IP, not your server's
});
console.log(result.payouts_enabled, result.currently_due);

{
  "message": "Onboarding data submitted. Account verified and payouts enabled.",
  "account_id": "acct_1ABC...",
  "payouts_enabled": true,
  "external_account_added": false,
  "currently_due": [],
  "pending_verification": [],
  "disabled_reason": null
}

{
  "message": "Onboarding data submitted. Further verification needed. Requirements due: ['individual.verification.document'].",
  "account_id": "acct_1ABC...",
  "payouts_enabled": false,
  "external_account_added": false,
  "currently_due": ["individual.verification.document"],
  "pending_verification": [],
  "disabled_reason": null
}

{
  "detail": "Could not determine client IP address for TOS acceptance. 'X-Forwarded-For' header is missing."
}